Name: Google Flights Live API: real-time fares
Brand: flightpowers
SKU: api-flightpowers-google-flights
Availability: InStock
Author: API Market

Matan Rabi

# Google Flights Live API

## Overview

The Google Flights Live API searches Google Flights at request time and returns live fares as flat JSON. Two endpoints cover one-way and round-trip searches: send the origin and destination airport codes and the dates, and each itinerary comes back with its price, airline, stops and layovers, duration, departure and arrival times and a booking link. A round trip is a single request, with both legs paired and one total price.

It is built for travel apps and meta-search sites, fare alert and price tracking tools, corporate travel teams and AI travel agents. Standard searches also carry Google's own price verdict for the route and date (`low`, `typical` or `high`, with the usual price band), so an app can tell a traveller whether a fare is a good one, and filters cover stops, airlines, departure and arrival times, cabin class, passengers, currency and a maximum price.

## Features

*   **2 endpoints**: one-way search and round-trip search.
*   **Live fares**: every search is read from Google Flights at request time.
*   **Paired round trips**: both legs, one total price, one duration and one booking link per itinerary.
*   **Price verdict**: `price_insights_low`, `price_insights_high` and `price_range_in_relation_to_other_periods`.
*   **Filters**: stops, airlines to include or exclude, time windows, cabin class, passengers, currency and maximum price.
*   **Rate limit**: 1 request per second on the Free plan, up to 9 on MEGA.

## Use Cases

*   **Travel apps**: show live fares and booking links for a route.
*   **Fare alerts**: watch a route and notify users when the price drops.
*   **Flexible date search**: scan several dates and durations to build a cheapest-day calendar.
*   **AI travel agents**: answer flight questions with real prices.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/flightpowers/google-flights
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Flights one-way search

Live one-way fares from Google Flights for one route and one date.

**Method:** `POST`

**Endpoint:** `/v1/flights/oneway`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| from_airport | body | IATA airport code, e.g. JFK, LHR, BCN | string | Yes | - | 3 |
| to_airport | body | IATA airport code, e.g. JFK, LHR, BCN | string | Yes | - | 3 |
| departure_date | body | Departure date (YYYY-MM-DD, must be in the future) | string | Yes | - | - |
| max_stops | body | Maximum stops (0 = nonstop) | integer | No | - | - |
| airline_codes | body | Only these airlines (IATA codes) | array of string | No | - | - |
| exclude_airline_codes | body | Exclude these airlines (IATA codes) | array of string | No | - | - |
| departure_time_min | body | Earliest departure (hour of day, 0 to 23) | integer | No | - | 23 |
| departure_time_max | body | Latest departure (hour of day, 0 to 23) | integer | No | - | 23 |
| arrival_time_min | body | Earliest arrival (hour of day, 0 to 23) | integer | No | - | 23 |
| arrival_time_max | body | Latest arrival (hour of day, 0 to 23) | integer | No | - | 23 |
| sort_type | body | Google Flights sort. Price insights (low/typical/high) are not returned with Price. | string | No | Overall | - |
| currency | body | Currency code, e.g. USD, EUR | string | No | USD | - |
| max_price | body | Upper price limit. Note: with max_price the price insights come back null. | number | No | - | - |
| seat_type | body | 1 economy, 2 premium economy, 3 business, 4 first | integer | No | - | - |
| passengers | body | One entry per traveller: 1 adult, 2 child, 3 infant on lap, 4 infant in seat. Default one adult. | array of integer | No | - | - |
| limit | body | Maximum number of results | integer | No | 10 | - |
| use_ext_proxy | body | Residential routing (default true); false can be faster on easy routes | boolean | No | true | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/flightpowers/google-flights/v1/flights/oneway' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"from_airport": "LHR", "to_airport": "BCN", "departure_date": "2027-06-15", "limit": 5}'
```

**Example Response (200 OK, trimmed):**

Long lists are cut to their first items and long text is shortened.

```json
[
  {
    "price_range_in_relation_to_other_periods": "typical",
    "price_insights_low": 55,
    "price_insights_high": 130,
    "from_airport": "London (LHR)",
    "to_airport": "Barcelona (BCN)",
    "departure_date": "2027-06-15",
    "price": "$59",
    "price_as_number": 59,
    "duration": "2 hr 20 min",
    "duration_seconds": 8400,
    "buy_link": "https://www.google.com/travel/flights?tfs=GjwSCjIwMjctMDYtMTUiIAoDTEhSEgoyMDI3LTA2LTE1GgNCQ04qAlZZMgQ3NjQzagUSA0xIUnIFEgNCQ05CAQFIAZgBAg&curr=usd",
    "airline": "Vueling | Iberia, British Airways",
    "stops": 0,
    "stops_info": [],
    "departure_description": "8:50 PM on Tue, Jun 15",
    "arrival_description": "12:10 AM on Wed, Jun 16"
  },
  {
    "price_range_in_relation_to_other_periods": "typical",
    "price_insights_low": 55,
    "price_insights_high": 130,
    "from_airport": "London (LHR)",
    "to_airport": "Barcelona (BCN)",
    "departure_date": "2027-06-15",
    "price": "$66",
    "price_as_number": 66,
    "duration": "2 hr 20 min",
    "duration_seconds": 8400,
    "buy_link": "https://www.google.com/travel/flights?tfs=GjwSCjIwMjctMDYtMTUiIAoDTEhSEgoyMDI3LTA2LTE1GgNCQ04qAlZZMgQ3NjQxagUSA0xIUnIFEgNCQ05CAQFIAZgBAg&curr=usd",
    "airline": "Vueling | Iberia, British Airways",
    "stops": 0,
    "stops_info": [],
    "departure_description": "9:55 AM on Tue, Jun 15",
    "arrival_description": "1:15 PM on Tue, Jun 15"
  }
]
```

#### 2. Flights round-trip search

Live round-trip fares: both legs priced together in one request, one total and one booking link per itinerary.

**Method:** `POST`

**Endpoint:** `/v1/flights/roundtrip`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| from_airport | body | IATA airport code, e.g. JFK, LHR, BCN | string | Yes | - | 3 |
| to_airport | body | IATA airport code, e.g. JFK, LHR, BCN | string | Yes | - | 3 |
| departure_date | body | Outbound date (YYYY-MM-DD, must be in the future) | string | Yes | - | - |
| return_date | body | Return date (YYYY-MM-DD, must be in the future) | string | Yes | - | - |
| max_stops | body | Shortcut for both legs; a per-leg field wins | integer | No | - | - |
| max_departure_stops | body | - | integer | No | - | - |
| max_return_stops | body | - | integer | No | - | - |
| departure_airline_codes | body | Outbound: only these airlines | array of string | No | - | - |
| return_airline_codes | body | Return: only these airlines | array of string | No | - | - |
| departure_exclude_airline_codes | body | Outbound: exclude these airlines | array of string | No | - | - |
| return_exclude_airline_codes | body | Return: exclude these airlines | array of string | No | - | - |
| departure_departure_time_min | body | Departure leg, departure time min (hour of day, 0 to 23) | integer | No | - | 23 |
| departure_departure_time_max | body | Departure leg, departure time max (hour of day, 0 to 23) | integer | No | - | 23 |
| departure_arrival_time_min | body | Departure leg, arrival time min (hour of day, 0 to 23) | integer | No | - | 23 |
| departure_arrival_time_max | body | Departure leg, arrival time max (hour of day, 0 to 23) | integer | No | - | 23 |
| return_departure_time_min | body | Return leg, departure time min (hour of day, 0 to 23) | integer | No | - | 23 |
| return_departure_time_max | body | Return leg, departure time max (hour of day, 0 to 23) | integer | No | - | 23 |
| return_arrival_time_min | body | Return leg, arrival time min (hour of day, 0 to 23) | integer | No | - | 23 |
| return_arrival_time_max | body | Return leg, arrival time max (hour of day, 0 to 23) | integer | No | - | 23 |
| sort_type | body | Google Flights sort. Price insights (low/typical/high) are not returned with Price. | string | No | Overall | - |
| currency | body | Currency code, e.g. USD, EUR | string | No | USD | - |
| max_price | body | Upper price limit. Note: with max_price the price insights come back null. | number | No | - | - |
| seat_type | body | 1 economy, 2 premium economy, 3 business, 4 first | integer | No | - | - |
| passengers | body | One entry per traveller: 1 adult, 2 child, 3 infant on lap, 4 infant in seat. Default one adult. | array of integer | No | - | - |
| limit | body | Maximum number of results | integer | No | 10 | - |
| use_ext_proxy | body | Residential routing (default true); false can be faster on easy routes | boolean | No | true | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/flightpowers/google-flights/v1/flights/roundtrip' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"from_airport": "JFK", "to_airport": "CUN", "departure_date": "2027-06-15", "return_date": "2027-06-18", "limit": 5, "currency": "USD"}'
```

**Example Response (200 OK, trimmed):**

Long lists are cut to their first items and long text is shortened.

