# Aviasales Data API (Travelpayouts): GET /aviasales/v3/grouped_prices — Самые дешёвые билеты с группировкой

Заменяет `/v1/prices/calendar` и `/v1/prices/monthly`.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `token` | query | string | да | API-токен |
| `origin` | query | string | нет | IATA-код вылета |
| `destination` | query | string | нет | IATA-код назначения |
| `group_by` | query | string | нет | departure_at (по умолчанию) или month |
| `departure_at` | query | string | нет | Дата вылета |
| `return_at` | query | string | нет | Дата возвращения |
| `direct` | query | boolean | нет | Только прямые |
| `min_trip_duration` | query | integer | нет | Минимальная длительность поездки, дней |
| `max_trip_duration` | query | integer | нет | Максимальная длительность поездки, дней |
| `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://mcp-everything.ru/integrations/travelpayouts-aviasales/scenarios/postroit-kalendar-tsen.md)

---

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