{ "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 } } } } } } } } } }