Старая версия API доступа к данным (более не поддерживается)
Уважаемые партнеры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.
Для получения токена (token
) к API доступа к данным зайдите на страницу http://www.travelpayouts.com/developers/api.
- Самые дешёвые авиабилеты
- Билеты без пересадок
- Билеты за каждый день месяца
- Популярные направления авиакомпании
- Данные о странах, городах, аэропортах, авиакомпаниях, самолетах в JSON-формате
Для доступа к API вам необходимо передавать свой токен в заголовке X-Access-Token
или параметром token
.
Даты принимаются в форматах YYYY-MM
и YYYY-MM-DD
Ответ от сервера всегда отдается в формате json
и имеет следующую структуру:
success
— принимает значения true
для успешного запроса и false
в случае ошибки
data
— результат выполнения запроса, в случае ошибки будет иметь значение null
error
— краткое описание ошибки, помешавшей выполнить запрос, в случае успешного запроса будет иметь значение null
Даты и время в UTC и отформатированы по стандарту ISO 8601. Цены указаны в рублях и актуальны на момент попадания билета в результаты поиска. Не рекомендуется использовать цены, срок актуальности которых истек (примерная дата указывается в значении параметра expires_at
).
Важно!
Настоятельно рекомендуется получать данные сжатыми в gzip — это существенно сократит время получения ответа. Чтобы получить данные в сжатом виде, необходимо передать заголовок Accept-Encoding: gzip, deflate
.
Для получения доступа к API поиска авиабилетов и отелей необходимо оставить заявку.
Самые дешёвые авиабилеты
Уважаемые партнёры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.
http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices.json?{departure_at,return_at,currency,token}
— возвращает самые дешевые билеты без пересадок, а также с 1 и 2 пересадками для выбранного направления с фильтрами по датам вылета и возвращения.
Параметры запроса
origin
— IATA-код города вылета;destination
— IATA-код города назначения (укажите «-» для любых направлений);departure_at
(необязательно) — день или месяц вылета (yyyy-mm-dd или yyyy-mm);return_at
(необязательно) — день или месяц возвращения (yyyy-mm-dd или yyyy-mm);currency
— валюта ответа (USD, EUR, RUB);token
— индивидуальный токен доступа.
Пример запроса
Обратите внимание! В запросе могут быть указаны старые даты. Тогда в результате его ошибки не будет, но и данных никаких не вернётся.
Пример ответа
{ "success": true, "data": { "BCN": { "0": { "price": 211, "airline": "U2", "flight_number": 4533, "departure_at": "2014-08-05T15:50:00Z", "return_at": "2014-08-21T15:10:00Z", "expires_at": "2014-03-02T15:59:09Z" }, "1": { "price": 228, "airline": "9B", "flight_number": 3958, "departure_at": "2014-05-23T12:50:00Z", "return_at": "2014-05-28T17:10:00Z", "expires_at": "2014-03-02T16:56:35Z" }, "2": { "price": 408, "airline": "KL", "flight_number": 3758, "departure_at": "2014-05-24T06:50:00Z", "return_at": "2014-05-28T08:50:00Z", "expires_at": "2014-03-02T12:56:35Z" } } }, "error": null,"currency":"usd" }
Описание ответа
0
,1
,2
— количество пересадок;price
— цена билета (в заданной валюте, параметр currency);airline
— IATA-код авиакомпании, выполняющей перелет;flight_number
— номер рейса;departure_at
— дата вылета;return_at
— дата возвращения;expires_at
— дата истечения актуальности найденной цены (UTC+0).
Билеты без пересадок
Уважаемые партнёры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.
http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices/direct.json?{departure_at,return_at,currency,token}
— возвращает самый дешёвый билет без пересадок для выбранного направления с фильтрами по датам вылета и возвращения.
Параметры запроса
origin
— IATA-код города вылета;destination
— IATA-код города назначения (укажите «-» для любых направлений);departure_at
(не обязательно) — день или месяц вылета (yyyy-mm-dd или yyyy-mm);return_at
(не обязательно) — день или месяц возвращения (yyyy-mm-dd или yyyy-mm);currency
— валюта ответа (USD, EUR, RUB);token
— индивидуальный токен доступа.
Пример запроса
Пример ответа
{ "success": true, "data": { "PAR": { "0": { "price": 104, "airline": "AB", "flight_number": 8154, "departure_at": "2014-10-01T06:10:00Z", "return_at": "2014-10-06T10:25:00", "expires_at": "2014-03-06T18:10:19Z" } } }, "error": null,"currency":"usd" }
Описание ответа
price
— цена билета (в заданной валюте);airline
— IATA-код авиакомпании, выполняющей перелет;flight_number
— номер рейса;departure_at
— дата вылета;return_at
— дата возвращения;expires_at
— дата истечения актуальности найденной цены (UTC+0).
Билеты за каждый день месяца
Уважаемые партнёры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.
http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices/calendar.json?{departure_at,return_at,calendar_type,length,currency,token}
— возвращает самые дешёвые билеты без пересадок, а также с 1 и 2 пересадками для выбранного направления для каждого дня выбранного месяца.
Параметры запроса
origin
— IATA-код города вылета;destination
— IATA-код города назначения;departure_at
— день или месяц вылета (yyyy-mm-dd или yyyy-mm);return_at
(необязательно) — день или месяц возвращения (yyyy-mm-dd или yyyy-mm);calendar_type
— поле, по которому будет строиться календарь. Одно из двух значений:departure_date
илиreturn_date
;length
(необязательно) — длительность пребывания в городе назначения;currency
— валюта ответа (USD, EUR, RUB);token
— индивидуальный токен доступа.
Пример запроса
Пример ответа
{ "success": true, "data": { "2013-03-01": { "origin": "MOW", "destination": "BCN", "price": 19353, "transfers": 1, "airline": "LH", "flight_number": 1447, "departure_at": "2013-03-01T17:35:00Z", "return_at": "2013-03-21T15:50:00Z", "expires_at": "2013-03-02T10:46:48Z" }, "2013-03-02": { "origin": "MOW", "destination": "BCN", "price": 16561, "transfers": 1, "airline": "TK", "flight_number": 418, "departure_at": "2013-03-02T17:40:00Z", "return_at": "2013-03-22T16:35:00Z", "expires_at": "2013-03-02T10:46:48Z" }, ... "2013-03-31": { "origin": "MOW", "destination": "BCN", "price": 14691, "transfers": 1, "airline": "AY", "flight_number": 154, "departure_at": "2013-03-31T13:50:00Z", "return_at": "2013-04-20T12:05:00Z", "expires_at": "2013-03-02T16:48:53Z" } }, "error": null,"currency":"rub" }
Описание ответа
origin
— IATA-код города вылета;destination
— IATA код города назначения;price
— цена билета в заданной валюте;transfers
— количество пересадок;airline
— IATA-код авиакомпании;flight_number
— номер рейса;departure_at
— дата вылета;return_at
— дата возвращения;expires_at
— срок истечения актуальности цены (UTC+0).
Популярные направления авиакомпании
Уважаемые партнёры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.
http://api.aviasales.ru/v1/airlines/{airline}/directions.json?{limit,token}
— возвращает направления, по которым авиакомпания осуществляет перелёты, отсортированные по популярности.
Параметры запроса
airline
— IATA-код авиакомпании;limit
(необязательно) — количество маршрутов (по умолчанию 100);token
— индивидуальный токен доступа.
Пример запроса
http://api.aviasales.ru/v1/airlines/KL/directions.json?limit=10
Пример ответа
{ "success": true, "data": { "MOW-BKK": 187491, "MOW-BCN": 113764, "MOW-PAR": 91889, "MOW-NYC": 77417, "MOW-PRG": 71449, "MOW-ROM": 67190, "MOW-TLV": 62132, "MOW-HKT": 58549, "MOW-GOI": 47341, "MOW-IST": 45553 }, "error": null }
Описание ответа
Возвращает список популярных направлений авиакомпании, отсортированный по популярности, количество направлений — не более заданного лимита (limit
).
Данные о странах, городах, аэропортах, авиакомпаниях, самолётах в JSON-формате
Данные о странах
Запрос http://api.travelpayouts.com/data/countries.json
возвращает файл со списком стран из базы данных.
Пример ответа
[{
"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":"ประเทศนิวแคลิโดเนีย"
}},
{
"code":"MT",
"name":"Malta",
"currency":"EUR",
"name_translations":{
"de":"Malta",
"en":"Malta",
"zh-CN":"马耳他",
"tr":"Malta",
"ru":"Мальта",
"fr":"Malte",
"es":"Malta",
"it":"Malta",
"th":"ประเทศมอลตา"
}}
]
Описание ответа
- code — IATA-код страны;
- name — название страны;
- currency — валюта страны;
- name_translations — название страны на различных языках.
Данные о городах
Запрос http://api.travelpayouts.com/data/cities.json
возвращает файл со списком городов из базы данных.
Пример ответа
[{
"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"
},
{
"code":"AAB",
"name":"Arrabury",
"coordinates":{
"lon":141.04167,
"lat":-26.7
},
"time_zone":"Australia/Brisbane",
"name_translations":{
"de":"Arrabury",
"en":"Arrabury",
"zh-CN":"阿拉伯里",
"ru":"Аррабури"
},
"country_code":"AU"
}]
Описание ответа
- code — IATA-код города;
- name — название города;
- coordinates — координаты города;
- time_zone — часовой пояс относительно гринвича;
- name_translations — название города на разных языках;
- country_code — IATA-код страны, в которой находится город.
Данные об аэропортах
Запрос http://api.travelpayouts.com/data/airports.json
возвращает файл со списком аэропортов из базы данных.
Пример ответа
[{
"code":"MQP",
"name":"Kruger Mpumalanga International Airport",
"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"
}]
Описание ответа
- code — IATA-код аэропорта;
- name — название аэропорта;
- coordinates — координаты аэропорта;
- time_zone — часовой пояс относительно гринвича;
- name_translations — название аэропорта на разных языках;
- country_code — IATA-код страны;
- city_code — IATA-код города.
Данные об авиакомпаниях
Запрос http://api.travelpayouts.com/data/airlines.json
возвращает файл со списком авиакомпаний из базы данных.
Пример ответа
[{
"name":"Private flight",
"alias":null,
"iata":null,
"icao":null,
"callsign":null,
"country":null,
"is_active":true
},
{
"name":"135 Airways",
"alias":null,
"iata":null,
"icao":"GNL",
"callsign":"GENERAL",
"country":"United States",
"is_active":false
}]
Описание ответа
- name — название авиакомпании;
- alias — название альянса (если авиакомпания входит в какой-либо альянс);
- iata — IATA-код авиакомпании;
- icao — ICAO-код авиакомпании;
- callsign — позывной авиакомпании;
- country — страна регистрации авиакомпании;
- is_active — true — компания работает, false — нет.
Данные об альянсах
Запрос http://api.travelpayouts.com/data/airlines_alliances.json
возвращает файл со списком альянсов из базы данных.
Пример ответа
[{
"name":"Star Alliance",
"airlines":["A3","AC","AV","CA","CM","ET","JJ","JP","KF","LH","LO","LX","MS","NH","NZ","OS","OU","OZ","PZ","SA","SK","SN","SQ","TA","TG","TK","TP","UA","US"]}]
Описание ответа
- name — название альянса;
- airlines — коды компаний, входящих в альянс.
Данные о самолетах
Запрос http://api.travelpayouts.com/data/planes.json
возвращает файл со списком самолетов из базы данных.
Пример ответа
[{
"code":"100",
"name":"Fokker 100"
},
{
"code":"141",
"name":"British Aerospace BAe 146-100"
},
{
"code":"142",
"name":"British Aerospace BAe 146-200"
},
{
"code":"143",
"name":"British Aerospace BAe 146-300"
}]
Описание ответа
- code — IATA-код самолета;
- name — название самолета.
Данные о маршрутах
Запрос http://api.travelpayouts.com/data/routes.json
возвращает файл со списком маршрутов из базы данных.
Пример ответа
[{
"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"
]
},
{
"airline_iata":"2B",
"airline_icao":null,
"departure_airport_iata":"ASF",
"departure_airport_icao":null,
"arrival_airport_iata":"LED",
"arrival_airport_icao":null,
"codeshare":false,
"transfers":0,
"planes":[
"CR2"
Описание ответа
- airline_iata — IATA-код авиакомпании;
- airline_icao — ICAO-код авиакомпании;
- departure_airport_iata — IATA-код аэропорта отправления;
- departure_airport_icao — ICAO-код аэропорта отправления;
- arrival_airport_iata — IATA-код аэропорта прибытия;
- arrival_airport_icao — ICAO-код аэропорта прибытия;
- codeshare — показывает, осуществляет ли рейс та же компания, что продает билет;
- transfers — количество пересадок;
- planes — IATA-код самолета.