Google Flights Calendar API
Get the Google Flights price calendar for a route: the lowest fare for every departure date across a window of up to 120 days, one way or as a round trip of a fixed length, with the return date of each round trip, a flag on every date within 5% of the cheapest, and the cheapest date of the window, as normalized JSON. Choose cabin class, adults and currency. Prices are the total for all passengers; dates with no fare are left out.
Цены
Цена API Google Flights Calendar
Попробовать
Получите Google Flights Calendar одним запросом
{
"data": {
"adults": 42,
"cabinClass": "example",
"cheapestDepartureDate": "2024-01-15T09:30:00Z",
"cheapestPrice": 19.99,
"currency": "USD",
"dates": [
{
"departureDate": "2024-01-15T09:30:00Z",
"isLowPrice": true,
"price": 19.99,
"returnDate": "2024-01-15T09:30:00Z"
}
],
"departureDateFrom": "2024-01-15T09:30:00Z",
"departureDateTo": "2024-01-15T09:30:00Z",
"destination": "example",
"origin": "example",
"tripLengthDays": 180,
"tripType": "one_way"
},
"found": true,
"reason": "not_found"
}Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.
Справочник
Один запрос, один формат ответа.
Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.
Проверено 2026-11-07 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- departureDateFromstring
2026-12-07
First departure date of the calendar in YYYY-MM-DD format (e.g. 2027-01-12). Today or later.
- departureDateTostring
2027-01-05
Last departure date of the calendar in YYYY-MM-DD format (e.g. 2027-02-10). At most 120 days after departureDateFrom.
- destinationstring
LHR
Arrival airport as a three-letter IATA code in capitals (e.g. LHR), or a Google place ID for a city to cover all of its airports (e.g. /m/04jpl for London).
- originstring
JFK
Departure airport as a three-letter IATA code in capitals (e.g. JFK), or a Google place ID for a city to cover all of its airports (e.g. /m/02_286 for New York).
- adultsinteger
Number of adult passengers (1-9, default 1). Prices are for all passengers together. Child passengers cannot be priced on the calendar.
- cabinClassenum
Cabin class (default economy).
- currencystring
ISO 4217 currency code for prices (e.g. USD, EUR, GBP; default USD).
- tripLengthDaysinteger
For a round trip, the number of days between departure and return (1-30, e.g. 7): each date is then priced as a round trip returning that many days later. Omit it for one way.
Ответ
JSON, по одному примеру значения на поле.
The price calendar, or null when no date in the window has a fare.
- adultsinteger
Number of adult passengers the prices cover.
- cabinClassstring
Cabin class the calendar was priced in: economy, premium_economy, business or first.
- cheapestDepartureDatestring
Departure date with the lowest fare in the window, YYYY-MM-DD.
- cheapestPricenumber
Lowest fare in the window, for all passengers, in currency.
- currencystring
ISO 4217 currency code of every price.
- departureDateFromstring
First departure date of the window, YYYY-MM-DD.
- departureDateTostring
Last departure date of the window, YYYY-MM-DD.
- destinationstring
Arrival airport IATA code or city place ID the calendar was priced to.
- originstring
Departure airport IATA code or city place ID the calendar was priced from.
- tripLengthDaysinteger
Days between departure and return on a round trip; null on one way.
- tripType"one_way" | "round_trip"
one_way, or round_trip when a trip length was given.
One entry per departure date that has a fare, in date order. Dates with no fare are left out. Populated whenever the provider has data for the entity.
- departureDatestring
Departure date, YYYY-MM-DD.
- isLowPriceboolean
Whether this fare is within 5% of the cheapest fare in the window.
- pricenumber
Lowest fare departing on this date, the total for all passengers, in currency.
- returnDatestring
Return date of the round trip priced for this departure date, YYYY-MM-DD; null on one way.
- foundboolean
Whether any departure date in the window has a fare.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Вопросы и ответы
Об API Google Flights Calendar
AnyAPI Google Flights Calendar API возвращает данные Google Flights в виде нормализованного JSON одним вызовом POST к /v1/run/google_flights.calendar. Get the Google Flights price calendar for a route: the lowest fare for every departure date across a window of up to 120 days, one way or as a round trip of a fixed length, with the return date of each round trip, a flag on every date within 5% of the cheapest, and the cheapest date of the window, as normalized JSON. Choose cabin class, adults and currency. Prices are the total for all passengers; dates with no fare are left out. AnyAPI возвращает одну нормализованную схему, какой бы источник ни ответил. Это стоит от 0,85 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов Google Flights Calendar через AnyAPI завершились успешно, медианное время ответа 1,3 с, измерено вызовов: 1.