API данных Aviasales для партнёров

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

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

Все данные передаются из кеша, который формируется на основании поисков пользователей сайтов Aviasales. Диапазон хранения составляет от 2 до 7 дней в зависимости от типа запроса.

Эти данные рекомендуется использовать для формирования статичных страниц, на которых актуальность информации некритична.

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

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

Введение

Как получить доступ к API

Для доступа к 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.

Данные по странам (маркетам)

В API используется такое понятие, как маркет. Он зависит от разных факторов, чаще всего – это язык сайта Авиасейлс, на котором пользователи искали билеты.

Каждый поиск связывается с определённым маркетом. Это означает, что если пользователь искал что-то на сайте aviasales.ru, то данные в кеше будут только для ru маркета и их не будет для us маркета (с которым связан, например, aviasales.com).

По умолчанию маркет определяется по пункту отправления (параметр origin в запросе API). Если определить маркет не удалось, то будут возвращены данные для ru-маркета.

Во всех запросах вы можете использовать параметр market, чтобы задать нужный вам маркет (для разных маркетов могут быть подключены разные агентства, а значит партнёрам в Америке лучше видеть кеш для us маркета, а не для ru).

Список доступных маркетов можно посмотреть здесь.

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 (необязательно) — дата возвращения. Чтобы получить билеты в один конец, оставьте это поле пустым.
one_way (необязательно) — билет в одну сторону. Принимает значения true или false. По умолчанию true.
Поскольку в запросе применяется группировка по датам, при значении true возвращается только 1 билет в одну сторону. Чтобы получить больше билетов в обе стороны, используйте one_way=false.
direct — получить рейсы без пересадок. Принимает значения true или false. По умолчанию false.
market — задаёт маркет источника данных (по умолчанию ru).
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&departure_at=2023-07&return_at=2023-08&unique=false&sorting=price&direct=false&currency=rub&limit=30&page=1&one_way=true&token=РазместитеЗдесьВашТокен

Пример ответа

{
   "success":true,
   "data":[      
 {
         "origin":"MOW",
         "destination":"DXB",
         "origin_airport":"SVO",
         "destination_airport":"DXB",
         "price":45200,
         "airline":"SU",
         "flight_number":"520",
         "departure_at":"2023-07-01T08:40:00+03:00",
         "return_at":"2023-08-10T16:40:00+04:00",
         "transfers":0,
         "return_transfers":0,
         "duration":660,
         "duration_to":320,
         "duration_back":340,
         "link":"/MOW0103DXB10032?t=SU16461132001646132700000000SVODXB16469160001646936100000000DXBSVO_a2febff14b480eb0abaaf159cf9ac6ca_64888\u0026search_date=13102021\u0026expected_price_uuid=841aa66e-7258-4d2b-8afc-3314b7c10e4e\u0026expected_price_currency=rub"
      }
   ],
   "currency":"rub"
}

Поля ответа

success — результат запроса.
data — полученные данные:
- origin — пункт отправления.
- destination — пункт назначения.
- origin_airport — IATA-код аэропорта отправления.
- destination_airport — IATA-код аэропорта прибытия.
- price — стоимость билета.
- airline — IATA-код авиакомпании.
- flight_number — номер рейса.
- departure_at — дата отправления.
- return_at — дата возвращения.
- transfers — количество пересадок на пути «туда».
- return_transfers — количество пересадок на пути «обратно».
- duration — общая продолжительность перелёта туда-обратно в минутах.
- duration_to — продолжительность перелёта до места назначения в минутах.
- duration_back — продолжительность перелёта обратно в минутах.
- 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 — дата возвращения. Чтобы получить билеты в один конец, оставьте это поле пустым.
market — задаёт маркет источника данных (по умолчанию ru).
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/aviasales/v3/get_latest_prices

Параметры запроса

currency — валюта цен на билеты. Значение по умолчанию — rub.
origin — пункт отправления. IATA-код страны, города или аэропорта. Длина не менее двух и не более трёх символов.
destination — пункт назначения. IATA-код страны, города или аэропорта. Длина не менее двух и не более трёх.
Если origin и destination не указаны, по умолчанию будет возвращаться origin=MOW.
beginning_of_period — начало периода даты вылета.
period_type — период, в котором искали билеты. Если период не указан, то отображаются билеты для перелётов в текущем месяце:
- year — билеты, найденные в указанном году. В beginning_of_period год указывается в формате YYYY;
  month — билеты за указанный в beginning_of_period месяц (месяц в формате YYYY-MM-DD);
  day — билеты за указанный в beginning_of_period день (день в формате YYYY-MM-DD).
