Старая версия API доступа к данным (более не поддерживается)

Уважаемые партнеры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.

Для получения токена (token) к API доступа к данным зайдите на страницу http://www.travelpayouts.com/developers/api.

Самые дешёвые авиабилеты
Билеты без пересадок
Билеты за каждый день месяца
Популярные направления авиакомпании
Данные о странах, городах, аэропортах, авиакомпаниях, самолетах в JSON-формате

Для доступа к API вам необходимо передавать свой токен в заголовке X-Access-Token или параметром token.

Даты принимаются в форматах YYYY-MM и YYYY-MM-DD

Ответ от сервера всегда отдается в формате json и имеет следующую структуру:

success — принимает значения true для успешного запроса и false в случае ошибки

data — результат выполнения запроса, в случае ошибки будет иметь значение null

error — краткое описание ошибки, помешавшей выполнить запрос, в случае успешного запроса будет иметь значение null

Даты и время в UTC и отформатированы по стандарту ISO 8601. Цены указаны в рублях и актуальны на момент попадания билета в результаты поиска. Не рекомендуется использовать цены, срок актуальности которых истек (примерная дата указывается в значении параметра expires_at).

Важно!

Настоятельно рекомендуется получать данные сжатыми в gzip — это существенно сократит время получения ответа. Чтобы получить данные в сжатом виде, необходимо передать заголовок Accept-Encoding: gzip, deflate.

Для получения доступа к API поиска авиабилетов и отелей необходимо оставить заявку.

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

Уважаемые партнёры! Данная документации более не актуальна, в связи с изменением адреса API. Актуальная документация находится здесь.

http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices.json?{departure_at,return_at,currency,token} — возвращает самые дешевые билеты без пересадок, а также с 1 и 2 пересадками для выбранного направления с фильтрами по датам вылета и возвращения.

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

origin — IATA-код города вылета;
destination — IATA-код города назначения (укажите «-» для любых направлений);
departure_at(необязательно) — день или месяц вылета (yyyy-mm-dd или yyyy-mm);
return_at (необязательно) — день или месяц возвращения (yyyy-mm-dd или yyyy-mm);
currency — валюта ответа (USD, EUR, RUB);
token — индивидуальный токен доступа.

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

http://api.aviasales.ru/v1/cities/BER/directions/BCN/prices.json?departure_at=2014-03&return_at=2014-04&currency=USD

Обратите внимание! В запросе могут быть указаны старые даты. Тогда в результате его ошибки не будет, но и данных никаких не вернётся.

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

{
   "success": true,
   "data": {
      "BCN": {
         "0": {
            "price": 211,
            "airline": "U2",
            "flight_number": 4533,
            "departure_at": "2014-08-05T15:50:00Z",
            "return_at": "2014-08-21T15:10:00Z",
            "expires_at": "2014-03-02T15:59:09Z"
         },
         "1": {
            "price": 228,
            "airline": "9B",
            "flight_number": 3958,
            "departure_at": "2014-05-23T12:50:00Z",
            "return_at": "2014-05-28T17:10:00Z",
            "expires_at": "2014-03-02T16:56:35Z"
         },
         "2": {
            "price": 408,
            "airline": "KL",
            "flight_number": 3758,
            "departure_at": "2014-05-24T06:50:00Z",
            "return_at": "2014-05-28T08:50:00Z",
            "expires_at": "2014-03-02T12:56:35Z"
         }
      }
   },
   "error": null,"currency":"usd"
}

Описание ответа

0, 1, 2 — количество пересадок;
price — цена билета (в заданной валюте, параметр currency);
airline — IATA-код авиакомпании, выполняющей перелет;
flight_number — номер рейса;
departure_at — дата вылета;
return_at — дата возвращения;
expires_at — дата истечения актуальности найденной цены (UTC+0).

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

http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices/direct.json?{departure_at,return_at,currency,token} — возвращает самый дешёвый билет без пересадок для выбранного направления с фильтрами по датам вылета и возвращения.

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

origin — IATA-код города вылета;
destination — IATA-код города назначения (укажите «-» для любых направлений);
departure_at(не обязательно) — день или месяц вылета (yyyy-mm-dd или yyyy-mm);
return_at (не обязательно) — день или месяц возвращения (yyyy-mm-dd или yyyy-mm);
currency — валюта ответа (USD, EUR, RUB);
token — индивидуальный токен доступа.

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

http://api.aviasales.ru/v1/cities/BER/directions/PAR/prices/direct.json?departure_at=2014-10&return_at=2014-10&currency=USD

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

{
   "success": true,
   "data": {
      "PAR": {
         "0": {
            "price": 104,
            "airline": "AB",
            "flight_number": 8154,
            "departure_at": "2014-10-01T06:10:00Z",
            "return_at": "2014-10-06T10:25:00",
            "expires_at": "2014-03-06T18:10:19Z"
         }
      }
   },
   "error": null,"currency":"usd"
}

Описание ответа

