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.
Pricing
Google Flights Calendar API pricing
Try it
Get Google Flights calendar in one request
{
"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"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-07 · uptime and latency measured over 30d
Request body
JSON, posted to this 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.
Response
JSON, one example value per field.
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
About the Google Flights Calendar API
The AnyAPI Google Flights Calendar API returns Google Flights calendar data as normalized JSON from one POST call to /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 returns one normalized schema whichever source serves it. It costs from $0.85 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Google Flights calendar calls through AnyAPI succeeded, with a median response time of 1.3 seconds across 1 measured calls.