group_by — параметр группировки:
- dates — по датам (по умолчанию);
- directions — по направлениям.
one_way — true — в одну сторону, false — туда и обратно. Значение по умолчанию — true.
page — номер страницы. Значение по умолчанию — 1.
market — задаёт маркет источника данных (по умолчанию ru).
limit— количество записей на странице. Значение по умолчанию — 30. Не более 1000.
sorting — сортировка цен:
- price — по цене (значение по умолчанию). Для направлений город — город возможна сортировка только по цене.
- route — по популярности маршрута.
- distance_unit_price — по цене за километр.
trip_duration — длительность путешествия в днях.
trip_class — класс обслуживания самолёте:
- 0 — эконом;
- 1 — бизнес класс;
- 2 — первый класс.

Пример запроса

http://api.travelpayouts.com/aviasales/v3/get_latest_prices?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":-1,
      "actual":true
   }]
}

Поля ответа

success — результат запроса.
data — полученные данные:
- origin — пункт отправления
- destination — пункт назначения
- depart_date — дата отправления
- distance — дальность полета в километрах
- duration — длительность полёта в минутах
- return_date — дата возвращения
- number_of_changes — количество пересадок
- value — стоимость перелёта в указанной валюте
- found_at — время и дата, когда был найден билет
- trip_class — класс обслуживания самолёте:
  - 0 — эконом;
  - 1 — бизнес класс;
  - 2 — первый класс.

Цены на авиабилеты за месяц

Описание

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

Запрос

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». По умолчанию используется месяц, следующий за текущим.
market — задаёт маркет источника данных (по умолчанию ru).
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 — расстояние (в километрах) от пунктов назначения и отправления, на котором ищутся соседние города.
market — задаёт маркет источника данных (по умолчанию ru).
limit — количество выводимых вариантов от 1 до 20. Где 1 — это только вариант с указанными пунктами назначения и отправления. Это обязательный параметр, если вы хотите отобразить цены на альтернативные направления.
flexibility — расширение диапазона дат в большую и меньшую сторону. Значение может быть от 0 до 7, где 0 — в результате будут только варианты на указанные даты, 7 — все найденные варианты за неделю до указанных дат и неделю после.

Пример запроса

https://api.travelpayouts.com/v2/prices/nearest-places-matrix?currency=rub&origin=OVB&destination=LED&show_to_affiliates=true&distance=1000&limit=5&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 — индивидуальный токен доступа.
market — задаёт маркет источника данных (по умолчанию ru).
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).
market — задаёт маркет источника данных (по умолчанию ru).
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 с текущей даты.
market — задаёт маркет источника данных (по умолчанию ru).
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-код аэропорта, а не города.

Специальные предложения

Обратите внимание! Запрос http://api.travelpayouts.com/v2/prices/special-offers прекратил свою работу с 01 ноября 2021. Вместо него следует использовать новый метод.

Описание

Возвращает аномально низкие цены на авиабилеты по выбранным направлениям.

Запрос

https://api.travelpayouts.com/aviasales/v3/get_special_offers

Параметры запроса

origin — IATA-код города или аэропорта отправления.
Обратите внимание! Если не указать origin в запросе, он будет определён автоматически по IP адресу.
destination — IATA-код города или аэропорта прибытия.
locale — язык, на котором будет возвращен результат.
currency — валюта, в которой будут указаны цены.
airline — IATA-код авиакомпании.
market — задаёт маркет источника данных (по умолчанию ru).
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 — ссылка на билет с предложением.
  Добавьте этот код к адресу https://www.aviasales.ru/search/, чтобы открыть результаты поиска по данному направлению на сайте Авиасейлс (обратите внимание, если билеты закончатся, ссылка будет вести на новый поиск). Чтобы сделать из полученной ссылки партнёрскую, используйте форму создания партнёрских ссылок.
- title — название для спец. предложения.

Дешевые авиабилеты на неделю

Описание

Запрос возвращает цены на неделю, начиная с заданных дат.

Запрос

http://api.travelpayouts.com/v2/prices/week-matrix

Параметры запроса

currency — валюта цен на билеты. Значение по умолчанию — rub.
origin — пункт отправления. IATA-код города. Значение по умолчанию — LED.
destination — пункт назначения. IATA-код города. Значение по умолчанию — HKT.
show_to_affiliates — false — все цены, true — только цены, найденные с партнёрским маркером (рекомендовано). Значение по умолчанию — true.
market — задаёт маркет источника данных (по умолчанию ru).
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://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
}

Введение

Как получить доступ к API

Формат дат и содержимое ответа

Данные по странам (маркетам)

Cамые дешевые авиабилеты на определённые даты

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

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

Сгруппированные дешевые авиабилеты

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

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

Цены на авиабилеты за период

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

Цены на авиабилеты за месяц

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

Цены на авиабилеты по альтернативным направлениям

Описание

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

Самые дешевые авиабилеты

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

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

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

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

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

Популярные направления авиакомпании

Описание

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

Специальные предложения

Описание

Параметры запроса

Пример запроса

Пример ответа

Поля ответа

Дешевые авиабилеты на неделю

Описание

Запрос

Параметры запроса

Пример запроса

Пример ответа

Поля ответа