{
  "markdown": "# ✈️ Google Flights Deals API: cheap destinations as clean JSON\n\nGive it an airport and get back the thirty cheapest destinations you can fly to from there, as structured JSON. Each one comes with the price, the typical price for that route, exact dates, airline, stops, duration, a photo, and a booking link.\n\n**The part nobody else gives you: which of them are actually bargains.** A cheap fare and a good deal are not the same thing.\n\n**Actor:** [Google Flights Deals API on Apify Store](https://apify.com/johnvc/google-flights-deals-api?fpr=9n7kx3)\n\n## Video Walkthrough\n\nhttps://www.youtube.com/watch?v=jREWahDGhJM\n\n## Quick Start\n\n```bash\ngit clone https://github.com/johnisanerd/Apify-Google-Flights-Deals-API.git\ncd Apify-Google-Flights-Deals-API\ncp .env.example .env          # paste your Apify token\nuv sync\nuv run google-flights-deals-api-example.py\n```\n\nGet a free Apify API key at [apify.com](https://apify.com?fpr=9n7kx3).\n\n## Why Use This Google Flights Deals API?\n\n- **Bargain detection, not just cheap fares.** Every row carries `average_price`, what that route typically costs, plus `savings`, `savings_percent`, and an `is_below_typical` flag.\n- **One call, thirty bookable options.** Each with real dates and a link that goes straight to the booking page.\n- **A real filter surface.** Cabin class, max price, max stops, trip length, airline include or exclude.\n- **No arrival airport needed.** This answers \"where can I go cheaply from here\", so the source ignores a destination by design.\n\n## An honest note on the data\n\nMeasured across three hubs, roughly **6 to 30% of the feed genuinely beats its typical price**, depending on the airport. The rest are cheap in absolute terms without being discounts, usually short-haul routes. That is the nature of the source, and it is exactly why `is_below_typical` exists: it turns a list of cheap flights into a list you can filter for bargains.\n\nOne limit worth knowing: setting `maxDurationMinutes` makes the source stop returning the typical-price baseline, so that single filter turns off bargain detection. Every other filter keeps it, including one way.\n\n## Features\n\n| Feature | Detail |\n|---|---|\n| Bargain flag | `is_below_typical` is true only when the fare beats its own route's typical price |\n| Derived savings | `savings` and `savings_percent`, computed locally on every row |\n| Multi-airport | `departureIds` watches several home airports in one run |\n| Filters | cabin class, max price, max stops, trip length preset, airline include or exclude |\n| Booking links | `flight_link` goes straight to the itinerary |\n| Localization | `currency`, `hl`, and `gl` |\n\n## Usage Examples\n\nNonstop options under a budget:\n\n```python\nrun_input = {\"departureId\": \"LAX\", \"maxStops\": \"nonstop\", \"maxPrice\": 400}\n```\n\nWeekend trips from a set of home airports:\n\n```python\nrun_input = {\"departureIds\": [\"JFK\", \"EWR\", \"LGA\"], \"travelDuration\": \"weekend\"}\n```\n\nBusiness class bargains:\n\n```python\nrun_input = {\"departureId\": \"LAX\", \"travelClass\": \"business\"}\n```\n\n## Input Parameters\n\n| Parameter | Type | Description |\n|---|---|---|\n| `departureId` | string | 3-letter IATA code, such as JFK. |\n| `departureIds` | array | More airports. Each is one lookup. |\n| `tripType` | select | Round trip (default) or one way. Both keep the savings baseline. |\n| `outboundDate` / `returnDate` | string | YYYY-MM-DD. Leave blank to let the feed pick cheap dates. |\n| `travelDuration` | select | any, one_week, weekend, two_weeks |\n| `tripLength` | string | Exact days, as `7` or a range like `5-10`. |\n| `travelClass` | select | economy, premium_economy, business, first |\n| `maxPrice` | integer | Drop deals above this price. |\n| `maxStops` | select | any, nonstop, one_stop, two_stops |\n| `maxDurationMinutes` | integer | Drop longer deals. Turns off bargain detection, see above. |\n| `includeAirlines` / `excludeAirlines` | string | Comma-separated codes. Mutually exclusive. |\n| `maxDealsPerAirport` | integer | Default and maximum 30. |\n| `currency`, `hl`, `gl` | string | Currency, language, country. |\n\n## Output Format\n\nOne row per destination:\n\n```json\n{\n  \"result_type\": \"deal\",\n  \"position\": 1,\n  \"departure_id\": \"JFK\",\n  \"name\": \"Nantucket\",\n  \"country\": \"United States\",\n  \"price\": 295,\n  \"average_price\": 478,\n  \"savings\": 183.0,\n  \"savings_percent\": 38.3,\n  \"is_below_typical\": true,\n  \"route\": \"JFK to ACK\",\n  \"outbound_date\": \"2026-10-01\",\n  \"return_date\": \"2026-10-08\",\n  \"flight_duration\": 282,\n  \"stops\": 1,\n  \"airline\": \"JetBlue\",\n  \"flight_link\": \"https://www.google.com/travel/flights?tfs=...\"\n}\n```\n\nNegative savings are preserved rather than hidden: knowing a \"deal\" sits above its typical price is useful information.\n\nThis Actor returns a snapshot. It does not track prices over time, keep history, or send alerts. It is the data layer you build a price-alert product on.\n\n## Install in Claude Cowork Desktop\n\n![Install in Claude Cowork Desktop](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_desktop.png)\n\nCowork is the desktop app's automation mode. To give it the Google Flights Deals API as a tool, add the Apify MCP server as a connector.\n\n1. Open the Claude desktop app and go to **Settings → Connectors** (or **Settings → Developer → Edit Config** to edit `claude_desktop_config.json` directly).\n   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n2. Add the Apify MCP server, preloaded with only this Actor:\n\n```json\n{\n  \"mcpServers\": {\n    \"apify\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"mcp-remote\",\n        \"https://mcp.apify.com/?tools=actors,docs,johnvc/google-flights-deals-api\"\n      ]\n    }\n  }\n}\n```\n\n3. Restart the app. When Cowork first calls the tool, complete the OAuth prompt in your browser, or add your Apify API token in the connector settings to skip OAuth.\n4. In a Cowork chat, confirm the tool is available and ask it to run the Google Flights Deals API.\n\nDownload the desktop app and start a free trial: https://claude.ai/referral/uIlpa7nPLg\nMore help: https://docs.apify.com/platform/integrations/claude-desktop\n\n## Install in Claude Code\n\n![Install in Claude Code](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_code.png)\n\nClaude Code is the command-line tool. Add the Actor's MCP server with one command:\n\n```bash\nclaude mcp add --transport http apify \\\n  \"https://mcp.apify.com/?tools=actors,docs,johnvc/google-flights-deals-api\"\n```\n\nTo use a token instead of browser OAuth:\n\n```bash\nclaude mcp add --transport http apify \\\n  \"https://mcp.apify.com/?tools=actors,docs,johnvc/google-flights-deals-api\" \\\n  --header \"Authorization: Bearer YOUR_APIFY_TOKEN\"\n```\n\nThen verify with `claude mcp list`, or run `/mcp` inside a session. Ask Claude Code to call the Google Flights Deals API.\n\nTry Claude Code free: https://claude.ai/referral/uIlpa7nPLg\nClaude Code MCP docs: https://code.claude.com/docs/en/mcp\n\n## Install in Claude (website)\n\n![Install in Claude (website)](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_claude_ai.png)\n\nOn claude.ai you add Apify as a connector, then enable just this Actor's tool.\n\n1. Go to **Settings → Connectors → Browse connectors** and search for **Apify MCP server**. Install it (enable or update if prompted).\n2. When connecting, authenticate with your Apify API token, and enable the tool `johnvc/google-flights-deals-api`.\n3. In any chat, open **+ → Connectors** and turn on **Apify**.\n4. Alternatively, choose **Add custom connector** and paste the full MCP URL `https://mcp.apify.com/?tools=actors,docs,johnvc/google-flights-deals-api`, using OAuth when prompted.\n5. Ask Claude to run the Google Flights Deals API.\n\nOpen Claude on the web: https://claude.ai/referral/uIlpa7nPLg\n\n## Install in Cursor\n\n![Install in Cursor](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_cursor.png)\n\nCursor reads MCP servers from a project file at `.cursor/mcp.json`.\n\n1. In your project, create `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"apify\": {\n      \"url\": \"https://mcp.apify.com/?tools=actors,docs,johnvc/google-flights-deals-api\"\n    }\n  }\n}\n```\n\n2. If you prefer token auth over browser OAuth, add a header:\n\n```json\n{\n  \"mcpServers\": {\n    \"apify\": {\n      \"url\": \"https://mcp.apify.com/?tools=actors,docs,johnvc/google-flights-deals-api\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_APIFY_TOKEN\" }\n    }\n  }\n}\n```\n\n3. Open **Cursor → Settings → MCP** and confirm the **apify** server is connected (green dot).\n4. In Composer or Chat, ask Cursor to call the Google Flights Deals API.\n\nNew to Cursor? Get it here: https://cursor.com/referral?code=XQP4VBLI3NNX\n\n## Install in ChatGPT\n\n![Install in ChatGPT](https://raw.githubusercontent.com/johnisanerd/ApifyPublicData/main/assets/guides/install_mcp_into_ChatGPT.png)\n\nChatGPT connects to the Apify MCP server through Developer mode (available on ChatGPT Pro, Plus, Business, Enterprise, and Education plans).\n\n1. Click your profile icon, then go to **Settings > Apps**. If you do not see a **Create app** button, open **Advanced settings** and enable **Developer mode**.\n2. Click **Create app** and fill out the form:\n   - **Name:** Apify\n   - **MCP Server URL:** `https://mcp.apify.com/?tools=actors,docs,johnvc/google-flights-deals-api`\n   - **Authentication:** OAuth\n3. Click **Create** and authorize the connection with Apify.\n4. To use the app in a conversation, click **+** in the chat, choose **Developer mode**, and select **Apify**.\n\nMore help: https://docs.apify.com/platform/integrations/mcp\n\n---\n\n[**Made with care**](https://apify.com/johnvc?fpr=9n7kx3)\n\n*Use the Google Flights Deals API to power local lead lists, market research, and place data for your product or AI agent.*\n\n## Featured Tasks\n\nReady-to-run examples on the Apify Store, each targeting one local-data use case:\n\n- [Extract local business leads from Google Maps by API](https://apify.com/johnvc/google-flights-deals-api/examples/extract-local-business-leads-from-google-maps-by-api?fpr=9n7kx3)\n- [Extract phone numbers from Google Maps by zip code](https://apify.com/johnvc/google-flights-deals-api/examples/extract-phone-numbers-from-google-maps-by-zip-code?fpr=9n7kx3)\n- [Find roofing contractor leads in Tampa with phone numbers](https://apify.com/johnvc/google-flights-deals-api/examples/find-roofing-contractor-leads-in-tampa-with-phone-numbers?fpr=9n7kx3)\n- [Build a list of med spas in Miami with phone numbers](https://apify.com/johnvc/google-flights-deals-api/examples/build-a-list-of-med-spas-in-miami-with-phone-numbers?fpr=9n7kx3)\n- [Generate local leads in Claude via Google Maps MCP](https://apify.com/johnvc/google-flights-deals-api/examples/generate-local-leads-in-claude-via-google-maps-mcp?fpr=9n7kx3)\n- [Export Google Maps Places to CSV](https://apify.com/johnvc/google-flights-deals-api/examples/export-google-maps-places-to-csv?fpr=9n7kx3)\n\nLast Updated: 2026.08.08\n",
  "bytes": 11102,
  "sha": "4b87b57a138b1258e1178f3424c67b2129e106b948576ca7f6888b24d26ecc7f",
  "repo_slug": "johnisanerd/apify-google-flights-deals-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_johnisanerd_google_flights_dea_f8a49909/readme"
}