1. Home
  2. Docs
  3. Airports
  4. Free API Endpoints
  5. Airport Search

Airport Search

This endpoint allows you to execute an airport search using a free-text string.

It can have multiple purposes, like powering an airport lookup function for an airline booking tool, or a private jet booking widget.

Endpoint

https://api.aviowiki.com/free/airports/search

Request Example

curl --request GET \
  --url 'https://api.aviowiki.com/free/airports/search?query=Los%20Angeles'

Test it now

Request Parameters

Parameters names followed by an asterisk (*) are mandatory.

NameTypeLocationDescription
query *stringQuery StringThe text to search in the database.
pagenumberQuery StringThe page number for pagination
sizenumberQuery StringThe size of the pages for pagination

Response

The response will be a Paged List of results. Each result object contains a limited set of information that we consider to be essential to identify a location.

For this endpoint the properties available in the response are:

PropertyTypeDescription
aidstringA string with the AID of the airport, with APT as namespace
icaostring, nullA string with the 4-letters ICAO code of the airport, ornull if none is assigned
iatastring, nullA string with the 3-letters IATA code of the airport, or null if none is assigned.
faastring, nullA string with the FAA code, or null if none is assigned.
coordinatesobject, nullA Coordinates object which represents the location of the Aerodrome Reference Point.
This is null when the information is not known.
countryobject, nullA Country object which represents the country at which an airport is located.
null if this is not known.
timeZonestring, nullThe timezone of the airfield as noted in the IANA Time Zone Database.
null indicates that this information is not available.
namestring, nullThe name of the airport. This should be the official name of the airport written in Latin characters.
servedCitystring, nullA string containing the name of the city served by the airport. In some countries, like the USA, this includes the state. For example: Los Angeles, CA.
This is null when the information is not known.

Example reply

Below is an example of a reply with two results:

{
  "page": {
    "number": 0,
    "size": 10,
    "totalPages": 6,
    "totalResults": 58
  },
  "content": [
    {
      "aid": "APT-5U1Y-P4WX",
      "icao": "KLAX",
      "iata": "LAX",
      "faa": "LAX",
      "name": "Los Angeles Intl",
      "coordinates": {
        "latitude": 33.9424944,
        "longitude": -118.40805
      },
      "servedCity": "Los Angeles, CA",
      "country": {
        "iso3": "USA",
        "iso2": "US",
        "isoNumeric": 840,
        "name": "United States of America",
        "continent": "Americas"
      },
      "timeZone": "America/Los_Angeles"
    },
    {
      "aid": "APT-PNJM-F3LQ",
      "icao": "KWHP",
      "iata": "WHP",
      "faa": "WHP",
      "name": "Whiteman",
      "coordinates": {
        "latitude": 34.2593253,
        "longitude": -118.4134331
      },
      "servedCity": "Los Angeles, CA",
      "country": {
        "iso3": "USA",
        "iso2": "US",
        "isoNumeric": 840,
        "name": "United States of America",
        "continent": "Americas"
      },
      "timeZone": "America/Los_Angeles"
    }
  ]
}
Was this article helpful to you? Yes No

How can we help?