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.
Tarifs
Tarifs de l’API Google Flights Calendar
Essayer
Obtenez Google Flights Calendar en une requête
{
"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"
}Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.
Référence
Une requête, une seule forme de réponse.
Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.
Dernière vérification : 2026-11-07 · disponibilité et latence mesurées sur 30d
Corps de la requête
JSON, envoyé à cet 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.
Réponse
JSON, une valeur d’exemple par champ.
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.
FAQ
À propos de l’API Google Flights Calendar
L’API Google Flights Calendar d’AnyAPI renvoie des données Google Flights en JSON normalisé à partir d’un appel 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 renvoie un schéma normalisé unique quelle que soit la source qui répond. Elle coûte à partir de 0,85 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels Google Flights Calendar passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,3 secondes, sur 1 appels mesurés.