# Flight booking options: `POST /v1/serp/google_flights_booking`

Cost: 5 credits (5 (failed requests are free)). Docs: https://scrapercompany.com/docs/reference/google-flights-booking

Who sells the itinerary and for how much (SerpApi `booking_options`).

Airline direct and OTAs, each with price, fare name and rules, bag fees,
the seller's local-currency price and Google's click-through as both a
POST form (`booking_request`) and a GET link (`booking_url`). Google
gathers seller prices while the request is open: expect 3-12 s.

Request body (JSON):

- `booking_token` (string; required; pattern ^gf1\.[A-Za-z0-9_\-]{16,16384}$): `booking_token` of a complete itinerary: a one-way result of `/v1/serp/google_flights`, or a return/last-leg result of `/v1/serp/google_flights_return`.

Response fields:

- `currency` (string; required): Currency of the original search.
- `trip_type` (string; required; one of one_way, round_trip, multi_city): `one_way`, `round_trip` or `multi_city`.
- `legs` (array of object; required): Every leg of the chosen itinerary, in order.
  - `legs[].segments` (array of object; required): Flights in order.
  - `legs[].departure_airport` (string; required): IATA code.
  - `legs[].arrival_airport` (string; required): IATA code.
  - `legs[].departure_time` (string; optional): Airport-local wall-clock time as Google shows it, ISO 8601 without a UTC offset, e.g. `2026-11-04T18:10:00`. Present only when known.
  - `legs[].arrival_time` (string; optional): Airport-local wall-clock time as Google shows it, ISO 8601 without a UTC offset, e.g. `2026-11-04T18:10:00`. Present only when known.
  - `legs[].duration_minutes` (integer | null; required): Door-to-door travel time including layovers, minutes.
  - `legs[].stops` (integer; required)
  - `legs[].layover_airports` (array of string; required): IATA codes of the connection airports.
  - `legs[].is_direct` (boolean; required): `stops` is 0.
  - `legs[].layovers` (array of object; required)
  - `legs[].airlines` (array of string; required): Airline names Google lists for this leg.
- `booking_options` (array of object; required): Airline-direct and online travel agency sellers.
  - `booking_options[].book_with` (string; required): Seller name; several sellers are joined with ` and ` when the option is separate tickets.
  - `booking_options[].seller_code` (string | null; required): Google's code for the (first) seller: the IATA code for an airline, e.g. `LX`.
  - `booking_options[].is_airline` (boolean; required): Every seller is an airline (airline direct).
  - `booking_options[].price` (number | null; required): This seller's price for the whole trip, in `currency`, as Google shows it.
  - `booking_options[].currency` (string; required): Currency of the original search.
  - `booking_options[].display_price` (string | null; required): `price` with its currency symbol, e.g. `$527`.
  - `booking_options[].local_prices` (array of object; required): The seller's own price when it charges in another currency, e.g. CAD 749.
  - `booking_options[].marketed_as` (array of string; required): Flight numbers this seller sells the itinerary under, e.g. `LX 647`.
  - `booking_options[].booking_request` (object | null; required): Google's click-through as a form (SerpApi's shape): POST `post_data` as `application/x-www-form-urlencoded` to `url`. Null when the seller has no link (e.g. call to book).
  - `booking_options[].booking_url` (string | null; required): The same click-through as a GET link; Google answers it with a redirect to the seller's page. Null when `booking_request` is.
  - `booking_options[].seller_domain` (string | null; required): The seller's site as Google shows it, e.g. `www.swiss.com/...`.
  - `booking_options[].booking_phone` (string | null; required): Phone number of a call-to-book seller (which has no link).
  - `booking_options[].separate_tickets` (boolean; required): The option is several tickets bought from different sellers (see `sellers`).
  - `booking_options[].sellers` (array of string; required): Every seller of this option.
  - `booking_options[].option_title` (string | null; required): Fare family when Google names one, e.g. `Delta Main Basic`.
  - `booking_options[].extensions` (array of string; required): Fare rules Google lists, e.g. `No refunds`, `Free seat selection`, `Ticket changes for a fee`. Mostly shown for airline-direct sellers.
  - `booking_options[].baggage_prices` (array of string; required): Bag fees as Google words them, e.g. `1st checked bag: $45`, `1 free carry-on`.
- `option_count` (integer; required): Number of entries in `booking_options`.
- `cheapest_price` (number | null; required): Lowest `price` in `booking_options`; null when none is priced.
- `price_insights` (object | null; optional): Null when Google gives none. Omitted when `booking_options` is empty; that answer is not billed.
  - `price_insights.lowest_price` (number | null; required): Lowest price Google shows for this search, in `currency`.
  - `price_insights.price_level` (string | null; required; one of low, typical, high): Google's verdict on today's price: `low` (below its typical range), `typical` (inside it) or `high` (above it).
  - `price_insights.typical_price_range` (array of number | null; required; min items 2, max items 2): `[low, high]`: Google's typical price range for this trip.
  - `price_insights.price_history` (array of array of number; required): `[[unix_seconds, price], ...]`: Google's price history for this trip, about 60 days. Empty when Google gives none.
- `google_flights_url` (string; required): Google Flights booking page for this itinerary.
- `elapsed_s` (number; required): Time Google took to answer, seconds (typically 3-12 s: Google checks seller prices while the request is open).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)
