{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Flights Scraper & Price Tracker API - Fare Alerts",
    "description": "Google Flights scraper and price tracker: fares, cheapest day to fly, stops, airlines, CO2 and price history for any route and dates. Google Flights price drop alerts in Slack, Discord, Teams or Telegram. Google Flights API and MCP server for AI agents. Residential proxy included, no login.",
    "version": "0.1",
    "x-build-id": "nGKF9Hc7mwwZY290x"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/akhil_rajesh~google-flights-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-akhil_rajesh-google-flights-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/akhil_rajesh~google-flights-scraper/runs": {
      "post": {
        "operationId": "runs-sync-akhil_rajesh-google-flights-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/akhil_rajesh~google-flights-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-akhil_rajesh-google-flights-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "routes": {
            "title": "Routes",
            "type": "array",
            "description": "One route per line: 'New York to London' or 'YYZ to LHR'. Cities (all their airports) and airports (IATA codes) work, as in Google Flights' own search box. Countries ('Toronto to Japan') and several places on one side ('YYZ/YTZ to LHR') are paused since 2026-11-16: Google Flights asks its data call for a browser check, which this Actor doesn't pass. At most 50 routes.",
            "items": {
              "type": "string"
            }
          },
          "departureDates": {
            "title": "Departure dates",
            "type": "array",
            "description": "One per line: a date (2026-12-10), a range of up to 31 days (2026-12-10 to 2026-12-14), or a date counted from the run's day ('in 30 days', '2 weeks', '3 months'). Every route is searched on every date (at most 100 searches a run). Google Flights lists flights from today to about 11 months ahead. Leave empty for flights in 30 days. For Only changes, use fixed dates: 'in 30 days' is a new date each day.",
            "items": {
              "type": "string"
            }
          },
          "returnDate": {
            "title": "Return date (round trip)",
            "type": "string",
            "description": "For a round trip with one departure date: the return date (2026-12-20, or 'in 37 days'). Leave empty for one way. With several departure dates, use Trip length instead."
          },
          "tripLengthDays": {
            "title": "Trip length (days, round trip)",
            "minimum": 0,
            "maximum": 330,
            "type": "integer",
            "description": "For round trips: return this many days after each departure date (7 for a week). Leave empty for one way."
          },
          "googleFlightsUrls": {
            "title": "Google Flights links",
            "type": "array",
            "description": "Optional: Google Flights search links with a 'q=' search, such as the googleFlightsUrl of this Actor's rows (https://www.google.com/travel/flights?q=Flights+to+LHR+from+YYZ+on+2026-12-10). Their dates, currency and country are used for that route.",
            "items": {
              "type": "string"
            }
          },
          "adults": {
            "title": "Adults",
            "minimum": 1,
            "maximum": 9,
            "type": "integer",
            "description": "Adults (default 1). Prices are for all passengers together, as Google Flights shows them; rows with several adults also give the price per adult."
          },
          "children": {
            "title": "Children (2-11)",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Children aged 2 to 11."
          },
          "infantsInSeat": {
            "title": "Infants in seat",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Paused since 2026-11-16: Google Flights asks its data call for a browser check, which this Actor doesn't pass; a run with infants is refused before any search, at no cost. Infants under 2 in their own seat."
          },
          "infantsOnLap": {
            "title": "Infants on lap",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Paused since 2026-11-16: Google Flights asks its data call for a browser check, which this Actor doesn't pass; a run with infants is refused before any search, at no cost. Infants under 2 on a lap (one per adult). At most 9 passengers in all."
          },
          "cabinClass": {
            "title": "Cabin",
            "type": "string",
            "description": "Economy (default), business or first. Premium economy is paused since 2026-11-16 (Google Flights asks its data call for a browser check): a run that asks for it is refused before any search, at no cost."
          },
          "stops": {
            "title": "Stops",
            "type": "string",
            "description": "Default: any. Nonstop is sent with the search. Since 2026-11-16 '1 stop or fewer' and '2 stops or fewer' are applied to the flights after the search, since Google Flights asks its own filter's data call for a browser check; the status says so."
          },
          "airlines": {
            "title": "Airlines",
            "type": "array",
            "description": "Only these airlines: codes (AC, BA, DL) or names (Air Canada), matched against each flight's airlines. Since 2026-11-16 codes are applied after the search (Google Flights asks its own Airlines filter's data call for a browser check), and alliances (Star Alliance, oneworld, SkyTeam) are paused: name their airlines instead. Leave empty for all.",
            "items": {
              "type": "string"
            }
          },
          "excludeAirlines": {
            "title": "Leave out airlines",
            "type": "array",
            "description": "Flights flown by these airlines (codes or names) are left out.",
            "items": {
              "type": "string"
            }
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "number",
            "description": "Leave out flights above this price, in the run's currency. A search's cheapest fare is the cheapest flight that passes every filter."
          },
          "maxDurationMinutes": {
            "title": "Max duration (minutes)",
            "minimum": 0,
            "type": "integer",
            "description": "Leave out flights longer than this, layovers included (600 for 10 hours)."
          },
          "maxLayoverMinutes": {
            "title": "Max layover (minutes)",
            "minimum": 0,
            "type": "integer",
            "description": "Leave out flights with a longer layover."
          },
          "departureTimeFrom": {
            "title": "Departs after",
            "type": "string",
            "description": "Local time at the departure airport, 06:00. With Departs before, a window; a window from 22:00 to 05:00 crosses midnight."
          },
          "departureTimeTo": {
            "title": "Departs before",
            "type": "string",
            "description": "Local time, 12:00 (a plain hour, 12, includes 12:59)."
          },
          "arrivalTimeFrom": {
            "title": "Arrives after",
            "type": "string",
            "description": "Local time at the arrival airport."
          },
          "arrivalTimeTo": {
            "title": "Arrives before",
            "type": "string",
            "description": "Local time at the arrival airport."
          },
          "maxFlightsPerSearch": {
            "title": "Flights per search",
            "minimum": 0,
            "maximum": 300,
            "type": "integer",
            "description": "Flight rows each search returns, in the Sort by order (default 20, up to 300: Google lists up to about 300). 0 returns only each search's summary row, with its cheapest fare and price insight."
          },
          "sortBy": {
            "title": "Sort flights by",
            "type": "string",
            "description": "The order of each search's flight rows (default: price)."
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 50000,
            "type": "integer",
            "description": "Charged rows a run returns in all (default 1,000), shared evenly across the searches. Free rows (not found, no flights) don't count."
          },
          "priceCalendarDays": {
            "title": "Price calendar (days)",
            "minimum": 0,
            "maximum": 330,
            "type": "integer",
            "description": "Paused since 2026-11-16: Google Flights asks its data call for a browser check, which this Actor doesn't pass. A run that asks for it says so and searches the departure dates. The cheapest fare for each departure day, for this many days from each route's first departure date (one calendar row per route; round trips keep the trip length). 0 or empty: no calendar."
          },
          "calendarOnly": {
            "title": "Price calendar only",
            "type": "boolean",
            "description": "Paused since 2026-11-16: Google Flights asks its data call for a browser check, which this Actor doesn't pass. A run that asks for it says so and searches the departure dates. Only the price calendar, no searches (60 days unless Price calendar says otherwise)."
          },
          "onlyChanges": {
            "title": "Only changes",
            "type": "boolean",
            "description": "Return only what changed since the last run of the same search: the cheapest fare dropping or rising by at least the minimum change, a fare at or under your target, and flights whose own price moved. The first run returns everything (firstRun) and saves it as the baseline. Use it with a schedule. Alerts switch it on."
          },
          "changeTypes": {
            "title": "Changes to report",
            "type": "array",
            "description": "Which changes Only changes returns and alerts post. Default: price drops and fares under your target.",
            "items": {
              "type": "string",
              "enum": [
                "priceDrop",
                "belowTarget",
                "priceRise",
                "newFlight"
              ],
              "enumTitles": [
                "Price drops",
                "Fares at or under your target",
                "Price rises",
                "New flights (flight rows)"
              ]
            },
            "default": [
              "priceDrop",
              "belowTarget"
            ]
          },
          "minPriceChangePercent": {
            "title": "Minimum price change (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "A smaller move isn't reported, and the last reported price stays the baseline, so a slow slide is reported once it adds up (default 1).",
            "default": 1
          },
          "targetPrice": {
            "title": "Target price",
            "minimum": 0,
            "type": "number",
            "description": "With Only changes: report a search (and alert) when its cheapest fare reaches this price or less, in the run's currency, for all passengers. Reported once until the fare goes back above it."
          },
          "alertWebhookUrl": {
            "title": "Alert webhook URL",
            "type": "string",
            "description": "Post the changes to a Slack, Discord or Microsoft Teams channel (its incoming webhook URL), or any HTTPS endpoint that takes JSON (Zapier, Make, n8n). The first run posts one 'alerts are set up' message; fare changes follow from the next run."
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Post the changes to Telegram through your own bot: its token from @BotFather (123456789:AAH...)."
          },
          "telegramChatId": {
            "title": "Telegram chat id",
            "type": "string",
            "description": "The chat the bot posts to: a chat id (-1001234567890) or a public channel (@mychannel, with the bot as an admin)."
          },
          "historyName": {
            "title": "History name",
            "type": "string",
            "description": "The named key-value store that keeps the fares Only changes compares with (default google-flights-history). Each search keeps its own record in it, so schedules can share one."
          },
          "currency": {
            "title": "Currency",
            "type": "string",
            "description": "The currency of every price: USD (default), EUR, GBP, CAD, INR..."
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "The country Google Flights is shown for (two letters: US by default, GB, CA, IN). Fares can differ by country."
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "The language of place and airline names (en by default, de, fr, pt-BR)."
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "Leave it off: the Actor reads Google Flights through its own residential proxy, included in the price. Your own proxy URLs are used instead if you give them; an Apify Proxy setting isn't used."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}