Aviasales API доступа к данным для участников партнёрской программы

Aviasales предоставляет участникам партнёрской программы API для доступа к данным о популярных направлениях и самых низких ценах на авиабилеты.

Уважаемые партнёры! Обратите внимание, все данные передаются из кеша, который формируется на основании поисков пользователей сайтов Aviasales за последние 48 часов. Эти данные рекомендуется использовать для формирования статичных страниц, на которых актуальность информации некритична.

Обратите внимание, для API запросов существуют лимиты, которые описаны в статье Лимиты при работе с API данных.

Для разработчиков доступна документация с примерами запросов и ответов на различных языках программирования, а так же ссылкой на Postman.

Введение

  • Для доступа к API вам необходимо передавать партнёрский токен в заголовке X-Access-Token или в адресной строке параметром token. Партнёрский токен находится в личном кабинете: в разделе Инструменты программы Aviasales, на вкладке 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&currency=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/, чтобы открыть результаты поиска по данному направлению на сайте Авиасейлс. Чтобы сделать из ссылки партнёрскую, используйте Генератор ссылок.
    • 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&currency=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 — валюта, в которой отображается цена на билеты.

Как можно заменить старые запросы

  • /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=2022-11&return_date=2022-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).

Билет без пересадок

Описание

Возвращает самый дешевый билет без пересадок для выбранного направления с фильтрами по датам вылета и возвращения.

Запрос

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=2022-11&return_date=2022-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).

Авиабилеты из города на любое число месяца

Описание

Возвращает самый дешевый билет (без пересадки, с одной или двумя пересадками) для указанного направления для каждого дня выбранного месяца.

Важно: у данного метода установлен лимит — 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=2022-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&currency=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
}
  1. Справочный центр Travelpayouts
  2. API и данные
  3. API данных по авиабилетам от Aviasales