API for mobile apps

With the mobile API, affiliates can build the Jetradar search into their own apps. The main API features:

List of popular routes

A list of popular airports you can integrate into your app. Allows optimizing selection screens with takeoff/landing airports determined by the user-entered string.

Query

Method: GET.

URL: http://nano.aviasales.ru/places/top_ru.json

You can use top_en.json, top_de.json for other languages.

Query header

Accept-Encoding: gzip, deflate, bzip2, compress

This header is necessary if you want to get data in compressed form.

Response

JSON array of objects in the following form:

{
    "iata":"LED",
    "name":"Санкт-Петербург, Россия",
    "coordinates":[
	59.939039,
	30.315785
],
    "index_strings":[
	"россия",
	"russia",
	"sankt petersburg"
],
    "airport_name":"Пулково",
"searches_count":7305318 }
  • iata – IATA city code.
  • name – City and country name.
  • index_strings – List of strings by which an airport can be found (country, city).
  • coordinates – Latitude and longitude.
  • airport_name – Airport name (can be null if referring to all airports in the city).

To check whether updating the file is necessary, use the Last-Modified header in the response.

Search for cities/airports by string

Get a list of cities/airports that match the user-entered string.

Query

Method: GET.

URL: http://nano.aviasales.ru/places_ru?term={term}

where {term} is the search string.

You can use places_en.json, places_de.json for other languages.

Note: {term} must contain three or more characters.

Example: http://nano.aviasales.ru/places_en?term=BCN

Response

JSON array of objects in the following form:

[{
   "name":"Москва, Россия",
   "index_strings":[
      "มอสโก",
      "mosca",
      "москва",
      "defaultcity",
      "moscou",
      "moscow",
      "moscú",
      "moskau",
      "понаехавск",
      "莫斯科",
      "нерезиновск",
      "moskwa",
      "нерезиновая"
   ],
   "iata":"MOW",
   "airport_name":null,
   "coordinates":[
      55.755786,
      37.617633
   ],
   "searches_count":7305318,
   "location":{
      "lat":55.755786,
      "lon":37.617633
   },
   "country_iata":"RU"
}]
  • iata – IATA city code.
  • name – City and country name
  • index_strings – List of strings by which an airport can be found (country, city)
  • coordinates – Latitude and longitude
  • airport_name – Airport name (can be null if referring to all airports in the city)

To check whether updating the file is necessary, use the Last-Modified header in the response.

Nearest airports to coordinates

List of airports located close to the indicated geographical coordinates. Used on the screen for selecting the departure airport to identify the airports closest to the user's current position.

Query

Method: GET.

URL: http://nano.aviasales.ru/places/coords_to_places_ru.json?coords={lat},{lng}

where{lat}, {lng} are float values separated by a period (.).

You can use coords_to_places_en.json, coords_to_places_de.json for other languages.

Example: http://nano.aviasales.ru/places/coords_to_places_ru.json?coords=39.000,50.000

Response

JSON array of objects in the following form:

{
   "iata":"LED",
   "name":"Санкт-Петербург, Россия",
   "coordinates":[
      59.939039,
      30.315785
   ],
   "index_strings":[
      "россия",
      "russia",
      "sankt petersburg"
   ],
   "airport_name":"Пулково",
   "searches_count":83177 }
  • iata – IATA city code.
  • name – City and country name
  • index_strings – List of strings by which an airport can be found (country, city)
  • coordinates – Latitude and longitude
  • airport_name – Airport name (can be null if referring to all airports in the city)

Airline logos

Get airline logos as a PNG file of the necessary size.

Query

Method: GET.

URL: http://ios.aviasales.ru/logos/density/IATA.png

where Density - size of logo (the parentheses contain the corresponding maximum image sizes in pixels); the sizes do not need to be specified in queries and can be:

  • nonretina (66x22).
  • mdpi (88x29).
  • hdpi (132x44).
  • xhdpi (176x59).
  • xxhdpi (264x87).

and IATA - the airline's IATA code.

For example: http://ios.aviasales.ru/logos/nonretina/AB.png

Logos for iPhone retina displays are in the hdpi folder.

Note: Not all airlines have a logo.

Logos of airlines are available at: http://pics.avs.io/width/height/iata.png

where, width - the width of the logo, height - the height of the logo, iata - the IATA code of the airline. 

Example: https://pics.avs.io/340/100/AB.png.

Price calendar

Get the lowest prices for flights on the indicated departure dates for the departure/destination cities.

Query

Method: GET.

URL: http://min-prices.aviasales.ru/calendar_preload

Query parameters

  • origin – IATA code for the point of departure. The IATA code is shown in uppercase letters, for example, MOW.
  • destination – IATA code for the destination. The IATA code is shown in uppercase letters, for example, MOW.
  • depart_date – Departure date in the format YYYY-MM-DD.
  • one_way – Search for one-way tickets (true or false).

