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.
价格
Google Flights Calendar API 价格
试一试
一个请求获取 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，POST 到这个接口。
- 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.
常见问题
关于 Google Flights Calendar API
AnyAPI 的 Google Flights Calendar API 只需一次 POST 请求 /v1/run/google_flights.calendar，就以统一格式的 JSON 返回 Google Flights 数据。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 都返回同一套统一的 schema。费用：每千次请求 US$0.85 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Google Flights Calendar API 调用中有 100.0% 成功，响应时间中位数为 1.3 秒，共测量 1 次调用。