# Flight Price Tracker: Google Flights Fares by Route (`scrapemint/flight-price-tracker`) Actor
Track Google Flights fares by route and date. Returns airline, stops, duration, price, and cabin class for every option. Filter by max stops, max price, preferred airlines, nonstop only. Schedule daily to catch price drops. JSON output. Pay per item.
- **URL**: https://apify.com/scrapemint/flight-price-tracker.md
- **Developed by:** [Kennedy Mutisya](https://apify.com/scrapemint) (community)
- **Categories:** Automation, E-commerce, Travel
- **Stats:** 5 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use 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
## Flight Price Tracker: Google Flights Fares by Route and Date
Track live Google Flights fares for any route and date. Every row has airline, stops, total duration, price, cabin class, and stop airports. Works for every IATA airport pair (JFK to LHR, SFO to NRT, LHR to DXB). Filter by max stops, max price, preferred airlines, nonstop only. Pay per fare row.
**Ranks for:** flight price tracker, Google Flights scraper, cheap flight alerts, airline fare monitor, route price history, travel deal API, flight price history, nonstop flight search.
---
### How it works
```mermaid
flowchart LR
A[Route + dates] --> B[Google Flights search]
B --> C[Parse fare list]
C --> D[Filter stops, price,
airline]
D --> E[JSON fare rows]
````
Paste a route like JFK-LHR and a date range. One row per fare option.
***
### Who uses this
| Role | Use case |
|---|---|
| **Travel blogger** | Publish daily best fare tables by route. |
| **Mileage hacker** | Watch for saver awards priced below a threshold. |
| **Corporate travel ops** | Audit paid fares against market median for the route. |
| **Deal site** | Power a "cheap flights from your city" feed without Skyscanner Partner approval. |
| **Fintech travel app** | Feed live price history into a rewards dashboard. |
***
### Quick start
**One way deal watch:**
```json
{
"routes": ["JFK-LHR", "JFK-CDG", "JFK-FCO"],
"departDaysAhead": 21,
"dateWindowDays": 7,
"maxPriceUsd": 500,
"maxStops": 1
}
```
**Round trip, specific dates:**
```json
{
"routes": ["SFO-NRT"],
"departureDates": ["2026-06-15"],
"returnDates": ["2026-06-29"],
"tripType": "round_trip",
"cabinClass": "business"
}
```
**Nonstop only, preferred airline:**
```json
{
"routes": ["LHR-DXB"],
"preferredAirlines": ["BA", "EK"],
"maxStops": 0
}
```
***
### Output flags
```mermaid
flowchart LR
A[Fare row] --> B[nonstop]
A --> C[cheap
under $200]
A --> D[premium_fare
over $2000]
A --> E[short_haul
under 3h]
A --> F[long_haul
over 10h]
A --> G[cabin_business
cabin_first]
```
Flags let pipelines filter without parsing titles again.
***
### Flight tracker vs the alternatives
| | Skyscanner Partner API | Amadeus self service | **This actor** |
|---|---|---|---|
| Access | Affiliate approval | Free account + keys | Anyone |
| Setup | Weeks | One hour | 60 seconds |
| Route coverage | Global | Global | Global |
| Price history | No | No | Yes via dedupe off |
| Schedule | Yes | Yes | Every 60s |
| JSON output | Yes | Yes | Yes |
| Pricing | Rev share | Tiered by query | Pay per item |
***
### Sample output
```json
{
"source": "google_flights",
"origin": "JFK",
"destination": "LHR",
"departureDate": "2026-05-15",
"returnDate": null,
"tripType": "one_way",
"cabinClass": "economy",
"passengers": 1,
"airline": "British Airways",
"airlineCode": "BA",
"stops": 0,
"durationMinutes": 425,
"durationLabel": "7h 5m",
"priceTotal": 487,
"pricePerPax": 487,
"priceCurrency": "USD",
"departTime": "6:00 PM",
"arriveTime": "6:25 AM",
"stopAirports": [],
"flags": ["nonstop", "long_haul"],
"sourceUrl": "https://www.google.com/travel/flights?..."
}
```
***
### Pricing
First 50 fares per run are free. After that pay per fare row. A daily snapshot of 10 routes and 14 days lands under $5.
***
### FAQ
**Do I need a Google API key?**
No. The actor reads public Google Flights pages.
**Can I track price changes over time?**
Yes. Set `dedupe: false` and schedule every hour. Each run writes a fresh snapshot with a `scrapedAt` timestamp so you build your own price history table.
**Which airports are supported?**
Every airport with a valid three letter IATA code. JFK, LHR, SFO, NRT, CDG, DXB, SIN, SYD, GRU and so on.
**Does Google block scrapers?**
Google Flights is less aggressive than OTAs but still rate limits. The actor ships with residential proxy by default. Lower concurrency if you run at high volume.
**Is the price total or per passenger?**
Price is the total for the party. `pricePerPax` is the total divided by passenger count.
**Can I get business and first class fares?**
Yes. Set `cabinClass` to premium\_economy, business, or first.
**Is scraping Google Flights allowed?**
This actor reads the same public HTML a browser sees. Respect the site's terms and rate limit sensibly.
***
### Related Scrapemint actors
- **Viator Scraper** for tours and activities by city
- **Airbnb Market Intelligence** for short term rental data
- **Booking Review Intelligence** for hotel reviews by city
- **TripAdvisor Review Intelligence** for hotel and restaurant reviews
- **Google Reviews Intelligence** for places reviews
Stack these to cover every public travel surface from research to booking.
# Actor input Schema
## `routes` (type: `array`):
IATA route pairs like JFK-LHR, SFO-NRT, LHR-JFK. Three letter airport codes separated by a dash. One row per airline option on each route and date.
## `departureDates` (type: `array`):
ISO dates like 2026-05-15. Leave blank to use departDaysAhead and dateWindowDays for a rolling window.
## `returnDates` (type: `array`):
Optional return dates aligned with departureDates. Leave blank for one way searches.
## `departDaysAhead` (type: `integer`):
Used when departureDates is blank. Starts the rolling window this many days from today.
## `dateWindowDays` (type: `integer`):
Used when departureDates is blank. Number of consecutive days to scan starting at departDaysAhead.
## `tripType` (type: `string`):
one\_way or round\_trip. round\_trip uses return dates if provided, otherwise adds 7 nights to each departure.
## `cabinClass` (type: `string`):
economy, premium\_economy, business, or first.
## `passengers` (type: `integer`):
Number of adult passengers. Price per the whole party.
## `maxStops` (type: `integer`):
0 for nonstop only, 1 for up to one stop, 2 for any itinerary. Default 2.
## `maxPriceUsd` (type: `number`):
Drop fares above this. Use with a daily schedule for price drop alerts.
## `minPriceUsd` (type: `number`):
Drop fares below this. Useful to filter out error fare noise.
## `preferredAirlines` (type: `array`):
IATA airline codes like BA, DL, UA, LH. Keeps only flights operated by listed carriers. Leave empty for all.
## `excludeAirlines` (type: `array`):
IATA airline codes to drop. Useful to avoid a carrier you never book.
## `maxItemsPerRoute` (type: `integer`):
Cap on fares pushed per route and date combination. Google Flights typically lists 8 to 15 options.
## `maxItemsTotal` (type: `integer`):
Hard cap on rows per run. Controls cost.
## `dedupe` (type: `boolean`):
Skip fares seen on previous runs. Turn off to build your own price history dataset.
## `proxyConfiguration` (type: `object`):
Apify proxy. Residential recommended for hourly schedules.
## Actor input object example
```json
{
"routes": [
"JFK-LHR"
],
"departureDates": [],
"returnDates": [],
"departDaysAhead": 30,
"dateWindowDays": 7,
"tripType": "one_way",
"cabinClass": "economy",
"passengers": 1,
"maxStops": 2,
"maxPriceUsd": 0,
"minPriceUsd": 0,
"preferredAirlines": [],
"excludeAirlines": [],
"maxItemsPerRoute": 20,
"maxItemsTotal": 200,
"dedupe": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# 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 = {
"routes": [
"JFK-LHR"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapemint/flight-price-tracker").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 = { "routes": ["JFK-LHR"] }
# Run the Actor and wait for it to finish
run = client.actor("scrapemint/flight-price-tracker").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"routes": [
"JFK-LHR"
]
}' |
apify call scrapemint/flight-price-tracker --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapemint/flight-price-tracker",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Flight Price Tracker: Google Flights Fares by Route",
"description": "Track Google Flights fares by route and date. Returns airline, stops, duration, price, and cabin class for every option. Filter by max stops, max price, preferred airlines, nonstop only. Schedule daily to catch price drops. JSON output. Pay per item.",
"version": "0.1",
"x-build-id": "5KmHOiV1PkWpuk8cd"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapemint~flight-price-tracker/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapemint-flight-price-tracker",
"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/scrapemint~flight-price-tracker/runs": {
"post": {
"operationId": "runs-sync-scrapemint-flight-price-tracker",
"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/scrapemint~flight-price-tracker/run-sync": {
"post": {
"operationId": "run-sync-scrapemint-flight-price-tracker",
"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": "IATA route pairs like JFK-LHR, SFO-NRT, LHR-JFK. Three letter airport codes separated by a dash. One row per airline option on each route and date.",
"items": {
"type": "string"
}
},
"departureDates": {
"title": "Departure dates",
"type": "array",
"description": "ISO dates like 2026-05-15. Leave blank to use departDaysAhead and dateWindowDays for a rolling window.",
"default": [],
"items": {
"type": "string"
}
},
"returnDates": {
"title": "Return dates",
"type": "array",
"description": "Optional return dates aligned with departureDates. Leave blank for one way searches.",
"default": [],
"items": {
"type": "string"
}
},
"departDaysAhead": {
"title": "Depart days ahead",
"minimum": 1,
"maximum": 365,
"type": "integer",
"description": "Used when departureDates is blank. Starts the rolling window this many days from today.",
"default": 30
},
"dateWindowDays": {
"title": "Date window (days)",
"minimum": 1,
"maximum": 60,
"type": "integer",
"description": "Used when departureDates is blank. Number of consecutive days to scan starting at departDaysAhead.",
"default": 7
},
"tripType": {
"title": "Trip type",
"enum": [
"one_way",
"round_trip"
],
"type": "string",
"description": "one_way or round_trip. round_trip uses return dates if provided, otherwise adds 7 nights to each departure.",
"default": "one_way"
},
"cabinClass": {
"title": "Cabin class",
"enum": [
"economy",
"premium_economy",
"business",
"first"
],
"type": "string",
"description": "economy, premium_economy, business, or first.",
"default": "economy"
},
"passengers": {
"title": "Passengers",
"minimum": 1,
"maximum": 9,
"type": "integer",
"description": "Number of adult passengers. Price per the whole party.",
"default": 1
},
"maxStops": {
"title": "Max stops",
"minimum": 0,
"maximum": 2,
"type": "integer",
"description": "0 for nonstop only, 1 for up to one stop, 2 for any itinerary. Default 2.",
"default": 2
},
"maxPriceUsd": {
"title": "Max price ($)",
"minimum": 0,
"type": "number",
"description": "Drop fares above this. Use with a daily schedule for price drop alerts.",
"default": 0
},
"minPriceUsd": {
"title": "Min price ($)",
"minimum": 0,
"type": "number",
"description": "Drop fares below this. Useful to filter out error fare noise.",
"default": 0
},
"preferredAirlines": {
"title": "Preferred airlines",
"type": "array",
"description": "IATA airline codes like BA, DL, UA, LH. Keeps only flights operated by listed carriers. Leave empty for all.",
"default": [],
"items": {
"type": "string"
}
},
"excludeAirlines": {
"title": "Exclude airlines",
"type": "array",
"description": "IATA airline codes to drop. Useful to avoid a carrier you never book.",
"default": [],
"items": {
"type": "string"
}
},
"maxItemsPerRoute": {
"title": "Max items per route",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Cap on fares pushed per route and date combination. Google Flights typically lists 8 to 15 options.",
"default": 20
},
"maxItemsTotal": {
"title": "Max items per run",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Hard cap on rows per run. Controls cost.",
"default": 200
},
"dedupe": {
"title": "Deduplicate across runs",
"type": "boolean",
"description": "Skip fares seen on previous runs. Turn off to build your own price history dataset.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify proxy. Residential recommended for hourly schedules.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```