Всё об API для доступа к данным о популярных направлениях и низких ценах на авиабилеты от Авиасейлс.
Travelpayouts предоставляет участникам партнёрской сети API для доступа к данным о популярных направлениях и самых низких ценах на авиабилеты от метапоисковика aviasales.ru.
Уважаемые партнёры! Обратите внимание, все данные передаются из кеша, который формируется на основании поисков пользователей сайтов Aviasales и Jetradar за последние 48 часов. Эти данные рекомендуется использовать для формирования статичных страниц, на которых актуальность информации некритична.
Обратите внимание, для API запросов существуют лимиты, которые описаны в статье Лимиты при работе с API данных.
Для разработчиков доступна документация с примерами запросов и ответов на различных языках программирования, а так же ссылкой на Postman.
Введение
- Для доступа к API вам необходимо передавать партнёрский токен в заголовке
X-Access-Token
или в адресной строке параметромtoken
. Партнёрский токен находится в личном кабинете: в разделе Инструменты программы Aviasales / Jetradar, на вкладке API.
- Даты принимаются в форматах
YYYY-MM
иYYYY-MM-DD
. - Ответ от сервера всегда отдается в формате JSON и имеет следующую структуру:
- success — содержит
true
для успешного запроса иfalse
в случае ошибки; - data — результат выполнения запроса, в случае ошибки возвращается пустой массив:
"data":{}
; - error — краткое описание ошибки, помешавшей выполнить запрос, в случае успешного запроса будет иметь значение
null.
Даты и время в UTC и отформатированы по стандарту ISO 8601. Цены указаны в рублях и актуальны на момент попадания билета в результаты поиска. Не рекомендуется использовать цены, срок актуальности которых истёк (указывается в значении параметра expires_at
).
Если на указанные в запросе даты в кеше отсутствуют данные, то система автоматически произведёт поиск на другие даты. Результат возвращается на ближайшую из найденных дат.
Важно!
Настоятельно рекомендуется получать данные сжатыми в gzip — это существенно сократит время получения ответа. Чтобы получить данные в сжатом виде, необходимо передать заголовок Accept-Encoding: gzip, deflate
.
Cамые дешевые авиабилеты на определённые даты
Описание
Запрос возвращает самые дешевые авиабилеты за определённые даты, найденные пользователями Авиасейлс за последние 48 часов. Рекомендуется использовать вместо методов:
- /v1/city-directions
- /v1/prices/cheap
- /v1/prices/direct
Запрос
https://api.travelpayouts.com/aviasales/v3/prices_for_dates
Параметры запроса
- currency — валюта цен на билеты. Значение по умолчанию — rub.
- origin — пункт отправления. IATA-код города или аэропорта. Длина не менее двух и не более трёх символов. Необходимо указать, если нет destination.
- destination — пункт назначения. IATA-код города или аэропорта. Длина не менее двух и не более трёх. Необходимо указать, если нет origin.
- departure_at (необязательно)— дата вылета из пункта отправления (в формате
YYYY-MM
илиYYYY-MM-DD
). - return_at (необязательно) — дата возвращения. Чтобы получить билеты в один конец, оставьте это поле пустым.
- direct — получить рейсы без пересадок. Принимает значения
true
илиfalse
. По умолчаниюfalse
. - limit — количество записей в ответе. Значение по умолчанию — 30. Не более 1000.
- page — номер страницы. Используется, чтобы пропустить первые записи. То есть, выдача будет отдавать билеты в диапазоне
[(page — 1) * limit; page * limit]
. Таким образом, если мы хотим получить билеты с 100 по 150, то мы должны установитьpage=3
, аlimit=50
. - sorting — сортировка цен:
- price — по цене (значение по умолчанию).
- route — по популярности маршрута.
- unique — возвращает только уникальные направления, если был указан origin, но не указан destination. Позволяет собрать топ самых дешевых билетов из указанного города. Принимает значения
true
илиfalse
. По умолчаниюfalse
.
Пример запроса
https://api.travelpayouts.com/aviasales/v3/prices_for_dates?origin=MOW&destination=DXB¤cy=usd&departure_at=2022-03-01&return_at=2022-03-10&sorting=price&direct=true&limit=10&token=РазместитеЗдесьВашТокен
Пример ответа
{ "success":true, "data":[ { "origin":"MOW", "destination":"DXB", "origin_airport":"SVO", "destination_airport":"DXB", "price":452, "airline":"SU", "flight_number":"520", "departure_at":"2022-03-01T08:40:00+03:00", "return_at":"2022-03-10T16:40:00+04:00", "transfers":0, "return_transfers":0, "duration":660, "link":"/MOW0103DXB10032?t=SU16461132001646132700000000SVODXB16469160001646936100000000DXBSVO_a2febff14b480eb0abaaf159cf9ac6ca_64888\u0026search_date=13102021\u0026expected_price_uuid=841aa66e-7258-4d2b-8afc-3314b7c10e4e\u0026expected_price_currency=rub" } ], "currency":"usd" }
Поля ответа
- success — результат запроса.
- data — полученные данные:
- origin — пункт отправления.
- destination — пункт назначения.
- origin_airport — IATA-код аэропорта отправления.
- destination_airport — IATA-код аэропорта прибытия.
- price — стоимость билета.
- airline — IATA-код авиакомпании.
- flight_number — номер рейса.
- departure_at — дата отправления.
- return_at — дата возвращения.
- transfers — количество пересадок на пути «туда».
- return_transfers — количество пересадок на пути «обратно».
- duration — продолжительность перелёта в минутах.
- link — ссылка на билет. Добавьте этот код к адресу https://www.aviasales.ru/search/, чтобы открыть результаты поиска по данному направлению на сайте Авиасейлс. Чтобы сделать из ссылки партнёрскую, используйте Генератор ссылок.
- currency — валюта, в которой отображается цена на билеты.
Как можно заменить старые запросы
- /v1/prices/cheap — выставить параметры direct=false и sorting=price.
- /v1/prices/direct — выставить параметры direct=true и sorting=price.
- /v1/city-directions — выставить параметры sorting=route и unique=true. Передавать только origin.
Сгруппированные дешевые авиабилеты
Описание
Запрос возвращает самые дешевые авиабилеты, сгруппированные по определённом признаку, найденные пользователями Авиасейлс за последние 48 часов. Рекомендуется использовать вместо методов:
- /v1/prices/calendar
- /v1/prices/monthly
Запрос
https://api.travelpayouts.com/aviasales/v3/grouped_prices
Параметры запроса
- currency — валюта цен на билеты. Значение по умолчанию — rub.
- origin — пункт отправления. IATA-код города или аэропорта. Длина не менее двух и не более трёх символов.
- destination — пункт назначения. IATA-код города или аэропорта. Длина не менее двух и не более трёх.
- group_by — параметр группировки:
- departure_at — по дате отправления (по умолчанию);
- return_at — по дате обратного вылета;
- month — по месяцам.
- departure_at — дата вылета из пункта отправления (в формате
YYYY-MM
илиYYYY-MM-DD
). - return_at — дата возвращения. Чтобы получить билеты в один конец, оставьте это поле пустым.
- direct — получить рейсы без пересадок. Принимает значения
true
илиfalse
. По умолчаниюfalse
. - trip_duration — длительность путешествия.
Пример запроса
https://api.travelpayouts.com/aviasales/v3/grouped_prices?origin=MOW&destination=BCN¤cy=usd&departure_at=2021-11&group_by=departure_at&token=РазместитеЗдесьВашТокен
Пример ответа
{ "success":true, "data":{ "2021-11-01":{ "origin":"MOW", "destination":"BCN", "origin_airport":"SVO", "destination_airport":"BCN", "price":136, "airline":"AY", "flight_number":"714", "departure_at":"2021-11-01T21:00:00+03:00", "transfers":1, "return_transfers":0, "duration":1505, "link":"/MOW0111BCN1?t=AY16357896001635879900001125SVOHELBCN_b8530405d83ccc8ebed131053739edab_9726\u0026search_date=15102021\u0026expected_price_uuid=1df53122-a12e-4faf-9a65-cd2ccfd51fbf\u0026expected_price_currency=rub" } }, "currency":"usd" }
Поля ответа
- success — результат запроса.
- data — полученные данные:
- 2021-11-01 — поле группировки:
- origin — пункт отправления.
- destination — пункт назначения.
- origin_airport — IATA-код аэропорта отправления.
- destination_airport — IATA-код аэропорта прибытия.
- price — стоимость билета.
- airline — IATA-код авиакомпании.
- flight_number — номер рейса.
- departure_at — дата отправления.
- return_at — дата возвращения.
- transfers — количество пересадок на пути «туда».
- return_transfers — количество пересадок на пути «обратно».
- duration — продолжительность перелёта в минутах.
- link — ссылка на билет. Добавьте этот код к адресу https://www.aviasales.ru/search/, чтобы открыть результаты поиска по данному направлению на сайте Авиасейлс. Чтобы сделать из ссылки партнёрскую, используйте Генератор ссылок.
- currency — валюта, в которой отображается цена на билеты.
- 2021-11-01 — поле группировки:
Как можно заменить старые запросы
- /v1/prices/calendar — передать в group_by значение departure_at или return_at;
- /v1/prices/monthly — передать в group_by значение month и не передавать параметры departure_at и return_at.
Цены на авиабилеты за период
Описание
Возвращает цены на авиабилеты за определённый период, найденные пользователями Авиасейлс за последние 48 часов.
Запрос
http://api.travelpayouts.com/v2/prices/latest
Параметры запроса
- currency — валюта цен на билеты. Значение по умолчанию — rub.
- origin — пункт отправления. IATA-код страны, города или аэропорта. Длина не менее двух и не более трёх символов.
- destination — пункт назначения. IATA-код страны, города или аэропорта. Длина не менее двух и не более трёх.
Если origin и destination не указаны, по умолчанию будет возвращаться origin=MOW. - beginning_of_period — начало периода даты вылета. Формат даты зависит от параметра period.
- period — период, в котором искали билеты. Если период не указан, то отображаются билеты для перелётов в текущем месяце.
- year — билеты, найденные в указанном году. В beginning_of_period год указывается в формате YYYY;
- month — билеты за указанный в beginning_of_period месяц (месяц в формате YYYY-MM-DD);
- day — билеты за указанный в beginning_of_period день (день в формате YYYY-MM-DD).
- one_way — true — в одну сторону, false — туда и обратно. Значение по умолчанию — true.
- page — номер страницы. Значение по умолчанию — 1.
- limit— количество записей на странице. Значение по умолчанию — 30. Не более 1000.
- sorting — сортировка цен:
- price — по цене (значение по умолчанию). Для направлений город — город возможна сортировка только по цене.
- route — по популярности маршрута.
- distance_unit_price — по цене за километр.
- trip_duration — длительность пребывания в неделях.
Пример запроса
http://api.travelpayouts.com/v2/prices/latest?currency=rub&period_type=year&page=1&limit=30&show_to_affiliates=true&sorting=price&token=РазместитеЗдесьВашТокен
Пример ответа
{ "success":true, "data":[{ "show_to_affiliates":true, "origin":"WMI", "destination":"WRO", "depart_date":"2021-12-07", "return_date":"2021-12-13", "number_of_changes":0, "value":1183, "found_at":"2021-09-22T14:08:45+04:00", "distance":298, "actual":true }] }
Поля ответа
- success — результат запроса.
- data — полученные данные:
- origin — пункт отправления.
- destination — пункт назначения.
- show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
- depart_date — дата отправления.
- return_date — дата возвращения.
- number_of_changes — количество пересадок.
- value — стоимость перелёта в указанной валюте.
- found_at — время и дата, когда был найден билет.
- distance — расстояние между пунктом вылета и назначения.
- actual — является ли предложение актуальным.
Цены на авиабилеты за месяц
Описание
Возвращает цены за каждый день месяца, сгруппированные по количеству пересадок.
Запрос
http://api.travelpayouts.com/v2/prices/month-matrix
Параметры запроса
- currency — валюта цен на билеты. Значение по умолчанию — rub.
- origin — пункт отправления. IATA-код города. Длина — три символа. Значение по умолчанию — LED.
- destination — пункт назначения. IATA-код города. Длина — три символа. Значение по умолчанию — HKT.
- show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
- month — первый день месяца, в формате «YYYY-MM-DD». По умолчанию используется месяц, следующий за текущим.
- trip_duration — длительность пребывания в неделях. Если не указано, то в результате будут билеты в одну сторону.
- one_way — false — возвращает билеты туда-обратно, true — только в одну сторону. Значение по умолчанию — true.
Пример запроса
http://api.travelpayouts.com/v2/prices/month-matrix?currency=rub&origin=LED&destination=HKT&show_to_affiliates=true&token=РазместитеЗдесьВашТокен
Пример ответа
{{ "success":true, "data":[{ "show_to_affiliates":true, "trip_class":0, "origin":"LED", "destination":"HKT", "depart_date":"2021-10-01", "return_date":"", "number_of_changes":1, "value":29127, "found_at":"2021-09-24T00:06:12+04:00", "distance":8015, "actual":true }] }
Поля ответа
- success — результат запроса.
- data — полученные данные:
- origin — пункт отправления.
- destination — пункт назначения.
- show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
- trip_class — класс перелёта (только 0 — Эконом).
- depart_date — дата отправления.
- return_date — дата возвращения.
- number_of_changes — количество пересадок.
- value — стоимость перелёта в указанной валюте.
- found_at — время и дата, когда был найден билет.
- distance — расстояние между пунктом вылета и назначения.
- actual — является ли предложение актуальным.
Цены на авиабилеты по альтернативным направлениям
Описание
Возвращает цены на направления между ближайшими к заданным городам.
Запрос
http://api.travelpayouts.com/v2/prices/nearest-places-matrix
Параметры запроса
- currency — валюта цен на билеты. Значение по умолчанию — rub.
- origin — пункт отправления. IATA-код города или код страны. Длина не менее двух и не более трёх символов.
- destination — пункт назначения. IATA-код города или код страны. Длина не менее двух и не более трёх символов.
- show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
- depart_date — дата отправления в формате 'YYYY-MM-DD'.
- return_date — дата возвращения в формате 'YYYY-MM-DD'.
- distance — расстояние (в километрах) от пунктов назначения и отправления, на котором ищутся соседние города.
- limit — количество выводимых вариантов от 1 до 20. Где 1 — это только вариант с указанными пунктами назначения и отправления.
- flexibility — расширение диапазона дат в большую и меньшую сторону. Значение может быть от 0 до 7, где 0 — в результате будут только варианты на указанные даты, 7 — все найденные варианты за неделю до указанных дат и неделю после.
Пример запроса
http://api.travelpayouts.com/v2/prices/nearest-places-matrix?currency=rub&origin=LED&destination=HKT&show_to_affiliates=true&token=РазместитеЗдесьВашТокен
Пример ответа
{
"prices":[
{
"value":26000.0,
"trip_class":0,
"show_to_affiliates":true,
"return_date":"2021-09-18",
"origin":"BAX",
"number_of_changes":0,
"gate":"AMADEUS",
"found_at":"2021-07-28T04:57:47Z",
"duration":null,
"distance":3643,
"destination":"SIP",
"depart_date":"2021-09-09",
"actual":true
}
],
"origins":[
"BAX"
],
"errors":{
"amadeus":{
}
},
"destinations":[
"SIP"
]
}
Поля ответа
- prices — массив, полученных цен:
- value — стоимость перелёта в указанной валюте.
- trip_class — класс перелёта (только 0 — Эконом).
- show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
- return_date — дата возвращения.
- origin — список пунктов отправления, ближайших к указанному.
- number_of_changes — количество пересадок.
- gate — агентство, в котором был найден билет.
- found_at — время и дата, когда был найден билет.
- duration — продолжительность полёта в минутах с учетом пересадок и ожидания.
- distance — расстояние между пунктом вылета и назначения по карте.
- destination — список пунктов назначения, ближайших к указанному.
- depart_date — дата отправления.
- actual — является ли предложение актуальным.
- origins — массив пунктов отправления в ответе.
- destinations — массив пунктов назначения в ответе.
- errors — сообщение об ошибке. Если возвращается ошибка «Some error occured», значит, по этому направлению нет данных в кеше.
Самые дешевые авиабилеты
Описание
Возвращает самые дешевые билеты без пересадок, а также с одной и двумя пересадками для выбранного направления с фильтрами по датам вылета и возвращения. Билеты возвращаются на рейсы туда-обратно.
Запрос
http://api.travelpayouts.com/v1/prices/cheap
Параметры запроса
- origin — IATA-код города вылета. IATA-код указывается буквами верхнего регистра, например, MOW.
- destination — IATA-код города назначения (передайте пустой параметр для любых направлений, например, &destination=&). IATA-код указывается буквами верхнего регистра, например, MOW.
- depart_date (необязательно) — месяц вылета (формат YYYY-MM).
- return_date (необязательно) — месяц возвращения (формат YYYY-MM).
- token — индивидуальный токен доступа.
- page — необязательный параметр, используется для отображения найденных данных (по умолчанию на странице отображается 100 найденных вариантов. Если не выбран destination, то данных может быть больше. В этом случае используйте page, для отображения следующего набора данных, например, page=2).
- currency — валюта цен на билеты. Значение по умолчанию — rub. Допустимые значения: [«USD», «EUR», «RUB»].
Обратите внимание! Если в запросе указаны старые даты, то в результате его работы ошибки не будет, но и данных никаких не вернется.
Пример запроса
http://api.travelpayouts.com/v1/prices/cheap?origin=MOW&destination=HKT&depart_date=2021–11&return_date=2021–12&token=РазместитеЗдесьВашТокен
Пример ответа
{ "success": true, "data": { "HKT": { "0": { "price": 35443, "airline": "UN", "flight_number": 571, "departure_at": "2021-06-09T21:20:00Z", "return_at": "2021-07-15T12:40:00Z", "expires_at": "2021-01-08T18:30:40Z" }, "1": { "price": 27506, "airline": "CX", "flight_number": 204, "departure_at": "2021-06-05T16:40:00Z", "return_at": "2021-06-22T12:00:00Z", "expires_at": "2021-01-08T18:38:45Z" }, "2": { "price": 31914, "airline": "AB", "flight_number": 8113, "departure_at": "2021-06-12T13:45:00Z", "return_at": "2021-06-24T20:30:00Z", "expires_at": "2021-01-08T15:17:42Z" } } }
Поля ответа
- success — результат запроса.
- data — полученные данные:
- 0, 1, 2 — порядковый номер в результатах выдачи.
- price — цена билета (в заданной валюте, параметр currency).
- airline — IATA-код авиакомпании, выполняющей перелет.
- flight_number — номер рейса.
- departure_at — дата вылета.
- return_at — дата возвращения.
- expires_at — дата истечения актуальности найденной цены (UTC+0).
- 0, 1, 2 — порядковый номер в результатах выдачи.
Билет без пересадок
Описание
Возвращает самый дешевый билет без пересадок для выбранного направления с фильтрами по датам вылета и возвращения.
Запрос
http://api.travelpayouts.com/v1/prices/direct
Параметры запроса
- origin — IATA-код города вылета. IATA-код указывается буквами верхнего регистра, например, MOW.
- destination — IATA-код города назначения (укажите «-" для любых направлений, например, &destination=&). IATA-код указывается буквами верхнего регистра, например, MOW.
- depart_date (необязательно) — месяц вылета (YYYY-MM).
- return_date (необязательно) — месяц возвращения (YYYY-MM).
- currency — валюта ответа (USD, EUR, RUB). Значение по умолчанию — rub.
- token — индивидуальный токен доступа.
Пример запроса
http://api.travelpayouts.com/v1/prices/direct?origin=MOW&destination=LED&depart_date=2021–11&return_date=2021–12&token=РазместитеЗдесьВашТокен
Пример ответа
{ "success": true, "data": { "HKT": { "0": { "price": 35443, "airline": "UN", "flight_number": 571, "departure_at": "2021-06-09T21:20:00Z", "return_at": "2021-07-15T12:40:00Z", "expires_at": "2021-01-08T18:30:40Z" }, "1": { "price": 27506, "airline": "CX", "flight_number": 204, "departure_at": "2021-06-05T16:40:00Z", "return_at": "2021-06-22T12:00:00Z", "expires_at": "2021-01-08T18:38:45Z" }, "2": { "price": 31914, "airline": "AB", "flight_number": 8113, "departure_at": "2021-06-12T13:45:00Z", "return_at": "2021-06-24T20:30:00Z", "expires_at": "2021-01-08T15:17:42Z" } } }
Поля ответа
- success — результат запроса.
- data — полученные данные (в разрезе IATA-кодов):
- 0, 1, 2 — порядковый номер в результатах выдачи.
- price — цена билета (в заданной валюте).
- airline — IATA-код авиакомпании, выполняющей перелёт.
- flight_number — номер рейса.
- departure_at — дата вылета.
- return_at — дата возвращения.
- expires_at — дата истечения актуальности найденной цены (UTC+0).
- 0, 1, 2 — порядковый номер в результатах выдачи.
Авиабилеты из города на любое число месяца
Описание
Возвращает самый дешевый билет (без пересадки, с одной или двумя пересадками) для указанного направления для каждого дня выбранного месяца.
Важно: у данного метода установлен лимит — 10 запросов в секунду.
Запрос
http://api.travelpayouts.com/v1/prices/calendar
Параметры запроса
- origin — IATA-код города вылета. IATA-код указывается буквами верхнего регистра, например, MOW.
- destination — IATA-код города назначения. IATA-код указывается буквами верхнего регистра, например, MOW.
- departure_date (опционально) — месяц вылета (в формате YYYY-MM). По умолчанию передаётся текущий месяц. Если не передать параметр, и до конца месяца меньше недели — будет использована дата следующего месяца в формате YYYY-MM. Если передать пустую строку, то будут выведены результаты на год вперёд.
- return_date (опционально) — месяц возвращения (в формате YYYY-MM). Если не передать параметр, но передать
departure_date
, то выведутся билеты на указанный там месяц. Если передать пустую строку вdeparture_date
и передатьreturn_date
, то он выступит ограничителем даты и выведет билеты до конца месяцаreturn_date
с текущей даты. - calendar_type — поле, по которому будет строиться календарь. Одно из двух значений:
departure_date
илиreturn_date
. - trip_duration (опционально) — длительность пребывания в городе назначения.
- token — индивидуальный токен доступа.
- currency — валюта ответа (USD, EUR, RUB). Значение по умолчанию — rub.
Пример запроса
https://api.travelpayouts.com/v1/prices/calendar?departure_date=2021–11&origin=MOW&destination=BCN&calendar_type=departure_date&token=РазместитеЗдесьВашТокен
Пример ответа
{ "success": true, "data": { "2021-06-01": { "origin": "MOW", "destination": "BCN", "price": 12449, "transfers": 1, "airline": "PS", "flight_number": 576, "departure_at": "2021-06-01T06:35:00Z", "return_at": "2021-07-01T13:30:00Z", "expires_at": "2021-01-07T12:34:14Z" }, "2021-06-02": { "origin": "MOW", "destination": "BCN", "price": 13025, "transfers": 1, "airline": "PS", "flight_number": 578, "departure_at": "2021-06-02T17:00:00Z", "return_at": "2021-06-11T13:30:00Z", "expires_at": "2021-01-06T17:15:47Z" }, ... "2021-06-30": { "origin": "MOW", "destination": "BCN", "price": 13025, "transfers": 1, "airline": "PS", "flight_number": 578, "departure_at": "2021-06-30T17:00:00Z", "return_at": "2021-07-23T13:30:00Z", "expires_at": "2021-01-07T20:15:34Z" } } }
Поля ответа
- success — результат запроса.
- data — полученные данные (в разрезе дат):
- origin — IATA-код города вылета.
- destination — IATA-код города назначения.
- price — цена билета в заданной валюте.
- transfers — количество пересадок.
- airline — IATA-код авиакомпании.
- flight_number — номер рейса.
- departure_at — дата вылета.
- return_at — дата возвращения.
- expires_at — срок истечения актуальности цены (UTC+0).
- source — источник данных. Если не указано, значит, данные подгружаются из нашей базы. Обратите внимание! Если данные отдаются от нашего партнёра (например, skypicker), то в параметре origin и destination указывается IATA-код аэропорта, а не города.
Популярные направления авиакомпании
С 14 марта 2022 года мы прекращаем поддержку данного метода. Вместо него вы можете использовать новый метод prices_for_dates.
Описание
Возвращает направления, по которым авиакомпания осуществляет перелеты, отсортированные по популярности.
Запрос
http://api.travelpayouts.com/v1/airline-directions
Параметры запроса
- airline_code — IATA-код авиакомпании. IATA-код указывается буквами верхнего регистра, например SU.
- limit — количество записей на странице. Значение по умолчанию — 30. Не более 1000.
- token — индивидуальный токен доступа.
Пример запроса
http://api.travelpayouts.com/v1/airline-directions?airline_code=SU&limit=10&token=РазместитеЗдесьВашТокен
Пример ответа
{ "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, "currency": "rub" }
Поля ответа
- success — результат запроса.
- data — перечень популярных направлений авиакомпании с указанием популярности направления.
- currency — валюта ответа (USD, EUR, RUB). Никакого отношения к данным в ответе не имеет.
Специальные предложения
Обратите внимание! Запрос http://api.travelpayouts.com/v2/prices/special-offers прекратил свою работу с 01 ноября 2021. Вместо него следует использовать новый метод.
Описание
Возвращает аномально низкие цены на авиабилеты по выбранным направлениям.
Запрос
https://api.travelpayouts.com/aviasales/v3/get_special_offers
Параметры запроса
- origin — IATA-код города или аэропорта отправления.
- destination — IATA-код города или аэропорта прибытия.
- locale — язык, на котором будет возвращен результат.
- currency — валюта, в которой будуи указаны цены.
- airline — IATA-код авиакомпании.
- token — индивидуальный токен доступа.
Пример запроса
https://api.travelpayouts.com/aviasales/v3/get_special_offers?origin=MOW&destination=LED&airline=s7&locale=en&token=РазместитеЗдесьВашТокен
Пример ответа
{ "currency": "rub", "data": [ { "airline": "N4", "airline_title": "Nordwind Airlines", "color": "CD202C", "departure_at": "2021-09-14T08:55:00+03:00", "destination": "LED", "destination_airport": "LED", "destination_name": "Saint Petersburg", "duration": 85, "flight_number": "177", "link": "/MOW1409LED1?t=N416315989001631604000000000SVOLED_3d507ff71944b34ca6e5016e0c0fce85_1413\u0026search_date=29072021\u0026expected_price_uuid=9a904680-6d3b-4dee-a361-b85da4e63590\u0026expected_price_currency=rub", "mini_title": "Flight deals from Moscow", "origin": "MOW", "origin_airport": "SVO", "origin_name": "Moscow", "price": 1413, "title": "Flight deals from Moscow to Saint Petersburg" } ], "success": true }
Поля ответа
- success — результат запроса.
- data — полученные данные:
- airline — код авиакомпании.
- airline_title — название авиакомпании.
- destination — IATA-код города прибытия.
- destination_airport — IATA-код аэропорта прибытия.
- flight_number — номер рейса.
- duration — продолжительность полёта в минутах.
- origin_airport — IATA-код аэропорта отправления.
- price — цена билета.
- return_at — дата возвращения (в формате RFC3339).
- departure_at — дата отправления (в формате RFC3339).
- mini_title — краткое название спецпредложения.
- origin — IATA-код города отправления.
- color — цвета бренда авиакомпании (в формате RGB).
- link — ссылка на билет с предложением (обратите внимание, если билеты закончатся, ссылка будет вести на новый поиск).
- title — название для спец. предложения.
Дешевые авиабилеты на неделю
Описание
Запрос возвращает цены на неделю, начиная с заданных дат.
Запрос
http://api.travelpayouts.com/v2/prices/week-matrix
Параметры запроса
- currency — валюта цен на билеты. Значение по умолчанию — rub.
- origin — пункт отправления. IATA-код города. Значение по умолчанию — LED.
- destination — пункт назначения. IATA-код города. Значение по умолчанию — HKT.
- show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
- depart_date — вылет туда. Дата в формате 'YYYY-MM-DD'.
- return_date — вылет обратно. Дата в формате 'YYYY-MM-DD'.
Пример запроса
http://api.travelpayouts.com/v2/prices/week-matrix?currency=rub&origin=LED&destination=HKT&show_to_affiliates=true&depart_date=2021-09-04&return_date=2021-09-18&token=РазместитеЗдесьВашТокен
Пример ответа
{
"success":true,
"data":[
{
"show_to_affiliates":true,
"trip_class":0,
"origin":"LED",
"destination":"HKT",
"depart_date":"2021-03-01",
"return_date":"2021-03-15",
"number_of_changes":1,
"value":71725,
"found_at":"2021-02-19T00:04:37+04:00",
"distance":8015,
"actual":true
}]
}
Поля ответа
- success — результат запроса.
- data — полученные данные:
- show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
- origin — пункт отправления.
- destination — пункт назначения.
- trip_class — класс перелёта (только 0 — Эконом).
- depart_date — дата отправления.
- return_date — дата возвращения.
- number_of_changes — количество пересадок.
- value — стоимость перелёта в указанной валюте.
- found_at — время и дата, когда был найден билет.
- distance — расстояние между пунктом вылета и назначения.
- actual — является ли предложение актуальным.
Популярные направления из города
Описание
Возвращает самые популярные направления из заданного города
Запрос
http://api.travelpayouts.com/v1/city-directions
Параметры запроса
- origin — пункт отправления. IATA-код города.
- currency — валюта цен на билеты. Значение по умолчанию — rub.
Пример запроса
http://api.travelpayouts.com/v1/city-directions?origin=MOW¤cy=usd&token=РазместитеЗдесьВашТокен
Пример ответа
{ "success":true, "data":{ "AER":{ "origin":"MOW", "destination":"AER", "price":3673, "transfers":0, "airline":"WZ", "flight_number":125, "departure_at":"2021-03-08T16:35:00Z", "return_at":"2021-03-17T16:05:00Z", "expires_at":"2021-02-22T09:32:44Z" } }, "error":null, "currency":"rub" }
Поля ответа
- success — результат запроса.
- data — полученные данные (в разрезе дат):
- origin — пункт отправления.
- destination — пункт назначения.
- departure_at — дата и время отправления.
- return_at — дата и время возвращения.
- number_of_changes — количество пересадок.
- price — стоимость перелёта в указанной валюте.
- found_at — время и дата, когда был найден билет.
- transfers — количество пересадок.
- airline — IATA-код авиакомпании.
- flight_number — номер рейса.
- currency — валюта ответа.
Логотипы авиакомпаний
Логотипы авиакомпаний доступны по адресу: http://pics.avs.io/width/height/iata.png
где, width — ширина логотипа, height — высота логотипа, iata — IATA-код авиакомпании. Размер может быть любым.
Пример: http://pics.avs.io/200/200/UN.png.
Текущий курс валют к рублю
Описание
Возвращает текущий курс всех популярных валют к рублю.
Запрос
http://yasen.aviasales.ru/adaptors/currency.json
Пример ответа
{
"cny":8.24394,
"eur":57.1578,
"mzn":1.49643,
"nio":1.97342,
"usd":51.1388,
"hrk":7.48953
}