Flight data by Aviasales

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.

Please note that some cities don't have coordinates. For them, the values lon and lat are zero.

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.com 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. 

Please note that some airlines create subsidiaries with a new name, but the same IATA code. In the file, these airlines contain different IATA codes. For example, AnadoluJet has a 0T code to separate Turkish and Anadolu, as they actually use the parent airline's IATA code – TK.

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 (not updated)

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

Please note that the data in the file is not updated or supplemented.

Example response

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

Response parameters

  • code — plane IATA code
  • name — plane name

Data on the routes in JSON format (not updated)

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

Please note that the data in the file is not updated or supplemented.

Example response

[{
   "airline_iata":"2B",
   "airline_icao":null,
   "departure_airport_iata":"LON",
   "departure_airport_icao":null,
   "arrival_airport_iata":"BCN",
   "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