Autocomplete API for countries, cities and airports

In this article describe how to work with Travelpayouts autocomplete API.

To autocomplete cities or airports in your search, use a GET request of the following form:

http://autocomplete.travelpayouts.com/places2?term=Mos&locale=en&types[]=country&callback=function

  • term — Text for searching (the main parameter)
  • locale — The output language (the list of supported languages at the end of the article)
  • types[] — An array that specifies the type of autocomplete search (city, airport, country)
  • callback — A parameter for backward compatibility of clients running on jsonp

Example of response

[
{
"code": MOW,
"main_airport_name": null,
"country_cases": null,
"index_strings":[
maskava,
moscow
],
"weight": 1006321,
"cases": {
"da": "Москве",
"tv": "Москвой",
"vi": "в Москву",
"pr": "Москве",
"ro": "Москвы"
},
"country_name": "Россия",
"type": city,
"country_code": RU,
"coordinates": {
"lon": 37.617633,
"lat": 55.755786
},
"name": "Москва",
"state_code": null
}
]

Response parameters

  • code — IATA city/airport code
  • main_airport_name — Airport name (if available)
  • country_cases — Service parameter
  • index_strings — Variants of queries in different languages ​​and in different layouts
  • weight — Service parameter
  • cases — The name of the city in various cases (only for ru locale);
    country_name — name of the country
  • type — Type of object (city / airport / country)
  • country_code — IATA country code
  • coordinates — An object’s coordinates
  • name — The name of the city / airport
  • state_code — State code (if available)

Supported languages

  • ar — Arabic
  • bg — Bulgarian
  • cs — Czech
  • da — Danish
  • de — German
  • el — Greek
  • en — English
  • es — Spanish
  • fa — Persian
  • fi — Finnish
  • fr — French
  • he — Israeli
  • hi — Indian
  • hr — Croatian
  • hu — Hungarian
  • id — Indonesian
  • it — Italian
  • ja — Japanese
  • ka — Georgian
  • ko — Korean
  • lt — Italian
  • lv — Latvia
  • ms — Malaysian
  • nl — Dutch
  • no — Norwegian
  • pl — Polish
  • pt — Portuguese
  • ro — Romanian
  • ru — Russian
  • sk — Slovak
  • sl — Slovenian
  • sr — Serbian
  • sv — Swedish
  • th — Thai
  • tl — Filipino
  • tr — Turkish
  • uk — Ukrainian
  • vi — Vietnamese
  • zh-Hans — Chinese traditional
  • zh-Hant — Chinese simplified

Was this article helpful?

Have more questions? Submit a request