{ "openapi": "3.0.1", "info": { "title": "Flight Price Tracker — Cheapest Day to Fly & Airfare Alerts", "description": "Flight price tracker for Google Flights: the cheapest fare for every departure day in your window, one row per day with price, airline, stops and times, ranked so the cheapest day to fly is row one. Set a max price and only days under it are delivered and billed. Pay per fare row.", "version": "1.0", "x-build-id": "XXubYl77os7lh5lnu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kestrel~flight-price-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kestrel-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/kestrel~flight-price-tracker/runs": { "post": { "operationId": "runs-sync-kestrel-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/kestrel~flight-price-tracker/run-sync": { "post": { "operationId": "run-sync-kestrel-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", "required": [ "routes", "departDate" ], "properties": { "routes": { "title": "Routes", "uniqueItems": true, "type": "array", "description": "Routes as airport codes, one per line: \"LIS-LHR\", \"JFK-LAX\". Google's city codes work too (NYC-LON searches every New York and London airport). Each route is tracked across every day of the window.", "items": { "type": "string" } }, "departDate": { "title": "First departure day", "type": "string", "description": "The first day of the window: YYYY-MM-DD, or relative so a scheduled run never goes stale: \"30 days\", \"6 weeks\", \"tomorrow\". Past dates are rejected." }, "days": { "title": "Days in the window", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many consecutive departure days to price, starting on the first day. 14 = two weeks of fares; 30 = a month. One search and at most one billed row per day.", "default": 14 }, "tripLengthDays": { "title": "Trip length (round trips)", "minimum": 0, "maximum": 60, "type": "integer", "description": "0 = one-way fares. N = every day is priced as a round trip returning N days after departure, and the price is the total for both legs.", "default": 0 }, "seat": { "title": "Cabin", "enum": [ "economy", "premium_economy", "business", "first" ], "type": "string", "description": "Cabin to price. Business and first are a different, smaller market than economy.", "default": "economy" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Adult passengers. Every price is the total for all of them.", "default": 1 }, "maxStops": { "title": "Stops", "enum": [ "any", "nonstop", "one_or_fewer", "two_or_fewer" ], "type": "string", "description": "Limit connections before picking the day's cheapest fare. \"Nonstop only\" tracks the fare most travellers actually want; \"Any\" takes the cheapest of everything Google lists.", "default": "any" }, "maxPrice": { "title": "Max price (alert mode)", "minimum": 0, "type": "number", "description": "0 = deliver every day. N = deliver only days whose cheapest fare is at or under N in the currency below. Days over the line are dropped BEFORE billing, so an alert run that finds nothing costs nothing.", "default": 0 }, "currency": { "title": "Currency", "type": "string", "description": "ISO code for every price, e.g. USD, EUR, GBP. If Google prices in another currency for your market the day is reported as an error rather than billed in the wrong one.", "default": "USD" }, "market": { "title": "Market (country)", "type": "string", "description": "Two-letter country code for the Google market (gl), e.g. us, de, gb. Fares and available airlines differ by market. Results are always read in English.", "default": "us" }, "sessions": { "title": "Parallel sessions", "minimum": 1, "maximum": 16, "type": "integer", "description": "How many proxy sessions (egress IPs) run in parallel. More is faster; each one is paced separately.", "default": 4 }, "perIp": { "title": "Requests per second per IP", "minimum": 0.1, "maximum": 2, "type": "number", "description": "Pace for each session. Google tolerates about 0.5/s per IP; raising it causes retries, not speed.", "default": 0.5 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy is required: Google blocks datacentre traffic that is not rotated. The default group works.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }