Data in json format

The article contains links to JSON files with useful data for travel sites. Travelpayouts regularly updates the data in these files, you just have to embed the data from them into your project.

The article contains links to files with various information about countries, cities, airports.

Translations for different languages have been created for each file. To get a link to the required language, add the language code to the link http://api.travelpayouts.com/data/:

  • ar - Arabic
  • az - Azerbaijani
  • cs - Czech
  • da - Danish
  • de - German
  • el - Greek (modern Greek)
  • en - English (UK)
  • en-AU, en-CA, en-GB, en-IE, en-IN, en-NZ, en-SG - English for various countries
  • es - Spanish
  • fa - Persian
  • fi - Finnish (Suomi)
  • fr - French
  • he - Hebrew
  • hi - Hindi
  • hr - Croatian
  • hu - Hungarian
  • hy - Armenian
  • id - Indonesian
  • it - Italian
  • jp - Japanese
  • ka - Georgian
  • ko - Korean
  • lt - Lithuanian
  • lv - Latvian
  • ms - Malay
  • nl - Dutch (Dutch)
  • no - Norwegian [Norsk (bokmål)]
  • pl - Polish
  • pt - Portuguese
  • pt_br - Brazilian Portuguese
  • ro - Romanian
  • ru - Russian (files with Russian translation contain case declensions)
  • sk - Slovak
  • sl - Slovenian
  • sr - Serbian
  • sv - Swedish
  • th - Thai
  • tl - Tagalog (Filipino)
  • tr - Turkish
  • uk - Ukrainian
  • vi - Vietnamese
  • zh-hans - Chinese (simplified characters)
  • zh-hant - Chinese (traditional hieroglyphs)

For example: http://api.travelpayouts.com/data/en/file-name.json

Data of countries in json format

The request http://api.travelpayouts.com/data/en/countries.json returns a file with a list of countries from the database. 

Example response

[{
   "code":"NC",
   "name":"New Caledonia",
   "currency":"XPF",
   "name_translations":{
   "de":"Neukaledonien",
   "en":"New Caledonia",
   "zh-CN":"新喀里多尼亚",
   "tr":"Yeni Kaledonya",
   "ru":"Новая Каледония",
   "fr":"Nouvelle-Calédonie",
   "es":"Nueva Caledonia",
   "it":"Nuova Caledonia",
   "th":"ประเทศนิวแคลิโดเนีย"
}}
]

Response parameters

  • code — IATA-code of a country
  • name — country name
  • currency — currency country
  • name_translations  — translation of country name

City data in json format

The request http://api.travelpayouts.com/data/en/cities.json returns a file with a list of cities from the database. 

Example response

[{
   "code":"SCE",
   "name":"State College",
   "coordinates":{
      "lon":-77.84823,
      "lat":40.85372
   },
   "time_zone":"America/New_York",
   "name_translations":{
      "de":"State College",
      "en":"State College",
      "zh-CN":"大学城",
      "tr":"State College",
      "ru":"Стейт Колледж",
      "it":"State College",
      "es":"State College",
      "fr":"State College",
      "th":"สเตทคอลเลจ"
      },
   "country_code":"US"
}]

Response parameters

  • code — city IATA-code
  • name — city name
  • coordinates — city coordinates
  • time_zone — timezone relative to GMT
  • name_translations — translation of city name
  • country_code — country IATA-code

Airport data in json format

The request http://api.travelpayouts.com/data/en/airports.json returns a file with a list of airports from the database. Please note that the file may contain not only airports, but also railway / bus stations and etc (this is due to the peculiarities of the aviasales.ru airline ticket search service), to distinguish them from each other, use the iata_type field.

The file also contains the IATA codes of railway stations, bus stations and inactive airports. Pay attention to the name and flightable fields.

Example response

[{
   "code":"MQP",
   "name":"Kruger Mpumalanga International Airport",
"iata_type": "airport",
"flightable": true,
   "coordinates":{
      "lon":31.098131,
      "lat":-25.384947
   },
   "time_zone":"Africa/Johannesburg",
   "name_translations":{
      "de":"Nelspruit",
      "en":"Kruger Mpumalanga International Airport",
      "tr":"International Airport",
      "it":"Kruger Mpumalanga",
      "fr":"Kruger Mpumalanga",
      "es":"Kruger Mpumalanga",
      "th":"สนามบินเนลสปรุต"
   },
   "country_code":"ZA",
   "city_code":"NLP"
}]

Response parameters

  • code — airport IATA code
  • name — airport name
  • iata_type — item type, can take the following values:
    • airport
    • bus
    • harbour
    • heliport
    • seaplane
    • military
    • railway.
  • flightable — the airport is operational or not
  • lon — airport longitude
  • lat — airport latitude
  • time_zone – time zone relative to GMT
  • name_translations — the name of the airport in different languages
  • country_code — country IATA code
  • city_code — city IATA code

Airline data in json format

The request http://api.travelpayouts.com/data/en/airlines.json returns a file with a list of airlines from the database. 

Example response

{
    "name": "IBS Software Services Americas, Inc.",
    "code": "V1",
    "name_translations": {
        "en": "IBS Software Services Americas, Inc."
    }
}

Response parameters

  • name— airline name
  • code — airline IATA code
  • name_translations — the name of the airport in different languages

Alliance data in json format

The request http://api.travelpayouts.com/data/en/alliances.json returns a file with a list of alliances from the database. 

Example response

[{
   "name":"oneworld",
   "airlines":["4M","AA","AB","BA","CX","AY","HG","IB","JC","JL","JO","KA","LA","LP","MA","MN","MX","NU","QF","RJ","S7","XL"]
}]

Response parameters

  • name — alliance name
  • airlines — codes for alliance member companies

Airplane data in json format

The request http://api.travelpayouts.com/data/planes.json returns a file with a list of airplanes from the database. 

Example response

[{
   "code":"100",
   "name":"Fokker 100"
}]

Response parameters

  • code — plane IATA code
  • name — plane name

Data on the routes in json format

The request http://api.travelpayouts.com/data/routes.json returns a file with a list of routes from the database.

Example response

[{
   "airline_iata":"2B",
   "airline_icao":null,
   "departure_airport_iata":"AER",
   "departure_airport_icao":null,
   "arrival_airport_iata":"DME",
   "arrival_airport_icao":null,
   "codeshare":false,
   "transfers":0,
   "planes":[
      "CR2"
   ]
}]

Response parameters

  • airline_iata — IATA of an airline
  • airline_icao — ICAO of an airline
  • departure_airport_iata — IATA of an airport of departure
  • departure_airport_icao — ICAO of an airport of departure
  • arrival_airport_iata — IATA of an airport on arrival
  • arrival_airport_icao — ICAO of an airport on arrival
  • codeshare — it shows whether the flight performs the same company that sells the ticket
  • transfers — the number of direct
  • planes — IATA of airplane

Was this article helpful?

Have more questions? Submit a request