Get the flight deals Google Flights shows for one departure city: destination, price, typical price, discount, dates, airline and stops. One request returns up to 30 deals.
What You Get
- Destination with city, country, airport code, kgmid, image and a short description
- Price and typical price with the discount in percent
- Dates and trip length chosen by Google, with a link to the matching Google Flights search
- Airline and stops with duration in minutes
Good to Know
- Google picks the dates itself (a window of about four months). You cannot set dates.
arrival_areakeeps only deals whose country, city, airport code or kgmid matches. It filters the returned deals. When nothing matches,dealsis empty. Other deals are never returned.- For a city with several airports, send the city kgmid as
departure_id. - Use Explore Destinations to browse the whole destination map.
- Cost: 1 credit per successful request. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Departure airport IATA code or place kgmid.
Examples: JFK, /m/02_286
1234567890
string
Optional
Optional filter. One or more comma separated values that must match the deal country, city, airport code or kgmid.
Examples: France, CDG,LHR
example
string
Optional
1 = economy (default), 2 = premium economy, 3 = business, 4 = first.
example
string
Optional
3-letter currency code. Default: USD
USD
string
Optional
2-letter country code the deals are pinned to. Default: us
us
string
Optional
Language code. Default: en
en
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
deals
search_metadata
search_parameters
Common deals fields
name
image
kgmid
price
{
"deals": [
{
"name": "San Francisco",
"image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQvBtqVGhUcQZQZVRs-DfQPplFKXalxpJTP4W6pY1a2jwylcbMq3xgElPowNymK0FbQBTbBLQ",
"kgmid": "/m/0d6lp",
"price": 418,
"stops": 1,
"origin": "JFK",
"country": "United States",
"airlines": [
{
"code": "B6",
"name": "JetBlue"
}
],
"currency": "USD",
"trip_days": 6,
"highlights": [
"Golden Gate Bridge, cable cars & fog"
],
"description": "Hilly bayside city known for the Golden Gate Bridge, year-round fog, cable cars & Victorian homes.",
"return_date": "2026-12-12",
"airport_code": "SFO",
"outbound_date": "2026-12-06",
"typical_price": 583,
"discount_percent": 28,
"duration_minutes": 636,
"google_flights_url": "https://www.google.com/travel/flights?tfs=CCoQAhoj...&curr=USD&hl=en&gl=US&gsas=1"
}
],
"search_metadata": {
"engine": "google_flights_deals",
"status": "Success",
"total_deals": 1
},
"search_parameters": {
"gl": "us",
"hl": "en",
"currency": "USD",
"arrival_area": null,
"departure_id": "JFK",
"travel_class": 1
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
departure_id is required and must be a 3-letter IATA code or a place kgmid. travel_class, currency, gl and hl must be valid when provided.
{
"errors": {
"departure_id": [
"A departure airport or place is required."
]
},
"message": "A departure airport or place is required."
}Google Flights Deals Temporarily Unavailable
The upstream lookup failed on every try. The request is not billed.
{
"error": "Google Travel data is temporarily unavailable. Please retry shortly.",
"error_code": "google_flights_deals_temporarily_unavailable",
"status_code": 503
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.