```json
[
  {
    "price_range_in_relation_to_other_periods": "typical",
    "price_insights_low": 340,
    "price_insights_high": 445,
    "from_airport": "New York (JFK)",
    "to_airport": "Cancun (CUN)",
    "departure_date": "2027-06-15",
    "return_date": "2027-06-18",
    "total_price": "$442",
    "total_price_as_number": 442,
    "total_duration_seconds": 29400,
    "total_stops": 0,
    "buy_link": "https://www.google.com/travel/flights?tfs=GjsSCjIwMjctMDYtMTUiHwoDSkZLEgoyMDI3LTA2LTE1GgNDVU4qAkFBMgM4MTZqBRIDSkZLcgUSA0NVTho8EgoyMDI3LTA2LTE4IiAKA0NVThIKMjAyNy0wNi0xOBoDSkZLKgJBQTIEMTE4NWoFEgNDVU5yBRIDSkZLQgEBSAGYAQE&curr=USD",
    "departure_flight_departure_description": "6:59 AM on Tue, Jun 15",
    "departure_flight_arrival_description": "10:09 AM on Tue, Jun 15",
    "departure_flight_airline": "American",
    "departure_flight_stops": 0,
    "departure_flight_duration": "4 hr 10 min",
    "departure_stops_info": [],
    "return_flight_departure_description": "11:09 AM on Fri, Jun 18",
    "return_flight_arrival_description": "4:09 PM on Fri, Jun 18",
    "return_flight_airline": "American",
    "return_flight_stops": 0,
    "return_flight_duration": "4 hr",
    "return_stops_info": []
  },
  {
    "price_range_in_relation_to_other_periods": "typical",
    "price_insights_low": 340,
    "price_insights_high": 445,
    "from_airport": "New York (JFK)",
    "to_airport": "Cancun (CUN)",
    "departure_date": "2027-06-15",
    "return_date": "2027-06-18",
    "total_price": "$477",
    "total_price_as_number": 477,
    "total_duration_seconds": 30000,
    "total_stops": 0,
    "buy_link": "https://www.google.com/travel/flights?tfs=GjwSCjIwMjctMDYtMTUiIAoDSkZLEgoyMDI3LTA2LTE1GgNDVU4qAkI2MgQxODUxagUSA0pGS3IFEgNDVU4aOxIKMjAyNy0wNi0xOCIfCgNDVU4SCjIwMjctMDYtMTgaA0pGSyoCQjYyAzg1MmoFEgNDVU5yBRIDSkZLQgEBSAGYAQE&curr=USD",
    "departure_flight_departure_description": "9:50 AM on Tue, Jun 15",
    "departure_flight_arrival_description": "1:15 PM on Tue, Jun 15",
    "departure_flight_airline": "JetBlue",
    "departure_flight_stops": 0,
    "departure_flight_duration": "4 hr 25 min",
    "departure_stops_info": [],
    "return_flight_departure_description": "11:35 AM on Fri, Jun 18",
    "return_flight_arrival_description": "4:30 PM on Fri, Jun 18",
    "return_flight_airline": "JetBlue",
    "return_flight_stops": 0,
    "return_flight_duration": "3 hr 55 min",
    "return_stops_info": []
  }
]
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the body holds the result. |
| 400 | Bad Request | The body is not valid JSON, a required field is missing, an airport code is not valid, or a date is in the past. |
| 401 | Unauthorized | The `x-api-market-key` header is missing, invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path, or the item you asked for, does not exist. |
| 429 | Too Many Requests | You sent more than 1 request per second, or you used all 10 calls of the Free plan. |
| 500 | Internal Server Error | Something failed on the provider side. Retry after a short delay. |
| 503 | Service Unavailable | The service or its data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

You can send up to 1 request per second. Free includes 10 calls (a 7-day trial), PRO includes 2,500 calls a month for $10, ULTRA includes 10,000 calls a month for $25 and MEGA includes 25,000 calls a month for $50. Requests above the limit return `429 Too Many Requests`; throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **What does an empty array mean?**
    `200` with `[]` means Google has no itineraries for that route and date. A search that did not finish returns a 5xx error and is safe to retry.

*   **Why is there no price verdict on some searches?**
    The `price_insights_*` fields are not returned when you sort by price, set `max_price`, or search a stay longer than 32 nights.

*   **Why do my prices differ from the example?**
    Fares change by the minute; every call reads the live price.

*   **What format do dates and airports use?**
    Dates are `YYYY-MM-DD` and must be in the future; airports are IATA codes such as `LHR`.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Live Google Flights fares as JSON. A round trip is one request with one total and a booking link, plus Google's low/typical/high verdict on standard searches.