price — цена билета (в заданной валюте);
airline — IATA-код авиакомпании, выполняющей перелет;
flight_number — номер рейса;
departure_at — дата вылета;
return_at — дата возвращения;
expires_at — дата истечения актуальности найденной цены (UTC+0).

Билеты за каждый день месяца

http://api.aviasales.ru/v1/cities/{origin}/directions/{destination}/prices/calendar.json?{departure_at,return_at,calendar_type,length,currency,token} — возвращает самые дешёвые билеты без пересадок, а также с 1 и 2 пересадками для выбранного направления для каждого дня выбранного месяца.

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

origin — IATA-код города вылета;
destination — IATA-код города назначения;
departure_at — день или месяц вылета (yyyy-mm-dd или yyyy-mm);
return_at (необязательно) — день или месяц возвращения (yyyy-mm-dd или yyyy-mm);
calendar_type — поле, по которому будет строиться календарь. Одно из двух значений: departure_date или return_date;
length (необязательно) — длительность пребывания в городе назначения;
currency — валюта ответа (USD, EUR, RUB);
token — индивидуальный токен доступа.

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

http://api.aviasales.ru/v1/cities/MOW/directions/BCN/prices/calendar.json?departure_at=2013-03&calendar_type=departure_date&length=20&currency=RUB

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

{
   "success": true,
   "data": {
      "2013-03-01": {
         "origin": "MOW",
         "destination": "BCN",
         "price": 19353,
         "transfers": 1,
         "airline": "LH",
         "flight_number": 1447,
         "departure_at": "2013-03-01T17:35:00Z",
         "return_at": "2013-03-21T15:50:00Z",
         "expires_at": "2013-03-02T10:46:48Z"
      },
      "2013-03-02": {
         "origin": "MOW",
         "destination": "BCN",
         "price": 16561,
         "transfers": 1,
         "airline": "TK",
         "flight_number": 418,
         "departure_at": "2013-03-02T17:40:00Z",
         "return_at": "2013-03-22T16:35:00Z",
         "expires_at": "2013-03-02T10:46:48Z"
      },
      ...
     "2013-03-31": {
         "origin": "MOW",
         "destination": "BCN",
         "price": 14691,
         "transfers": 1,
         "airline": "AY",
         "flight_number": 154,
         "departure_at": "2013-03-31T13:50:00Z",
         "return_at": "2013-04-20T12:05:00Z",
         "expires_at": "2013-03-02T16:48:53Z"
      }
   },
   "error": null,"currency":"rub"
}

Описание ответа

origin — IATA-код города вылета;
destination — IATA код города назначения;
price — цена билета в заданной валюте;
transfers — количество пересадок;
airline — IATA-код авиакомпании;
flight_number — номер рейса;
departure_at — дата вылета;
return_at — дата возвращения;
expires_at — срок истечения актуальности цены (UTC+0).

Данные о странах, городах, аэропортах, авиакомпаниях, самолётах в JSON-формате

Данные о странах

Запрос http://api.travelpayouts.com/data/countries.json возвращает файл со списком стран из базы данных.

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

[{
"code":"NC",
"name":"New Caledonia",
"currency":"XPF",
"name_translations":{
"de":"Neukaledonien",
"en":"New Caledonia",
"zh-CN":"新喀里多尼亚",
"tr":"Yeni Kaledonya",
"ru":"Новая Каледония",
"fr":"Nouvelle-Calédonie",
"es":"Nueva Caledonia",
"it":"Nuova Caledonia",
"th":"ประเทศนิวแคลิโดเนีย"
}},
{
"code":"MT",
"name":"Malta",
"currency":"EUR",
"name_translations":{
"de":"Malta",
"en":"Malta",
"zh-CN":"马耳他",
"tr":"Malta",
"ru":"Мальта",
"fr":"Malte",
"es":"Malta",
"it":"Malta",
"th":"ประเทศมอลตา"
}}
]

Описание ответа

code — IATA-код страны;
name — название страны;
currency — валюта страны;
name_translations — название страны на различных языках.

Данные о городах

Запрос http://api.travelpayouts.com/data/cities.json возвращает файл со списком городов из базы данных.

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

[{
"code":"SCE",
"name":"State College",
"coordinates":{
"lon":-77.84823,
"lat":40.85372
},
"time_zone":"America/New_York",
"name_translations":{
"de":"State College",
"en":"State College",
"zh-CN":"大学城",
"tr":"State College",
"ru":"Стейт Колледж",
"it":"State College",
"es":"State College",
"fr":"State College",
"th":"สเตทคอลเลจ"
},
"country_code":"US"
},
{
"code":"AAB",
"name":"Arrabury",
"coordinates":{
"lon":141.04167,
"lat":-26.7
},
"time_zone":"Australia/Brisbane",
"name_translations":{
"de":"Arrabury",
"en":"Arrabury",
"zh-CN":"阿拉伯里",
"ru":"Аррабури"
},
"country_code":"AU"
}]

Описание ответа

