Airport & City Search
amadeus · Company
Before using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token. Please also be aware that our test environment is based on a subset of the production, in test this API only contains data from the United States, Spain, United Kingdom, Germany and India.
Authentication
No authentication requiredFree to use with no key needed.
Sample Requests
GET
Returns a list of airports and cities matching a given keyword.
Returns a list of airports and cities matching a given keyword.
https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations?sort=analytics.travelers.score&view=FULL&keyword=test&subType=example&countryCode=example&page[limit]=10&page[offset]=0
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations?sort=analytics.travelers.score&view=FULL&keyword=test&subType=example&countryCode=example&page[limit]=10&page[offset]=0"
import requests
params = {
"sort": "analytics.travelers.score",
"view": "FULL",
"keyword": "test",
"subType": "example",
"countryCode": "example",
"page[limit]": "10",
"page[offset]": "0"
}
response = requests.get(
"https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations');
url.searchParams.set('sort', 'analytics.travelers.score');
url.searchParams.set('view', 'FULL');
url.searchParams.set('keyword', 'test');
url.searchParams.set('subType', 'example');
url.searchParams.set('countryCode', 'example');
url.searchParams.set('page[limit]', '10');
url.searchParams.set('page[offset]', '0');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations")
q := baseURL.Query()
q.Set("sort", "analytics.travelers.score")
q.Set("view", "FULL")
q.Set("keyword", "test")
q.Set("subType", "example")
q.Set("countryCode", "example")
q.Set("page[limit]", "10")
q.Set("page[offset]", "0")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations")
uri.query = URI.encode_www_form({
"sort" => "analytics.travelers.score",
"view" => "FULL",
"keyword" => "test",
"subType" => "example",
"countryCode" => "example",
"page[limit]" => "10",
"page[offset]" => "0"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations?" . http_build_query([
"sort" => "analytics.travelers.score",
"view" => "FULL",
"keyword" => "test",
"subType" => "example",
"countryCode" => "example",
"page[limit]" => "10",
"page[offset]" => "0"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));
GET
Returns a specific airports or cities based on its id.
Returns a specific airports or cities based on its id.
https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations/{locationId}
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations/{locationId}"import requests
response = requests.get(
"https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations/{locationId}",
)
print(response.json())const url = 'https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations/{locationId}';
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
targetURL := "https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations/{locationId}"
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations/{locationId}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/amadeus.com/amadeus-airport-&-city-search/1.2.3/reference-data/locations/{locationId}";
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Airport & City Search?
Airport & City Search is a Company API. Developers commonly use company APIs for:
- enriching CRM records with company firmographics
- building lead-generation and prospecting tools
- verifying business identity and registration details
- monitoring competitors and market intelligence
- powering B2B data enrichment pipelines
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Airport & City Search is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?