# Explore Destinations

Returns the destination set of the Google Travel Explore map for one origin: destination name, country, coordinates, image, suggested outbound and return dates, destination airport, cheapest flight price, airline, stops, duration and hotel price when Google shows one. The whole destination set arrives in one response; there is no page parameter. Destinations without a price stay in the result with flight_price null. max_price keeps every destination and drops the over-cap flight offers, exactly like the upstream price filter, and never causes a second upstream call.

- **Documentation:** [https://scrappa.co/docs/google-travel-explore-api/google_travel_explore_search](https://scrappa.co/docs/google-travel-explore-api/google_travel_explore_search)
- **API group:** Google Travel Explore API
- **Endpoint:** `GET https://scrappa.co/api/flights/explore`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `departure_id` | string | Yes | Origin airport IATA code (e.g., JFK, LAX) or Google place kgmid (e.g., /m/02_286) |
| `type` | string | No | round_trip (default) or one_way |
| `travel_class` | integer | No | 1 = economy (default), 2 = premium economy, 3 = business, 4 = first |
| `adults` | integer | No | Number of adult passengers (1-9, default: 1) |
| `children` | integer | No | Number of child passengers (0-9, default: 0) |
| `infants` | integer | No | Number of infants (0-9, default: 0) |
| `gl` | string | No | Country code the prices and destinations are pinned to (e.g., us, de, gb). Never taken from the exit IP. |
| `hl` | string | No | Language code (e.g., en, de, en-US) |
| `max_price` | integer | No | Maximum flight price. Destinations keep their row; only the over-cap flight offers are dropped. No second upstream call. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/flights/explore?departure_id=JFK&type=round_trip&gl=us&hl=en"
```

## Example response

```json
{
    "search_metadata": {
        "departure_id": "JFK",
        "gl": "us",
        "hl": "en",
        "type": "round_trip",
        "max_price": null
    },
    "origin": {
        "name": "New York",
        "airport_code": "JFK",
        "city_kgmid": "/m/02_286",
        "coordinates": [
            40.7127753,
            -74.0059728
        ]
    },
    "destinations": [
        {
            "name": "San Francisco",
            "country": "United States",
            "kgmid": "/m/0d6lp",
            "airport_code": "SFO",
            "coordinates": [
                37.7749295,
                -122.4194155
            ],
            "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcRYJej5J9FpXbfAsrfHiBFGrVzol-KD7KjTNnzmsfXUsljIoBRyq9fcB0WvWVbu0kzsbhs6vx5A8fayVuZ3YWH5TT-Lac_5zFFOtwzEEmE",
            "flight_price": 377,
            "priced": true,
            "outbound_date": "2026-12-03",
            "return_date": "2026-12-09",
            "airlines": [
                {
                    "code": "B6",
                    "name": "JetBlue"
                }
            ],
            "stops": 1,
            "duration_minutes": 394,
            "hotel_price": null
        },
        {
            "name": "Philadelphia",
            "country": "United States",
            "kgmid": "/m/0dftz",
            "airport_code": "PHL",
            "coordinates": [
                39.9525839,
                -75.1652215
            ],
            "image": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcTARk3fg4JrXocEwFZ__Vu1gTQq_0fAQykb5FfW16JDWxFEvSzsdWXG8thXEjtdTNrnGpD6L0OVyiRFQb3xGcQk6R1qWqf3S-SjvkZccA",
            "flight_price": null,
            "priced": false,
            "outbound_date": "2026-12-03",
            "return_date": "2026-12-09",
            "airlines": [],
            "stops": null,
            "duration_minutes": null,
            "hotel_price": null
        }
    ],
    "facets": {
        "price_bounds": [
            50,
            1500
        ],
        "alliances": [
            "ONEWORLD",
            "SKYTEAM",
            "STAR_ALLIANCE"
        ],
        "themes": [
            {
                "kgmid": "/g/11bc58l13w",
                "name": "Outdoors"
            },
            {
                "kgmid": "/m/0b3yr",
                "name": "Beaches"
            },
            {
                "kgmid": "/m/09cmq",
                "name": "Museums"
            },
            {
                "kgmid": "/m/03g3w",
                "name": "History"
            },
            {
                "kgmid": "/m/071k0",
                "name": "Skiing"
            }
        ]
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Missing required query parameter |  |
|  | Invalid departure_id, type, travel_class, adults, children, infants, gl, hl or max_price parameter |  |
|  | Too many requests. Please retry shortly. |  |
|  | Google Travel Explore is temporarily unavailable. Please retry shortly. |  |
|  | Google Travel Explore is temporarily unavailable. Please retry shortly. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)