Aviasales Data API (Travelpayouts): GET /aviasales/v3/get_special_offers — Спецпредложения

Аномально низкие цены на выбранные направления. Если origin не указан, определяется по IP.

Параметр	Где	Тип	Обяз.	Описание
token	query	string	да	API-токен
origin	query	string	нет	IATA-код вылета
destination	query	string	нет	IATA-код назначения
airline	query	string	нет	IATA-код авиакомпании
locale	query	string	нет	Язык
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