{ "openapi": "3.0.1", "info": { "title": "Google Flights Deals Scraper", "description": "Describe a trip in plain English and let Google pick the destinations, or get the routes it is currently selling well below their usual price. Each row carries the fare, the fare that route normally costs, the saving, the dates, the airline, journey time and stops.", "version": "1.0", "x-build-id": "d0ZsMRPpQxSeT3CCr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/boncross~google-flights-deals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-boncross-google-flights-deals", "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/boncross~google-flights-deals/runs": { "post": { "operationId": "runs-sync-boncross-google-flights-deals", "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/boncross~google-flights-deals/run-sync": { "post": { "operationId": "run-sync-boncross-google-flights-deals", "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": { "prompt": { "title": "Describe the trip", "type": "string", "description": "Say what you want in plain English and Google picks the destinations: \"3 day trip to somewhere in Germany\", \"a week on a beach in Spain\", \"skiing in the Alps in January\". Leave blank to get the standard discounted-destination list instead." }, "origin": { "title": "Origin airport or city", "type": "string", "description": "The airport you would fly from, such as LHR. A city code such as LON searches every airport in that city, and several codes separated by commas search them together. You can also type a place name such as \"Barcelona\" or \"Heathrow\" and it is resolved for you." }, "extraOrigins": { "title": "More origins", "type": "array", "description": "Additional origins, one per line. Each is searched separately and returns its own deals. You can also type a place name such as \"Barcelona\" or \"Heathrow\" and it is resolved for you.", "items": { "type": "string" } }, "departureDate": { "title": "Departure date", "type": "string", "description": "Optional. Google picks each deal's own dates and uses this only as a starting point, so the deals come back on their own dates, usually not this one. Leave it empty and the search starts a month out. YYYY-MM-DD." }, "returnDate": { "title": "Return date", "type": "string", "description": "Optional, as with the outbound date: a starting point, not a filter. Leave it empty for a week after the outbound date. YYYY-MM-DD." }, "maxItems": { "title": "Maximum deals", "minimum": 1, "type": "integer", "description": "A ceiling on the whole run. Nothing past it is fetched or charged for." }, "minSavingPercent": { "title": "Minimum saving", "minimum": 0, "maximum": 99, "type": "integer", "description": "Only keep deals at least this far below what the route usually costs, as a percentage. Works with a prompt too. A deal the site shows no usual price for is dropped when this is set.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 1, "type": "integer", "description": "Only keep deals at or under this total price." }, "nonstop": { "title": "Nonstop only", "type": "boolean", "description": "Only keep destinations reached without changing plane. Google does not always honour this on its own, so connecting deals are removed here as well.", "default": false }, "maxDurationMinutes": { "title": "Maximum journey time", "minimum": 30, "type": "integer", "description": "Longest acceptable one-way journey, in minutes." }, "cabinClass": { "title": "Cabin", "enum": [ "economy", "premium_economy", "business", "first" ], "type": "string", "description": "Cabin to price the deals in.", "default": "economy" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult passengers.", "default": 1 }, "currency": { "title": "Currency", "type": "string", "description": "Three letter currency code, such as USD or GBP. Default USD.", "default": "USD" }, "language": { "title": "Language", "type": "string", "description": "Two letter language code for place names, such as en.", "default": "en" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 32, "type": "integer", "description": "How many requests run at once across the whole run. The default is the fastest level measured clean; lower it only if a run reports refusals or errors.", "default": 32 }, "restartAttempt": { "title": "Restart attempt (internal)", "type": "integer", "description": "Set by the actor when it restarts itself in a fresh container after capturing nothing. Leave it alone.", "default": 0 } } }, "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 } } } } } } } } } }