# Google Travel Explore API | Destination for AI Travel Agents (`johnvc/google-travel-explore-api`) Actor Discover where you can travel from any airport with Google Travel Explore: destination ideas with flight prices, hotel prices, trip dates, duration, and stops as structured JSON. For travel sites, agencies, and AI travel agents. Pay per destination, MCP-ready. - **URL**: https://apify.com/johnvc/google-travel-explore-api.md - **Developed by:** [John](https://apify.com/johnvc) (community) - **Categories:** Travel, AI, MCP servers - **Stats:** 15 total users, 8 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $4.85 / 1,000 destination returneds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Travel Explore API | Destination Discovery for AI Travel Agents Discover where you can travel from any airport and get destination ideas with prices and dates as structured JSON. For one or more departure airports, this Google Travel API returns a ranked list of destinations, each with an estimated round-trip flight price, nightly hotel price, suggested trip dates, flight duration, number of stops, and a link. It is the missing piece for travel content sites, agencies, and AI travel agents that currently stitch this together by hand from flights and hotels. ### What you get One row per destination: - `name` and `country` of the destination, plus `destination_airport` and `gps_coordinates` - `flight_price` (estimated round trip) and `hotel_price` (estimated nightly) - `start_date` and `end_date` of the suggested trip - `flight_duration` (minutes) and `number_of_stops` - `airline` / `airline_code` for the suggested itinerary - `link` to the destination on Google Travel, and a `thumbnail` ### Use cases - Feed an AI travel agent a list of destinations a traveler might love, with prices, in one call - Power a "where can I go on a budget?" feature on a travel content site - Build seasonal destination roundups with real prices and dates - Compare reachable destinations and prices across several home airports - Seed trip-planning workflows with ranked, priced destination ideas ### Input | Field | Type | Description | |-------|------|-------------| | `departureId` | string | A single departure airport code, e.g. `JFK`, `LAX`, `LHR`. Provide this, `departureIds`, or both. | | `departureIds` | array of strings | A batch of departure airport codes to explore in one run. Merged with `departureId` and de-duplicated. | | `gl` | string | Optional two-letter country code for pricing and localization. Default `us`. | | `hl` | string | Optional two-letter language code. Default `en`. | | `maxResultsPerDeparture` | integer | Destinations per departure airport. Default 50, maximum 200. | #### Example input ```json { "departureId": "JFK", "gl": "us", "hl": "en", "maxResultsPerDeparture": 50 } ``` ### Sample output ```json { "result_type": "destination", "departure_id": "JFK", "position": 1, "name": "Los Angeles", "country": "United States", "destination_airport": { "code": "LAX", "location": "Los Angeles" }, "gps_coordinates": { "latitude": 34.0549, "longitude": -118.2426 }, "flight_price": 318, "hotel_price": 199, "flight_duration": 350, "number_of_stops": 0, "airline": "American and JetBlue", "airline_code": "multi", "start_date": "2026-06-21", "end_date": "2026-06-30", "link": "https://www.google.com/travel/explore?..." } ``` ### Pricing Pay-per-result: a small `actor_start` fee plus a per-destination charge. The per-destination price scales down with your Apify plan. | Plan | Per destination | Start fee | |---|---|---| | Free | $0.005 | $0.001 | | Bronze | $0.0042 | $0.001 | | Silver | $0.0035 | $0.001 | | Gold | $0.003 | $0.001 | You only pay for the destinations you receive. No monthly minimum. ### How to get started 1. Open [Google Travel Explore API on the Apify Store](https://apify.com/johnvc/google-travel-explore-api?fpr=9n7kx3). 2. Enter a `departureId` (or a `departureIds` list of airport codes). 3. Set `maxResultsPerDeparture`, then run the Actor. 4. Export the dataset as JSON, CSV, or Excel, or pull it from the API. Prefer code? See [johnvc's GitHub for setup guides and code examples](https://github.com/johnisanerd/ApifyPublicData). Want a full walkthrough? The [Google Travel Explore API example repo](https://github.com/johnisanerd/Google-Travel-Explore-API) has a Python quick-start plus MCP setup guides for Claude, Cursor, and ChatGPT. ### Run from the API ```bash curl -X POST "https://api.apify.com/v2/acts/johnvc~google-travel-explore-api/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"departureId":"JFK","maxResultsPerDeparture":25}' ``` ### 🔌 Integrations: Automate Destination Discovery with the Google Travel API A single run answers one question: "where can I go from JFK right now?" The real value comes from running it **repeatedly**, watching how reachable destinations and prices shift week to week, and feeding that Google Travel data into the tools you already use. The native [Apify platform integrations](https://docs.apify.com/platform/integrations) let you wire this Actor into your stack in minutes, with no servers or cron jobs of your own. #### Tasks + Schedules: register a recurring discovery run The core pattern is **one saved task per home airport, one schedule across all of them**. 1. **Create a task.** A [saved task](https://docs.apify.com/platform/actors/running/tasks) is this Actor plus a saved input, so give each origin its own named task, for example *"Explore from JFK"* with `departureId: "JFK"` and `maxResultsPerDeparture: 50`. Click **Create empty task** on the Actor page, fill in the input, and save. 2. **Attach a schedule.** Open [Schedules](https://docs.apify.com/platform/schedules) in the Apify Console, create a schedule with a standard cron expression, and add your tasks to it. Useful examples: `0 8 * * *` (every morning at 8 AM), `0 7 * * 1` (Mondays at 7 AM), `0 6 1 * *` (the first of each month). One schedule can trigger many tasks, so a single "weekly destination refresh" schedule can cover every airport you have saved. 3. **Review the history.** Each run appends a fresh page of destinations to the task's dataset, so you build a record of how prices and reachable destinations change over time, exportable as JSON, CSV, or Excel whenever you want. See it working in the featured task [Cheapest Places to Fly From New York With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-new-york-with-prices?fpr=9n7kx3). #### n8n: build a destination-alert workflow This Actor ships as a dedicated n8n community node (see the [n8n integration](#n8n-integration) section below), so you do not need raw HTTP requests. A typical workflow looks like this: 1. **Schedule Trigger** run every Monday morning. 2. **Google Travel Explore node** explore destinations from your home airport. 3. **Filter node** keep destinations where `flight_price` is below your budget. 4. **Slack or email node** send yourself the destination, price, and dates when a cheap trip appears. #### Make and Zapier Prefer Make or Zapier? Both have native Apify integrations, [Apify on Make](https://docs.apify.com/platform/integrations/make) and [Apify on Zapier](https://docs.apify.com/platform/integrations/zapier), with "Run Actor" and "Get Dataset Items" actions. The same pattern applies: trigger on a schedule, run this Actor, filter on price, then notify or store the results. #### Supabase: store destination history in your own database Tracking destinations and prices over time means storing them somewhere queryable. [Supabase](https://supabase.com/) (hosted Postgres) is a good fit, and there are two easy paths: - **No code**: in n8n, connect the Google Travel Explore node to the built-in Supabase node to insert a row per destination after each scheduled run. - **A few lines of Python**: run the Actor and bulk-insert the flat destination rows into a `travel_destinations` table. ```python from apify_client import ApifyClient from supabase import create_client apify = ApifyClient("YOUR_APIFY_TOKEN") supabase = create_client("https://your_project.supabase.co/", "YOUR_SERVICE_ROLE_KEY") run = apify.actor("johnvc/google-travel-explore-api").call( run_input={ "departureId": "JFK", "gl": "us", "hl": "en", "maxResultsPerDeparture": 50, } ) rows = [ { "destination": item["name"], "country": item["country"], "airport": item["destination_airport"]["code"], "flight_price": item["flight_price"], "hotel_price": item["hotel_price"], "start_date": item["start_date"], "end_date": item["end_date"], "stops": item["number_of_stops"], "link": item["link"], } for item in apify.dataset(run["defaultDatasetId"]).iterate_items() ] if rows: supabase.table("travel_destinations").insert(rows).execute() ``` Run this on a schedule (or trigger it from a webhook, below) and you have a growing destination database ready for dashboards, seasonal roundups, or "book now" recommendations. #### MCP and AI agents Apify exposes this Actor through the [Apify MCP server](https://mcp.apify.com/), so MCP-compatible AI assistants such as Claude and Cursor can call live destination discovery as a tool and answer questions like "find budget destinations from JFK this summer" with real prices and dates. See the MCP setup section below for the one-click install. #### Webhooks: connect anything else For custom setups, attach an [Apify webhook](https://docs.apify.com/platform/integrations/webhooks) to the `ACTOR.RUN.SUCCEEDED` event. Every time a scheduled run finishes, Apify POSTs the run details (including the dataset ID) to your endpoint, which can then fetch the destinations and do anything with them: update a Google Sheet, refresh a travel dashboard, or message a channel when a cheap trip appears. ### 🔌 Use this API from Claude (MCP) This Actor is compatible with the Model Context Protocol (MCP), so AI agents can call it as a tool. Add it through the hosted Apify MCP server using this Actor-specific URL: https://mcp.apify.com/?tools=actors,docs,johnvc/google-travel-explore-api If you run agents from [Claude Code](https://claude.ai/referral/uIlpa7nPLg) (free trial) or [Claude Cowork](https://claude.ai/referral/uIlpa7nPLg) (free trial), add the Apify MCP server and ask it to "find budget destinations from JFK this summer." Setup walkthrough: https://www.youtube.com/watch?v=jREWahDGhJM Apify MCP integration docs: https://docs.apify.com/platform/integrations/mcp #### MCP setup, step by step Visual setup guides for each client (source and more assets: [ApifyPublicData on GitHub](https://github.com/johnisanerd/ApifyPublicData)): **[Claude Cowork Desktop](https://claude.ai/referral/uIlpa7nPLg)** (free trial) ![Apify MCP install screenshot for the Cowork desktop app](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_desktop.png) **[Claude Code](https://claude.ai/referral/uIlpa7nPLg)** (free trial) ![Apify MCP install screenshot for the Code CLI](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_code.png) **Claude (website)** ![Install in Claude website](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_ai.png) **Cursor** ![Install in Cursor](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_cursor.png) **ChatGPT** ![Install in ChatGPT](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_ChatGPT.png) ### 💸 Pay per run with crypto (x402) The Google Travel Explore API supports agentic payments via the [x402 protocol](https://docs.apify.com/platform/integrations/x402). AI agents and MCP clients can pay for runs in USDC (on Base) with no Apify account or API token needed: point your agent at the [Apify MCP server](https://mcp.apify.com/?tools=actors,docs,johnvc/google-travel-explore-api) and it can discover, pay for, and run this Actor autonomously. Read the [Apify x402 announcement](https://apify.com/change-log/pay-for-apify-actors-with-x402?fpr=9n7kx3) for details. ### 🔗 Related Tools Destination discovery is the first step in trip planning. Once a traveler picks a place, these johnvc Actors cover the rest of the journey: - **[Google Flights API](https://apify.com/johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search?fpr=9n7kx3)** price the exact route once a destination is chosen, with one-way, round-trip, and multi-city fares. - **[Google Hotels Search Scraper](https://apify.com/johnvc/google-hotels-search-scraper?fpr=9n7kx3)** pull hotel options and nightly rates for the destination and dates you found here. - **[Google Maps Places Scraper](https://apify.com/johnvc/google-maps-places-api?fpr=9n7kx3)** find attractions, restaurants, and things to do at the destination. - **[Google Events](https://apify.com/johnvc/google-events-api---access-google-events-data?fpr=9n7kx3)** surface concerts, festivals, and local happenings while your traveler is there. For contrast, a point-to-point flight scraper such as [this Google Flights scraper](https://apify.com/solidcode/google-flights-scraper?fpr=9n7kx3) requires you to already name both the origin and the destination, so it cannot surface destinations a traveler has not chosen yet. It also has a smaller user base, no ratings, and a lower published success rate, and was last updated in April 2026. This Actor is built for the opposite job: it ranks destinations you have not picked, then hands off to the tools above for the details. ### FAQ #### What is a departure ID? It is the airport you are flying from, given as an IATA code like `JFK`, `LAX`, or `LHR`. You can pass several at once with `departureIds`. #### Are the prices live? They are [Google Travel's](https://www.google.com/travel/explore) current estimated round-trip flight and nightly hotel prices for the suggested dates, in the currency for your `gl` country. #### How many destinations come back? Up to `maxResultsPerDeparture` (default 50). A departure point typically surfaces dozens of destination ideas. #### Can I explore from several airports at once? Yes. Pass a `departureIds` list; each is explored independently and tagged with its departure code. #### Can I schedule this Google Travel API to run automatically? Yes, and this is where the Actor earns its keep. Any run can be automated on a [schedule](https://docs.apify.com/platform/schedules). Create a [saved task](https://docs.apify.com/platform/actors/running/tasks) with your departure input, then attach a schedule from the Actor's **Actions**, then **Schedule** menu. Concrete cron examples: `0 8 * * *` for daily at 8 AM, `0 7 * * 1` for Mondays at 7 AM, and `0 6 1 * *` for the first of each month. One schedule can trigger many tasks at once, so a single "weekly destination refresh" can cover every home airport you have saved. See the Integrations section above for the full monitoring recipe. #### Should I use an API or a Web Scraper? An official travel API is often rate limited, quota bound, and missing the exact fields you need. This Actor gives you the same destination data either as a no-code web scraper you run point-and-click in the console, or as a clean [API](https://en.wikipedia.org/wiki/API) endpoint you call yourself, with no quotas to manage. If you are weighing a hosted service against building your own [web scraper](https://en.wikipedia.org/wiki/Web_scraping), this Actor is both at once. #### Can I integrate this travel Scraper with other apps? Yes. The Actor connects to almost any cloud service through [Apify integrations](https://docs.apify.com/platform/integrations): [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), Google Drive, and more. For custom actions, attach a [webhook](https://docs.apify.com/platform/integrations/webhooks) on `ACTOR.RUN.SUCCEEDED`. See the Integrations section above for the full recipes. #### Can I use the Google Travel Explore API with the API? Yes. The Apify API gives programmatic access to run the Actor, schedule it, and fetch datasets, and the `apify-client` package is available for both Node.js and Python. See the Actor's own [API tab](https://apify.com/johnvc/google-travel-explore-api/api?fpr=9n7kx3) for ready-made snippets in several languages. #### Can I use this Actor through an MCP Server? Yes. The Actor can be added as a tool to any MCP client, including Claude and Cursor, through the hosted [Apify MCP server](https://mcp.apify.com/). Use the Actor-specific URL `https://mcp.apify.com/?tools=actors,docs,johnvc/google-travel-explore-api`, then ask your assistant to "find budget destinations from JFK this summer." See the [Apify MCP docs](https://docs.apify.com/platform/integrations/mcp) for setup. #### How do I use Google travel data together for a complete trip? Destination discovery is step one. Once a traveler picks a destination, price the exact route with the [Google Flights API](https://apify.com/johnvc/Google-Flights-Data-Scraper-Flight-and-Price-Search?fpr=9n7kx3), find rooms with the [Google Hotels Search Scraper](https://apify.com/johnvc/google-hotels-search-scraper?fpr=9n7kx3), map things to do with the [Google Maps Places Scraper](https://apify.com/johnvc/google-maps-places-api?fpr=9n7kx3), and pull local happenings with [Google Events](https://apify.com/johnvc/google-events-api---access-google-events-data?fpr=9n7kx3). Together they cover the whole trip-planning pipeline. #### Is an AI travel chatbot better than Google for planning a trip? An AI travel agent is only as good as the data it can reach. On its own, a chatbot guesses at prices and availability. Connect this Actor through MCP and it can pull real destinations, flight prices, hotel prices, and travel dates from Google Travel, so its suggestions are grounded in current data instead of memory. That is the gap this Actor fills for travel content sites and AI travel agents. ### n8n integration Available as an n8n community node, **[n8n-nodes-google-travel-explore-api](https://www.npmjs.com/package/n8n-nodes-google-travel-explore-api)**. In n8n: Settings, Community Nodes, install `n8n-nodes-google-travel-explore-api`, then use it in any workflow (it also works as an AI Agent tool). ### Featured Tasks Ready-to-run examples that show this API solving a specific problem. Each opens its own setup so you can run it on your account in one click. - [Cheapest Places to Fly From New York With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-new-york-with-prices?fpr=9n7kx3) - The cheapest places to fly from New York, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Los Angeles With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-los-angeles-with-prices?fpr=9n7kx3) - The cheapest places to fly from Los Angeles, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Chicago With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-chicago-with-prices?fpr=9n7kx3) - The cheapest places to fly from Chicago, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Atlanta With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-atlanta-with-prices?fpr=9n7kx3) - The cheapest places to fly from Atlanta, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Boston With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-boston-with-prices?fpr=9n7kx3) - The cheapest places to fly from Boston, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From San Francisco With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-san-francisco-with-prices?fpr=9n7kx3) - The cheapest places to fly from San Francisco, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Miami With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-miami-with-prices?fpr=9n7kx3) - The cheapest places to fly from Miami, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Seattle With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-seattle-with-prices?fpr=9n7kx3) - The cheapest places to fly from Seattle, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Dallas With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-dallas-with-prices?fpr=9n7kx3) - The cheapest places to fly from Dallas, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest Places to Fly From Denver With Prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-denver-with-prices?fpr=9n7kx3) - The cheapest places to fly from Denver, as JSON: flight\_price, hotel\_price, travel dates, and destination airport for each idea. - [Cheapest places to fly from Washington DC with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-washington-dc-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Washington DC. - [Cheapest places to fly from Houston with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-houston-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Houston. - [Cheapest places to fly from Phoenix with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-phoenix-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Phoenix. - [Cheapest places to fly from Las Vegas with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-las-vegas-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Las Vegas. - [Cheapest places to fly from Orlando with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-orlando-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Orlando. - [Cheapest places to fly from Philadelphia with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-philadelphia-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Philadelphia. - [Cheapest places to fly from Minneapolis with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-minneapolis-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Minneapolis. - [Cheapest places to fly from Austin with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-austin-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Austin. - [Cheapest places to fly from Nashville with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-nashville-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Nashville. - [Cheapest places to fly from Toronto with prices](https://apify.com/johnvc/google-travel-explore-api/examples/cheapest-places-to-fly-from-toronto-with-prices?fpr=9n7kx3) - Find the cheapest places to fly from Toronto. *** ### 🌐 About Alpha OSINT This Actor is part of [Alpha OSINT](https://www.alphaosint.com), toolset of financial and operations data sources and APIs. See the [Google Travel Explore API source page](https://www.alphaosint.com/sources/google-travel-explore-api/) for related tools and use cases. For support or requests for this actor, please start a ticket [directly on our support page](https://apify.com/johnvc/google-travel-explore-api/issues/open?fpr=9n7kx3). Last Updated: 2026.09.10 # Actor input Schema ## `departureId` (type: `string`): Enter a single departure airport code to explore destinations from, for example 'JFK', 'LAX', or 'LHR'. Provide this, `departureIds`, or both. ## `departureIds` (type: `array`): Provide a list of departure airport codes to explore in one run, for example \['JFK', 'SFO']. Merged with `departureId` and de-duplicated. ## `gl` (type: `string`): Set the two-letter country code for pricing and localization (e.g. 'us', 'gb', 'de'). Defaults to 'us'. ## `hl` (type: `string`): Set the two-letter interface language code (e.g. 'en', 'es', 'de'). Defaults to 'en'. ## `maxResultsPerDeparture` (type: `integer`): How many destination ideas to return per departure airport. Default 50, maximum 200. ## Actor input object example ```json { "departureId": "JFK", "gl": "us", "hl": "en", "maxResultsPerDeparture": 50 } ``` # Actor output Schema ## `results` (type: `string`): All destination rows stored in the default dataset, one item per destination. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "departureId": "JFK", "gl": "us", "hl": "en" }; // Run the Actor and wait for it to finish const run = await client.actor("johnvc/google-travel-explore-api").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "departureId": "JFK", "gl": "us", "hl": "en", } # Run the Actor and wait for it to finish run = client.actor("johnvc/google-travel-explore-api").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "departureId": "JFK", "gl": "us", "hl": "en" }' | apify call johnvc/google-travel-explore-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,johnvc/google-travel-explore-api" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/P4gbxfqolqaL1FzKr/builds/uMbNdaRXHxol79IhK/openapi.json