Aviasales Data API (Travelpayouts): GET /aviasales/v3/search_by_price_range — Поиск билетов по диапазону цен

Параметр	Где	Тип	Обяз.	Описание
token	query	string	да	API-токен
origin	query	string	нет	IATA-код вылета
destination	query	string	нет	IATA-код назначения (- — все)
value_min	query	number	нет	Минимальная цена
value_max	query	number	нет	Максимальная цена
one_way	query	boolean	нет	В одну сторону
direct	query	boolean	нет	Только прямые, по умолчанию false
locale	query	string	нет	Язык
currency	query	string	нет	Валюта
market	query	string	нет	Рынок данных
limit	query	integer	нет	Записей на странице
page	query	integer	нет	Номер страницы

Базовые URL

• Боевой: https://api.travelpayouts.com

Авторизация

Тип: API-ключ

API-токен из профиля Travelpayouts (раздел «API-токен») передаётся в заголовке X-Access-Token или в параметре token.

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

Нюансы

• Ответ: 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.

Сценарии с этим методом

• Найти билеты в рамках бюджета

---

Если этого недостаточно — официальная документация: https://support.travelpayouts.com/hc/en-us/articles/203956163 Вся интеграция одним документом: https://mcp-everything.ru/integrations/travelpayouts-aviasales.md