Price Map API

Note! The methods provided in the article will be deprecated starting May 30, 2022. We recommend that you replace them with the alternative options in advance.

Use GraphQL query prices_one_way (documentation) instead of /supported_directions.json. Example:

{
  prices_one_way(
    params: {
      origin: "LON"
    }
    grouping: DIRECTIONS
    paging: {
      offset: 0
      limit: 30
    }
  ) {
    destination_city_iata
  }
}

Please note that our GQL responses do not contain country and coordinates fields, but you can get this data using cities.json (documentation). The maximum value of limit in the query is 30, use offset to collect all the data.

Use /aviasales/v3/grouped_prices (documentation) instead of /prices.json. To get the distance values, use GraphQL-query with distance field added to the query. Example:

{
  prices_one_way(
    params: {
      origin: "LON"
    }
    grouping: DIRECTIONS
    paging: {
      offset: 0
      limit: 30
    }
  ) {
    destination_city_iata
    distance
  }
}

Price Map: supported routes

Query

Method: GET.

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

Query parameters

origin_iata — IATA code of the airport/city from which tickets are searched for. 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":"LON",
	"name":"London",
	"country":"GB",
	"coordinates":[
		0.06,
		51.51
		]
	},
"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 the 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.com/prices.json?origin_iata=LON&period=2022-06-01:season&direct=true&one_way=false&schengen=true&locale=en&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, LON
period — period of dates to search for (season, year, month)
direct — whether non-stop flights are available
one_way — "true" for one-way tickets, "false" for round trips
schengen — you need schengen visa
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":"2022-05-30",
   "return_date":"2022-06-12",
   "number_of_changes":0,
   "value":43785,
   "created_at": 1407716354,
   "ttl": 1407889154,
   "distance":2247,
   "actual":false
}]

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 arriving (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