# Airport & City Search API

> Airport & City Search API on Apizie: 2 endpoints (Returns a list of airports and cities matching a given keyword., Returns a specific airports or cities based on its id.) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/open-data:amadeus-amadeus-airport-city-search/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:amadeus-amadeus-airport-city-search`
- Category: Open Data
- Status: byok
- Source: https://amadeus.com
- Page: https://zieapi.vercel.app/api/open-data/amadeus-amadeus-airport-city-search
- OpenAPI: https://zieapi.vercel.app/api/open-data/amadeus-amadeus-airport-city-search/openapi.json

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…

## Endpoints

### Returns a list of airports and cities matching a given keyword.
`GET https://zieapi.vercel.app/v1/open-data:amadeus-amadeus-airport-city-search/get-airport-city-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| subType | array | yes | sub type of the location (AIRPORT and/or CITY) |
| keyword | string | yes | keyword that should represent the start of a word in a city or airport name or code. Supported charaters are: A-Za-z0-9./:-'()" |
| countryCode | string | no | Country code of the location using [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code format (e.g. US). |
| page[limit] | integer | no | maximum items in one page |
| page[offset] | integer | no | start index of the requested page |
| sort | string | no | defines on which attribute the sorting will be done: * analytics.travelers.score - sort by the number of travelers by airport or city, the… |
| view | string | no | select the level of information of the reply: * LIGHT - Gives only the IATACode, name, detailedName, cityName and countryName * FULL -… |

### Returns a specific airports or cities based on its id.
`GET https://zieapi.vercel.app/v1/open-data:amadeus-amadeus-airport-city-search/get-airport-city` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| locationId | string | yes | identifier of the location |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:amadeus-amadeus-airport-city-search/get-airport-city-search" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Airport & City Search API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:amadeus-amadeus-airport-city-search/get-airport-city-search with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Airport & City Search API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Airport & City Search itself also needs your own key from amadeus.com.

### Can AI agents use the Airport & City Search API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:amadeus-amadeus-airport-city-search.

### What is the status of the Airport & City Search API?
Needs your own provider key (bring your own key)