code — IATA-код города;
name — название города;
coordinates — координаты города;
time_zone — часовой пояс относительно гринвича;
name_translations — название города на разных языках;
country_code — IATA-код страны, в которой находится город.

Данные об аэропортах

Запрос http://api.travelpayouts.com/data/airports.json возвращает файл со списком аэропортов из базы данных.

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

[{
"code":"MQP",
"name":"Kruger Mpumalanga International Airport",
"coordinates":{
"lon":31.098131,
"lat":-25.384947
},
"time_zone":"Africa/Johannesburg",
"name_translations":{
"de":"Nelspruit",
"en":"Kruger Mpumalanga International Airport",
"tr":"International Airport",
"it":"Kruger Mpumalanga",
"fr":"Kruger Mpumalanga",
"es":"Kruger Mpumalanga",
"th":"สนามบินเนลสปรุต"
},
"country_code":"ZA",
"city_code":"NLP"
}]

Описание ответа

code — IATA-код аэропорта;
name — название аэропорта;
coordinates — координаты аэропорта;
time_zone — часовой пояс относительно гринвича;
name_translations — название аэропорта на разных языках;
country_code — IATA-код страны;
city_code — IATA-код города.

Данные об авиакомпаниях

Запрос http://api.travelpayouts.com/data/airlines.json возвращает файл со списком авиакомпаний из базы данных.

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

[{
"name":"Private flight",
"alias":null,
"iata":null,
"icao":null,
"callsign":null,
"country":null,
"is_active":true
},
{
"name":"135 Airways",
"alias":null,
"iata":null,
"icao":"GNL",
"callsign":"GENERAL",
"country":"United States",
"is_active":false
}]

Описание ответа

name — название авиакомпании;
alias — название альянса (если авиакомпания входит в какой-либо альянс);
iata — IATA-код авиакомпании;
icao — ICAO-код авиакомпании;
callsign — позывной авиакомпании;
country — страна регистрации авиакомпании;
is_active — true — компания работает, false — нет.

Данные об альянсах

Запрос http://api.travelpayouts.com/data/airlines_alliances.json возвращает файл со списком альянсов из базы данных.

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

[{
"name":"Star Alliance",
"airlines":["A3","AC","AV","CA","CM","ET","JJ","JP","KF","LH","LO","LX","MS","NH","NZ","OS","OU","OZ","PZ","SA","SK","SN","SQ","TA","TG","TK","TP","UA","US"]}]

Описание ответа

name — название альянса;
airlines — коды компаний, входящих в альянс.

Данные о самолетах

Запрос http://api.travelpayouts.com/data/planes.json возвращает файл со списком самолетов из базы данных.

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

[{
"code":"100",
"name":"Fokker 100"
},
{
"code":"141",
"name":"British Aerospace BAe 146-100"
},
{
"code":"142",
"name":"British Aerospace BAe 146-200"
},
{
"code":"143",
"name":"British Aerospace BAe 146-300"
}]

Описание ответа

code — IATA-код самолета;
name — название самолета.

Данные о маршрутах

Запрос http://api.travelpayouts.com/data/routes.json возвращает файл со списком маршрутов из базы данных.

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

[{
"airline_iata":"2B",
"airline_icao":null,
"departure_airport_iata":"AER",
"departure_airport_icao":null,
"arrival_airport_iata":"DME",
"arrival_airport_icao":null,
"codeshare":false,
"transfers":0,
"planes":[
"CR2"
]
},
{
"airline_iata":"2B",
"airline_icao":null,
"departure_airport_iata":"ASF",
"departure_airport_icao":null,
"arrival_airport_iata":"LED",
"arrival_airport_icao":null,
"codeshare":false,
"transfers":0,
"planes":[
"CR2"

Описание ответа

airline_iata — IATA-код авиакомпании;
airline_icao — ICAO-код авиакомпании;
departure_airport_iata — IATA-код аэропорта отправления;
departure_airport_icao — ICAO-код аэропорта отправления;
arrival_airport_iata — IATA-код аэропорта прибытия;
arrival_airport_icao — ICAO-код аэропорта прибытия;
codeshare — показывает, осуществляет ли рейс та же компания, что продает билет;
transfers — количество пересадок;
planes — IATA-код самолета.

Была ли эта статья полезной?

Еще есть вопросы? Отправить запрос

Старая версия API доступа к данным (более не поддерживается)

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

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

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

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

Описание ответа

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

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

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

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

Описание ответа

Билеты за каждый день месяца

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

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

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

Описание ответа

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

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

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

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

Описание ответа

Данные о странах, городах, аэропортах, авиакомпаниях, самолётах в JSON-формате

Данные о странах

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

Описание ответа

Данные о городах

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

Описание ответа

Данные об аэропортах

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

Описание ответа

Данные об авиакомпаниях

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

Описание ответа

Данные об альянсах

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

Описание ответа

Данные о самолетах

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

Описание ответа

Данные о маршрутах

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

Описание ответа

Похожие статьи