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

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

 

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

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

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

 

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

 

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

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

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

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

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).

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

 

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

 

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

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

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

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

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).

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

 

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

 

http://api.aviasales.ru/v1/airlines/{airline}/directions.json?{limit,token} — возвращает направления, по которым авиакомпания осуществляет перелёты, отсортированные по популярности.

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

  • airline — IATA-код авиакомпании;
  • limit (необязательно) — количество маршрутов (по умолчанию 100);
  • token — индивидуальный токен доступа.

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

http://api.aviasales.ru/v1/airlines/KL/directions.json?limit=10

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

{
   "success": true,
   "data": {
      "MOW-BKK": 187491,
      "MOW-BCN": 113764,
      "MOW-PAR": 91889,
      "MOW-NYC": 77417,
      "MOW-PRG": 71449,
      "MOW-ROM": 67190,
      "MOW-TLV": 62132,
      "MOW-HKT": 58549,
      "MOW-GOI": 47341,
      "MOW-IST": 45553
   },
   "error": null
}

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

Возвращает список популярных направлений авиакомпании, отсортированный по популярности, количество направлений — не более заданного лимита (limit).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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