API para 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.
Preços
Preços do endpoint Calendar da API para Google Flights
Teste
Obtenha Calendar do Google Flights em uma só requisição
{
"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"
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-11-07 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para este endpoint.
- 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.
Resposta
JSON, um valor de exemplo por campo.
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.
Dúvidas frequentes
Sobre o endpoint Calendar da API para Google Flights
O endpoint Calendar da AnyAPI para Google Flights retorna dados de Google Flights em JSON normalizado com uma chamada POST para /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. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 0,85 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Calendar da API para Google Flights feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,3 segundos, em 1 chamadas medidas.