Aviasales Data API (Travelpayouts): GET /aviasales/v3/get_latest_prices — Цены за период

Параметр	Где	Тип	Обяз.	Описание
token	query	string	да	API-токен
origin	query	string	нет	IATA-код вылета
destination	query	string	нет	IATA-код назначения
period_type	query	string	нет	year, month или day; по умолчанию — текущий месяц
beginning_of_period	query	string	нет	Начало периода; обязателен при period_type=month
group_by	query	string	нет	dates (по умолчанию) или directions
one_way	query	boolean	нет	В одну сторону, по умолчанию true
sorting	query	string	нет	price, route, distance_unit_price
trip_duration	query	integer	нет	Длительность пребывания, дней
trip_class	query	integer	нет	0 — эконом, 1 — бизнес, 2 — первый
page	query	integer	нет	Страница, по умолчанию 1
currency	query	string	нет	Валюта
market	query	string	нет	Рынок данных

Базовые 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