Example: http://min-prices.aviasales.ru/calendar_preload?origin=BCN&destination=MOW&depart_date=2014-12-01&one_way=false

Response

  • best_prices – Contains an array of the lowest prices for various departure days.
  • current_depart_date_prices – Contains an array of the lowest prices that match the specified departure date.

Both arrays contain parameters for the found price in the following format:

{
"best_prices":[{
    "show_to_affiliates":false,
    "trip_class":0,
    "origin":"MOW",
    "destination":"LED",
    "depart_date":"2015-05-17",
    "return_date":"2015-05-21",
    "number_of_changes":0,
    "value":4022,
    "found_at":"2015-05-04T11:49:34+04:00",
    "distance":634,
    "actual":true
}]}
  • value – Price in rubles.
  • depart_date – Departure date, in YYYY-MM-DD format, that corresponds to the price.
  • return_date – Return date, in YYYY-MM-DD format, that corresponds to the price.
  • number_of_changes – Number of stops in the flight with the lowest price.

Price Map: supported routes

Query

Method: GET.

URL: http://map.aviasales.ru/supported_directions.json?origin_iata=LED&one_way=false&locale=en

Query parameters

  • origin_iata – IATA code of the airport/city for which tickets are searched. The IATA code is shown in uppercase letters, for example, MOW.
  • one_way – “true” for one-way tickets, “false” for round trips.
  • locale – Search language.

Response

{
   "origin":{
      "iata":"LED",
      "name":"St Petersburg",
      "country":"RU",
      "coordinates":[
         30.315785,
         59.939039
      ]    },    "directions":[{       "direct":false,       "iata":"USM",       "name":"Koh Samui",       "country":"TH",       "coordinates":[          100.0628,          9.555315       ]    } }

Response parameters

  • iata – IATA code of the departure city.
  • name – Name of the departure city.
  • country – Country letter code.
  • coordinates – Coordinates of departure city.
  • directions – Route information.
    • direct – Whether non-stop flights are available.
    • name – Name of destination city.
    • country – Destination country.
    • coordinates – Coordinates.

Price Map: prices

Query

Method: GET.

URL: http://map.aviasales.ru/prices.json?origin_iata=LED&period=2014-12-01:season&direct=true&one_way=false&price=50000&no_visa=true&schengen=true&need_visa=true&locale=ru&min_trip_duration_in_days=13&max_trip_duration_in_days=15

Query parameters

  • origin_iata – IATA code for the point of departure. The IATA code is shown in uppercase letters, for example, MOW.
  • period – Period of dates for which to search.
  • direct – Whether non-stop flights are available.
  • one_way – “true” for one-way tickets, “false” for round trips.
  • price – Highest ticket price.
  • no_visa – Payment not made with a Visa card.
  • schengen – Can the ticket be changed.
  • need_visa – Visa required (or not).
  • locale – Search language.
  • min_trip_duration_in_days – Shortest trip duration (in days).
  • max_trip_duration_in_days – Longest trip duration (in days).

Response

[{
    "show_to_affiliates":false,
    "trip_class":0,
    "destination":"PSA",
    "depart_date":"2014-05-30",
    "return_date":"2014-06-12",
    "number_of_changes":0,
    "value":43785,
    "created_at": 1407716354,
    "ttl": 1407889154,
    "distance":2247,
    "actual":false
},
{
    "show_to_affiliates":false,
    "trip_class":0,
    "destination":"PRG",
    "depart_date":"2014-03-01",
    "return_date":"2014-03-15",
    "number_of_changes":0,
    "value":12060,
    "created_at": 1407716354,
    "ttl": 1407889154,
    "distance":1485,
    "actual":true
}]

Response parameters

  • show_to_affiliates – true: prices available to affiliates, false: price not available to affiliates.
  • trip_class – Trip class (1 – business class, 0 – standard).
  • destination – IATA code for the destination.
  • depart_date – Departure date.
  • return_date – Return date.
  • number_of_changes – Number of stops.
  • value – Flight cost.
  • created_at – Time and date of query creating (in unix timestamp format).
  • ttl (time-to-live) – Time and date at which the offer is living (in unix timestamp format).
  • distance – Distance between the departure and arrival points.
  • actual – Equals 0 or 1. 0 – price was found long ago and may be out of date. 1 – price was found recently and is current.

Convert the price

To convert the price from rubles to other currencies, use the query:

http://yasen.aviasales.ru/adaptors/currency.json

You will receive the closest value of all popular currencies to the ruble at the moment.

{
    "cny":8.24394,
    "eur":57.1578,
    "mzn":1.49643,
    "nio":1.97342,
    "usd":51.1388,
    "hrk":7.48953
}
 

Was this article helpful?

Have more questions? Submit a request