# Google Flights Deals API

> Find discounted Google Flights fares from a departure airport, with destination, price, discount, dates and airline.

Source: https://www.sandbase.ai/apis/google-flights/deals
API reference: https://www.sandbase.ai/apis/google-flights/deals#api

## Facts

- Provider: Google Flights
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/google-flights/deals`
- Price: $0.01 per call
- Capabilities: api, google flights, travel, flights
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/google-flights/deals` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `departure_id` | string | no |  |
| `gl` | string | no |  |
| `hl` | string | no |  |
| `currency` | string | no |  |
| `query` | string | no |  |
| `type` | string | no |  |
| `travel_class` | string | no |  |
| `outbound_date` | string | no |  |
| `return_date` | string | no |  |
| `travel_duration` | string | no |  |
| `trip_length` | string | no |  |
| `adults` | string | no |  |
| `children` | string | no |  |
| `infants_in_seat` | string | no |  |
| `infants_on_lap` | string | no |  |
| `stops` | string | no |  |
| `exclude_airlines` | string | no |  |
| `include_airlines` | string | no |  |
| `max_price` | string | no |  |
| `max_duration` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Google Flights Deals API?

Send a POST request to https://api.sandbase.ai/v1/api/google-flights/deals with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Google Flights Deals API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Google Flights Deals API accept?

No parameters are required. Optional: departure_id (string), gl (string), hl (string), currency (string), query (string) and type (string) and 15 more. The Parameters table and the Playground on this page list every field.

### What does the Google Flights Deals API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Google Flights developer account or API key?

No. Google Flights Deals runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google Flights API access separately.

## README

### Google Flights Deals

Find discounted Google Flights fares from a departure airport, with destination, price, discount, dates and airline.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/google-flights/deals" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"departure_id": "AUS"}'
```

The result is returned in `outputs[0].data` as structured JSON.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `departure_id` | string | No | Parameter defines the departure airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it using our Google Flights Autocomplete API or IATA. For example, `CDG` is Paris Charles de Gaulle Airport an |
| `gl` | string | No | Parameter defines the country to use for the Google Flights Deals search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France) Head to the Google countries page for a full list of s |
| `hl` | string | No | Parameter defines the language to use for the Google Flights Deals search. It's a two or three-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French), optionally followed by a two-letter or three-digit region c |
| `currency` | string | No | Parameter defines the currency of the returned prices. Default to `USD`. Head to the Google Travel Currencies page for a full list of supported currency codes. |
| `query` | string | No | Parameter defines the natural language query for Google Flights Deals. e.g. `High rises`, `beach vacation next month`. Cannot be combined with `travel_duration` or `trip_length`. Describe the trip duration in `query` instead. |
| `type` | string | No | Parameter defines the type of the flights. Available options: `1` - Round trip (default) `2` - One way |
| `travel_class` | string | No | Parameter defines the travel class. Available options: `1` - Economy (default) `2` - Premium economy `3` - Business `4` - First |
| `outbound_date` | string | No | Parameter defines when you want to depart. Use a single YYYY-MM-DD date for an exact departure date, or two comma-separated dates for a flexible departure window. Examples: `2026-11-13` — depart on this exact date `2026-11-13,2026-12-12` —  |
| `return_date` | string | No | Parameter defines when you want to return. Use a single YYYY-MM-DD date for an exact return date, or two comma-separated dates for a flexible return window. Examples: `2026-11-19` — return on this exact date (use with a single `outbound_dat |
| `travel_duration` | string | No | Parameter defines a preset trip duration when searching with flexible dates. Available options: `1` - 1 week (default) `2` - Weekend `3` - 2 weeks Can be used alone (deals of this duration, any departure date) or with `outbound_date` as a d |
| `trip_length` | string | No | Parameter defines a custom trip length in days when searching with flexible dates. Provide a single number for an exact duration, or two comma-separated numbers for a min/max range. Examples: `7` — exactly 7 days `5,10` — between 5 and 10 d |
| `adults` | string | No | Parameter defines the number of adults. Default to 1. |
| `children` | string | No | Parameter defines the number of children. Default to 0. |
| `infants_in_seat` | string | No | Parameter defines the number of infants in seat. Default to 0. |
| `infants_on_lap` | string | No | Parameter defines the number of infants on lap. Default to 0. |
| `stops` | string | No | Parameter defines the number of stops during the flight. Available options: `0` - Any number of stops (default) `1` - Nonstop only `2` - 1 stop or fewer `3` - 2 stops or fewer |
| `exclude_airlines` | string | No | Parameter defines the airline codes to be excluded. Split multiple airlines with comma. It can't be used together with `include_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one |
| `include_airlines` | string | No | Parameter defines the airline codes to be included. Split multiple airlines with comma. It can't be used together with `exclude_airlines`. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one |
| `max_price` | string | No | Parameter defines the maximum ticket price. Default to unlimited. |
| `max_duration` | string | No | Parameter defines the maximum flight duration, in minutes. For example, specify `1500` for 25 hours. If your search returns no results, try increasing your `max_duration` by up to `200` minutes to account for route-specific scheduling varia |
| `json_restrictor` | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |

#### Pricing

$0.010 per successful call. Failed calls are not charged.