Google Travel Explore Destination API

GET /api/v1/search?engine=google_travel_explore_destination

Google Travel Explore Destination API returns detailed flight options for a specific destination. Use it with the Google Travel Explore API which discovers destinations, then pass the destination's kgmid here for flight details. Each flight result includes airport codes and dates that you can pass directly to the Google Flights API to get full booking options, price insights, and price history charts.

API Parameters

Search Query

Name

departure_id

Required

Required

Description
This parameter specifies the code for the departure airport or a location identifier. Available options can be:
- Airport Code: A 3-letter code representing the departure airport (e.g., MAD for Madrid-Barajas Airport or JFK for John F. Kennedy International Airport). You can find these codes using resources like Google Flights or IATA.
- Location Identifier (kgmid): A string that begins with /m/, used to represent a specific location. You can find this identifier on Wikidata by looking for the "Freebase ID" while searching for location. For example, /m/07bbc is the identifier for Skopje, North Macedonia.
Name

arrival_id

Required

Required

Description
This parameter specifies the destination location. Available options can be:
- Airport Code: A 3-letter code representing the arrival airport (e.g., JFK for John F. Kennedy International Airport or CDG for Paris Charles de Gaulle Airport). You can find these codes using resources like Google Flights or IATA.
- Location Identifier (kgmid): A string that begins with /m/ or /g/, used to represent a specific location. You can find this identifier on Wikidata by looking for the "Freebase ID" while searching for location. For example, /m/05qtj is the identifier for Paris, France.
Note: Unlike Google Travel Explore API, bounding box coordinates are not supported for this parameter.

Filters

Name

time_period

Required

Optional

Description
Specifies the travel duration, time range, and whether the trip is one-way or round-trip. Available options are:

Round-Trip Options
- one_week_trip_in_the_next_six_months Default
- two_week_trip_in_the_next_six_months
- one_week_trip_in_{month}
- two_week_trip_in_{month}
- weekend_trip_in_the_next_six_months
- weekend_in_{month}
One-Way Trips
- trip_in_the_next_six_months
- trip_in_{month}
Note: The {month} placeholder is dynamically generated and only allows values for the current and next six months.
You can also specify a custom date using the format YYYY-MM-DD for one-way trips, and YYYY-MM-DD..YYYY-MM-DD for round-trips, as long as the dates are not more than 11 months in the future.
Name

travel_mode

Required

Optional

Description
Determines whether to include destinations reachable by car. Allowed options are:
- all Default
- flights_only
Name

travel_class

Required

Optional

Description
Specifies the travel class. Allowed options are:
- economy Default
- premium_economy
- business
- first_class
Name

stops

Required

Optional

Description
Specifies the number of stops. Allowed options are:
- any Default
- nonstop
- one_stop_or_fewer
- two_stops_or_fewer
Name

max_price

Required

Optional

Description

Defines the maximum ticket price.
Name

max_flight_duration

Required

Optional

Description

Defines the maximum flight duration in minutes. (e.g., 240 for 4 hours)
Name

carry_on_bags

Required

Optional

Description

Defines the number of carry-on bags. Default is 0.
Note: The number cannot exceed the total number of passengers ( adults + children + infants_in_seat ).
Name

included_airlines

Required

Optional

Description
Specifies the airlines to include in the search. You can specify multiple airlines separated by commas. Allowed options are:
- ONEWORLD
- SKYTEAM
- STAR_ALLIANCE

Passengers

Name

adults

Required

Optional

Description

Defines the number of adults. Default is 1. Maximum total number of passengers (adults + children + infants_in_seat + infants_on_lap) is 9.
Name

children

Required

Optional

Description

Defines the number of children. Default is 0.
Name

infants_in_seat

Required

Optional

Description

Defines the number of infants in seat. Default is 0.
Name

infants_on_lap

Required

Optional

Description

Defines the number of infants on lap. Default is 0.

Note: You must have at least one adult per two infants.

Localization

Name

gl

Required

Optional

Description

The default parameter US defines the country of the search. Check the full list of supported Google Travel gl countries.
Name

hl

Required

Optional

Description

The default parameter en-US defines the interface language of the search. Check the full list of supported Google Travel hl languages.
Name

currency

Required

Optional

Description

Defines the currency of the returned prices. Default is USD. Check the full list of supported Google Travel currency values.

Engine

Name

engine

Required

Required

Description

Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_travel_explore_destination.

API key

Name

api_key

Required

Required

Description

The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

Name

zero_retention

Enterprise Only

Enterprise Only

Required

Optional

Description

Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Flights from New York to Paris

GET

https://www.searchapi.io/api/v1/search?arrival_id=%2Fm%2F05qtj&departure_id=%2Fm%2F02_286&engine=google_travel_explore_destination

Request

import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_travel_explore_destination",
  "departure_id": "/m/02_286",
  "arrival_id": "/m/05qtj"
}

response = requests.get(url, params=params)
print(response.text)

Response

{
  "search_metadata": {
    "id": "search_hvAVBqPT7rstLWVSuOA9Ugy2",
    "status": "Success",
    "created_at": "2026-03-17T14:15:46Z",
    "request_time_taken": 1.91,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.92,
    "request_url": null,
    "html_url": "https://www.searchapi.io/api/v1/searches/search_AxENYzjKgR4PcYDw3D0M4GJb.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_AxENYzjKgR4PcYDw3D0M4GJb"
  },
  "search_parameters": {
    "engine": "google_travel_explore_destination",
    "departure_id": "/m/02_286",
    "arrival_id": "/m/05qtj",
    "time_period": "one_week_trip_in_the_next_six_months",
    "travel_mode": "all",
    "adults": "1",
    "children": "0",
    "infants_in_seat": "0",
    "infants_on_lap": "0",
    "travel_class": "economy",
    "stops": "any",
    "currency": "USD",
    "hl": "en-US",
    "gl": "US"
  },
  "departure_date": "2026-04-20",
  "return_date": "2026-04-29",
  "flights": [
    {
      "position": 1,
      "price": 474,
      "airline_code": "BF",
      "airline": "French bee",
      "stops": 0,
      "departure_date": "2026-04-21",
      "departure_airport": {
        "id": "EWR",
        "name": "Newark Liberty International Airport"
      },
      "arrival_airport": {
        "id": "ORY",
        "name": "Paris Orly Airport"
      },
      "flight_duration": "7hr 15min",
      "duration": 435,
      "departure_city_kgmid": "/m/0hptm"
    },
    "..."
  ]
}