MCP + API · kestrel/google-flights-prices

Google Flights Scraper — Airfare Prices, Fares & Price Tracking

Get Google Flights prices by route, dates, cabin and passengers. One row per itinerary: price, airline, times, duration, stops, layovers, CO2. One-way or round trip; nonstop and business class fares. Sweep dates for a fare calendar. Schedule daily flight price tracking to build price history.

Open Actor Download MCP config

Connect this tool

Add this URL as a remote MCP server in your client, then sign in to Apify. For a client-specific setup, use Apify's configurator.

https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/google-flights-prices
Generic MCP client configuration
{
  "mcpServers": {
    "kestrel-google-flights-prices": {
      "url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/google-flights-prices"
    }
  }
}

Understand the output before you run

Two row types share one dataset: flight (one itinerary for a route, date and cabin) and status (one per route and date; never charged).

Declared dataset fields and row types · Output locations and dataset links

Use the declared dataset schema for item fields; the output schema describes where results are stored. Optional fields may be null or absent. If an integration shows a sampled schema without an optional field, check this declaration, the Actor instructions and actual returned rows before concluding that the field is unsupported.

Inspect 43 declared output fields
FieldTypeMeaning
typestringRow type: flight or status.
routestring / nullThe route as given, e.g. "LIS-LHR".
origin_querystring / nullOrigin code as searched.
destination_querystring / nullDestination code as searched.
depart_datestring / nullDeparture date, YYYY-MM-DD.
return_datestring / nullReturn date for round trips, null for one-way.
tripstring / nullone_way or round_trip.
seatstring / nullCabin priced: economy, premium_economy, business or first.
adultsinteger / nullAdults the price covers.
childreninteger / nullChildren the price covers.
infantsinteger / nullInfants the price covers (seat + lap).
currencystring / nullCurrency of the price (ISO code), as Google actually priced it.
max_stopsinteger / nullStop limit applied to the search, null when unrestricted.
rankinteger / nullPosition in Google's ranking for the search; 1 is its top pick.
pricenumber / nullPrice for all passengers. For round trips this is the total for both legs.
price_displaystring / nullPrice exactly as Google states it, e.g. "127 US dollars".
round_trip_totalboolean / nullTrue when the price covers both legs of a round trip.
airlinestring / nullOperating airline; the first when several operate the itinerary.
airlinesarray / nullEvery airline operating the itinerary.
stopsinteger / nullNumber of stops; 0 is nonstop.
depart_timestring / nullDeparture time, local to the origin.
depart_daystring / nullDeparture day as Google states it.
arrive_timestring / nullArrival time, local to the destination.
arrive_daystring / nullArrival day as Google states it — later than the departure day on overnight flights.
depart_airportstring / nullFull name of the origin airport.
arrive_airportstring / nullFull name of the destination airport.
originstring / nullOrigin airport code on the itinerary.
destinationstring / nullDestination airport code on the itinerary.
durationstring / nullTotal travel time as Google states it, e.g. "2 hr 55 min".
duration_minutesinteger / nullTotal travel time in minutes — the sortable form.
layoversarray / nullEach layover: index, of, minutes, airport, city.
layover_airportsarray / nullLayover airport names, in order.
overnight_layoverboolean / nullTrue when Google flags an overnight layover.
co2_kginteger / nullGoogle's carbon estimate for the itinerary, in kilograms.
emissions_vs_typicalinteger / nullPercent above or below the typical emissions for the route.
google_urlstring / nullThe Google Flights URL for this exact search — opens the same results.
searchesinteger / nullStatus rows: searches run for this route and date.
flightsinteger / nullStatus rows: itinerary rows delivered.
duplicatesinteger / nullStatus rows: itineraries already delivered by an overlapping search, not billed again.
cheapestnumber / nullStatus rows: lowest price found for this route and date.
statusstring / nullStatus rows: ok, no_results or error.
errorstring / nullStatus rows: why the search failed, null when it did not.
fetched_atstring / nullUTC timestamp when the row was fetched.

Start with a small sample

Use call-actor with the JSON below. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Change the target to match your request. This input validates against build 1.1.5; it is not a promise that the source has matching rows today.

{
  "actor": "kestrel/google-flights-prices",
  "input": {
    "routes": [
      "LIS-LHR"
    ],
    "departDate": "30 days",
    "sweepDays": 0,
    "currency": "EUR",
    "market": "pt"
  },
  "callOptions": {
    "maxTotalChargeUsd": 0.25,
    "timeout": 300
  },
  "waitSecs": 30
}

After completion, use get-dataset-items with storages.datasets.default.id. If still running, poll get-actor-run using the returned runId. Check status rows and errors before treating an empty dataset as no matches.

Call from Python, JavaScript or REST

Python SDK 3 example · JavaScript SDK 2 example · curl + jq example. Each uses this same small input, reads APIFY_TOKEN from your environment, sets a five-minute run timeout and exports all dataset row types as JSON Lines. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Inspect the run and source status before treating results as complete. Installation and usage.

Pricing and limits

Current listed event prices in USD. Some Actors charge for successful source checks even when no output rows match. The event descriptions below define those differences.

EventUSD eachWhat is charged
flight$0.005One flight itinerary for your route, dates, cabin and passengers: price for all passengers, airline, departure and arrival times, duration, stops, layovers, CO2 (row keys route, origin, destination, depart_date, return_date, seat, adults, price, currency, airline, stops, depart_time, arrive_time, duration_minutes, layovers, co2_kg, rank, google_url): $5 per 1,000 itineraries. Usually 10 to 35 rows per route and date; maxResultsPerSearch caps them. Not charged: empty or failed searches, duplicates (an itinerary two overlapping searches both return is billed once), status rows, refused inputs. No start fee; proxy and compute are included in the event price. The run stops at the maximum cost per run you set when starting it (Apify run option maxTotalChargeUsd), never above it.

Contracts for agents

Public contract checked 2026-11-11. Active build: 1.1.5. Refresh live details before a large or recurring run.