{"name":"Aviasales Data API (Travelpayouts)","vendor":"Travelpayouts / Aviasales","industry":"travel","summary":"Публичный API данных Aviasales для партнёров Travelpayouts: цены на авиабилеты из кэша поисков пользователей Aviasales — самые дешёвые билеты на даты, календари цен на месяц и неделю, альтернативные направления, популярные направления, спецпредложения, поиск по диапазону цен. Данные хранятся в кэше 7 дней, поэтому API рекомендуется для статических страниц, а не для живого поиска.","docsUrl":"https://support.travelpayouts.com/hc/en-us/articles/203956163","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"pokazat-deshevye-bilety-po-napravleniyu","title":"Показать дешёвые билеты по направлению","summary":"Блок «Билеты Москва — Сочи от …» на странице направления или в статье: самые дешёвые варианты на нужный месяц.","steps":["Возьми API-токен в профиле Travelpayouts и передавай его в заголовке X-Access-Token (или параметром token).","Запроси билеты: GET /aviasales/v3/prices_for_dates с origin и destination (IATA-коды), departure_at (YYYY-MM или YYYY-MM-DD), для туда-обратно — return_at и one_way = false. Только прямые — direct = true.","В data[] для каждого билета: price, airline, flight_number, departure_at, return_at, transfers, duration и link — путь к билету на Aviasales, его дополняют до полного адреса сайта.","Цены берутся из кэша поисков пользователей за последние 48 часов: показывай их как «цены от», а не как гарантированные, и обновляй блок регулярно.","Проверяй success в ответе: при ошибке data пустой, а текст — в error."],"code":"curl -G \"https://api.travelpayouts.com/aviasales/v3/prices_for_dates\" \\\n  -H \"X-Access-Token: $TP_TOKEN\" -H 'Accept-Encoding: gzip, deflate' --compressed \\\n  -d origin=MOW -d destination=AER -d departure_at=2026-12 \\\n  -d one_way=true -d direct=false -d sorting=price -d currency=rub -d limit=10","language":"bash","methods":["GET /aviasales/v3/prices_for_dates"]},{"id":"postroit-kalendar-tsen","title":"Построить календарь цен","summary":"Календарь «самая низкая цена на каждый день» — чтобы пользователь сразу видел дешёвые даты.","steps":["Запроси минимальные цены с группировкой по дням: GET /aviasales/v3/grouped_prices с origin, destination, departure_at (месяц) и group_by = departure_at. Для обзора по месяцам — group_by = month.","В data — объект, где ключ — дата (или месяц), значение — самый дешёвый билет на неё. Пустые дни в кэше просто отсутствуют — так и показывай их в календаре.","Для поездок туда-обратно ограничь длительность: min_trip_duration и max_trip_duration в днях.","Цены на соседние даты вокруг выбранных (3 дня до и 4 после) отдаёт GET /v2/prices/week-matrix с depart_date и return_date."],"code":"curl -G \"https://api.travelpayouts.com/aviasales/v3/grouped_prices\" \\\n  -H \"X-Access-Token: $TP_TOKEN\" --compressed \\\n  -d origin=LED -d destination=KZN -d departure_at=2026-12 -d group_by=departure_at -d currency=rub","language":"bash","methods":["GET /aviasales/v3/grouped_prices","GET /v2/prices/week-matrix"]},{"id":"podobrat-kuda-deshevo-uletet-iz-goroda","title":"Подобрать, куда дёшево улететь из города","summary":"Подборка «Куда полететь из Екатеринбурга» — направления с самыми низкими ценами.","steps":["Запроси билеты только с городом вылета: GET /aviasales/v3/prices_for_dates с origin, departure_at, unique = true (по одному билету на направление) и sorting = price.","Для акцентов добавь аномально дешёвые предложения: GET /aviasales/v3/get_special_offers с origin и currency.","Если направление задано, а даты гибкие, подскажи соседние аэропорты: GET /v2/prices/nearest-places-matrix с origin, destination, flexibility (0–7 дней) и distance (число вариантов).","Названия городов по IATA-кодам храни у себя: API возвращает только коды."],"code":"curl -G \"https://api.travelpayouts.com/aviasales/v3/prices_for_dates\" \\\n  -H \"X-Access-Token: $TP_TOKEN\" --compressed \\\n  -d origin=SVX -d departure_at=2026-12 -d unique=true -d sorting=price -d limit=20 -d currency=rub\n\ncurl -G \"https://api.travelpayouts.com/aviasales/v3/get_special_offers\" \\\n  -H \"X-Access-Token: $TP_TOKEN\" --compressed -d origin=SVX -d currency=rub","language":"bash","methods":["GET /aviasales/v3/prices_for_dates","GET /v2/prices/nearest-places-matrix","GET /aviasales/v3/get_special_offers"]},{"id":"nayti-bilety-v-ramkah-byudzheta","title":"Найти билеты в рамках бюджета","summary":"Фильтр «до 10 000 ₽» для подборок и рассылок.","steps":["Запроси билеты в диапазоне цен: GET /aviasales/v3/search_by_price_range с origin, destination (или «-» — все направления), value_min и value_max.","Ограничь выдачу: one_way, direct, limit и page для постраничного вывода.","Сверяй актуальность по сроку из ответа и не показывай устаревшие цены: данные в кэше хранятся до 7 дней."],"code":"curl -G \"https://api.travelpayouts.com/aviasales/v3/search_by_price_range\" \\\n  -H \"X-Access-Token: $TP_TOKEN\" --compressed \\\n  -d origin=MOW -d destination=- -d value_min=3000 -d value_max=10000 \\\n  -d one_way=true -d direct=false -d limit=30 -d page=1 -d currency=rub","language":"bash","methods":["GET /aviasales/v3/search_by_price_range"]}],"baseUrls":[{"label":"Боевой","url":"https://api.travelpayouts.com"}],"auth":{"type":"api_key","description":"API-токен из профиля Travelpayouts (раздел «API-токен») передаётся в заголовке `X-Access-Token` или в параметре `token`.","example":"https://api.travelpayouts.com/aviasales/v3/prices_for_dates?origin=MAD&destination=BCN&departure_at=2023-07&return_at=2023-08&unique=false&sorting=price&direct=false&cy=usd&limit=30&page=1&one_way=true&token=PutYourTokenHere"},"methods":[{"id":"GET /aviasales/v3/prices_for_dates","title":"Билеты на конкретные даты","httpMethod":"GET","path":"/aviasales/v3/prices_for_dates","description":"Самые дешёвые билеты на даты, найденные за последние 48 часов. Заменяет `/v1/city-directions`, `/v1/prices/cheap`, `/v1/prices/direct`, `/v2/prices/latest`.\n\nВ ответе для каждого билета: `origin`, `destination`, `price`, `airline`, `flight_number`, `departure_at`, `return_at`, `transfers`, `duration`, `link`. Ссылку `link` добавляют к `https://www.aviasales.com/`.","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен (или заголовок X-Access-Token)"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код города или аэропорта вылета"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код назначения; обязателен, если нет origin"},{"name":"departure_at","in":"query","type":"string","required":false,"description":"Дата вылета YYYY-MM или YYYY-MM-DD"},{"name":"return_at","in":"query","type":"string","required":false,"description":"Дата возвращения; для билетов в одну сторону не указывать"},{"name":"one_way","in":"query","type":"boolean","required":false,"description":"В одну сторону, по умолчанию true"},{"name":"direct","in":"query","type":"boolean","required":false,"description":"Только прямые, по умолчанию false"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта, по умолчанию RUB"},{"name":"market","in":"query","type":"string","required":false,"description":"Рынок данных, по умолчанию ru"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Записей на странице, по умолчанию 30, максимум 1000"},{"name":"page","in":"query","type":"integer","required":false,"description":"Номер страницы"},{"name":"sorting","in":"query","type":"string","required":false,"description":"price (по умолчанию) или route (популярность)"},{"name":"unique","in":"query","type":"boolean","required":false,"description":"Только уникальные направления, если указан лишь origin"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /aviasales/v3/grouped_prices","title":"Самые дешёвые билеты с группировкой","httpMethod":"GET","path":"/aviasales/v3/grouped_prices","description":"Заменяет `/v1/prices/calendar` и `/v1/prices/monthly`.","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код вылета"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код назначения"},{"name":"group_by","in":"query","type":"string","required":false,"description":"departure_at (по умолчанию) или month"},{"name":"departure_at","in":"query","type":"string","required":false,"description":"Дата вылета"},{"name":"return_at","in":"query","type":"string","required":false,"description":"Дата возвращения"},{"name":"direct","in":"query","type":"boolean","required":false,"description":"Только прямые"},{"name":"min_trip_duration","in":"query","type":"integer","required":false,"description":"Минимальная длительность поездки, дней"},{"name":"max_trip_duration","in":"query","type":"integer","required":false,"description":"Максимальная длительность поездки, дней"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"},{"name":"market","in":"query","type":"string","required":false,"description":"Рынок данных"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /aviasales/v3/get_latest_prices","title":"Цены за период","httpMethod":"GET","path":"/aviasales/v3/get_latest_prices","description":"","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код вылета"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код назначения"},{"name":"period_type","in":"query","type":"string","required":false,"description":"year, month или day; по умолчанию — текущий месяц"},{"name":"beginning_of_period","in":"query","type":"string","required":false,"description":"Начало периода; обязателен при period_type=month"},{"name":"group_by","in":"query","type":"string","required":false,"description":"dates (по умолчанию) или directions"},{"name":"one_way","in":"query","type":"boolean","required":false,"description":"В одну сторону, по умолчанию true"},{"name":"sorting","in":"query","type":"string","required":false,"description":"price, route, distance_unit_price"},{"name":"trip_duration","in":"query","type":"integer","required":false,"description":"Длительность пребывания, дней"},{"name":"trip_class","in":"query","type":"integer","required":false,"description":"0 — эконом, 1 — бизнес, 2 — первый"},{"name":"page","in":"query","type":"integer","required":false,"description":"Страница, по умолчанию 1"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"},{"name":"market","in":"query","type":"string","required":false,"description":"Рынок данных"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /v2/prices/month-matrix","title":"Календарь цен на месяц","httpMethod":"GET","path":"/v2/prices/month-matrix","description":"","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код города или страны вылета, 2–3 символа"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код города или страны назначения"},{"name":"month","in":"query","type":"string","required":false,"description":"Начало месяца YYYY-MM-DD"},{"name":"show_to_affiliates","in":"query","type":"boolean","required":false,"description":"true — только цены по партнёрскому маркеру (по умолчанию)"},{"name":"trip_duration","in":"query","type":"integer","required":false,"description":"Длительность пребывания, недель"},{"name":"one_way","in":"query","type":"boolean","required":false,"description":"В одну сторону, по умолчанию true"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Дней в месяце, по умолчанию 30 (для 31 дня — 31)"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"},{"name":"market","in":"query","type":"string","required":false,"description":"Рынок данных"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /v2/prices/week-matrix","title":"Календарь цен на неделю","httpMethod":"GET","path":"/v2/prices/week-matrix","description":"Цены на 7 дней вокруг дат: от 3 дней до и до 4 дней после.","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код вылета"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код назначения"},{"name":"depart_date","in":"query","type":"string","required":false,"description":"День или месяц вылета"},{"name":"return_date","in":"query","type":"string","required":false,"description":"День или месяц возвращения"},{"name":"show_to_affiliates","in":"query","type":"boolean","required":false,"description":"Только цены по партнёрскому маркеру"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"},{"name":"market","in":"query","type":"string","required":false,"description":"Рынок данных"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /v2/prices/nearest-places-matrix","title":"Цены по альтернативным направлениям","httpMethod":"GET","path":"/v2/prices/nearest-places-matrix","description":"","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код вылета"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код назначения"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Число вариантов, 1–20"},{"name":"depart_date","in":"query","type":"string","required":false,"description":"Месяц вылета yyyy-mm"},{"name":"return_date","in":"query","type":"string","required":false,"description":"Месяц возвращения yyyy-mm"},{"name":"flexibility","in":"query","type":"integer","required":false,"description":"Расширение диапазона дат, 0–7 дней"},{"name":"distance","in":"query","type":"integer","required":false,"description":"Число вариантов, 1–20"},{"name":"show_to_affiliates","in":"query","type":"boolean","required":false,"description":"Только цены по партнёрскому маркеру"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /aviasales/v3/get_popular_directions","title":"Дешёвые билеты в популярные направления","httpMethod":"GET","path":"/aviasales/v3/get_popular_directions","description":"","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код города назначения"},{"name":"locale","in":"query","type":"string","required":false,"description":"Язык результатов"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"},{"name":"limit","in":"query","type":"integer","required":false,"description":"1–30"},{"name":"page","in":"query","type":"integer","required":false,"description":"Номер страницы"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /aviasales/v3/get_special_offers","title":"Спецпредложения","httpMethod":"GET","path":"/aviasales/v3/get_special_offers","description":"Аномально низкие цены на выбранные направления. Если `origin` не указан, определяется по IP.","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код вылета"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код назначения"},{"name":"airline","in":"query","type":"string","required":false,"description":"IATA-код авиакомпании"},{"name":"locale","in":"query","type":"string","required":false,"description":"Язык"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"},{"name":"market","in":"query","type":"string","required":false,"description":"Рынок данных"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /aviasales/v3/search_by_price_range","title":"Поиск билетов по диапазону цен","httpMethod":"GET","path":"/aviasales/v3/search_by_price_range","description":"","params":[{"name":"token","in":"query","type":"string","required":true,"description":"API-токен"},{"name":"origin","in":"query","type":"string","required":false,"description":"IATA-код вылета"},{"name":"destination","in":"query","type":"string","required":false,"description":"IATA-код назначения (- — все)"},{"name":"value_min","in":"query","type":"number","required":false,"description":"Минимальная цена"},{"name":"value_max","in":"query","type":"number","required":false,"description":"Максимальная цена"},{"name":"one_way","in":"query","type":"boolean","required":false,"description":"В одну сторону"},{"name":"direct","in":"query","type":"boolean","required":false,"description":"Только прямые, по умолчанию false"},{"name":"locale","in":"query","type":"string","required":false,"description":"Язык"},{"name":"currency","in":"query","type":"string","required":false,"description":"Валюта"},{"name":"market","in":"query","type":"string","required":false,"description":"Рынок данных"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Записей на странице"},{"name":"page","in":"query","type":"integer","required":false,"description":"Номер страницы"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[],"limits":"- Данные в кэше хранятся 7 дней.\n- `prices_for_dates` — до 1000 записей на странице.\n- `/v1/prices/calendar` — не больше 10 запросов в секунду; общие лимиты — в статье «API rate limits».","gotchas":["Ответ: `success` (`true`/`false`), `data` (при ошибке — `{}`), `error` (`null` при успехе).","Даты — `YYYY-MM` или `YYYY-MM-DD`; время в ответах — UTC, ISO 8601. Цены по умолчанию — в рублях.","Не используйте устаревшие цены: ориентир срока — поле `expires_at`.","Рынок (`market`) по умолчанию определяется по месту вылета, иначе — `ru`; данные разных рынков не пересекаются.","Рекомендуется получать ответы в gzip: заголовок `Accept-Encoding: gzip, deflate`.","Логотипы авиакомпаний: `http://pics.avs.io/{width}/{height}/{iata}.png`.","Устаревшие методы `/v1/prices/cheap`, `/v1/prices/direct`, `/v1/prices/calendar`, `/v1/city-directions`, `/v1/airline-directions` заменяются `prices_for_dates` и `grouped_prices`."],"slug":"travelpayouts-aviasales","version":2,"updatedAt":"2026-10-24T17:05:38.088Z","sources":[{"title":"Aviasales Data API","url":"https://support.travelpayouts.com/hc/en-us/articles/203956163","kind":"research","addedAt":"2026-10-17T07:11:14.431Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-17T07:11:14.431Z"},{"title":"scenarios-travelpayouts-aviasales.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:28.007Z"}],"logoUrl":null}