{ "openapi": "3.0.1", "info": { "title": "Google Flights Smart Search β€” Natural-Language Flight Deals", "description": "Type a trip in plain English and get the best flight deals across every date and destination combination. Pay per search β€” $2.50 / 1,000 searches; the natural-language translation is free.", "version": "1.2", "x-build-id": "4zZ71qeBE4auHlmcQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/good-apis~google-flights-smart-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-good-apis-google-flights-smart-search", "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/good-apis~google-flights-smart-search/runs": { "post": { "operationId": "runs-sync-good-apis-google-flights-smart-search", "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/good-apis~google-flights-smart-search/run-sync": { "post": { "operationId": "run-sync-good-apis-google-flights-smart-search", "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": { "query": { "title": "Flight request (free text)", "type": "string", "description": "Describe the trip in plain English β€” origins, destination(s), dates, nights, direct, cabin, budget, passengers. Relative dates work: 'tomorrow', 'this weekend', 'next Monday', 'next week', 'in 3 days'. Leave this blank to use one of the ready-made samples below." }, "example": { "title": "…or pick a sample to start from", "enum": [ "", "3-5 night trip from Tel Aviv to Barcelona, Paris or London anytime in August, direct only", "one way from New York to London next Monday, business class", "round trip Madrid to New York, Dec 22 to Jan 2, premium economy", "cheapest flight from Boston to Miami this weekend", "weekend getaway from Berlin to Rome or Barcelona, 2 nights, any weekend in September, direct", "family trip, 2 adults and 2 kids, Chicago to Orlando, 5 nights in June", "round trip from London to Tokyo, 7-10 nights, next month, avoid layovers over 4 hours" ], "type": "string", "description": "Pick a ready-made example to see how it works. Used only if the free-text field above is left blank.", "default": "" }, "max_searches": { "title": "Max searches (spend cap)", "minimum": 1, "maximum": 120, "type": "integer", "description": "The most flight searches the fan-out will run. You are billed only for searches actually performed, so this is your spend cap. More searches = broader coverage of dates/destinations.", "default": 40 }, "top_n": { "title": "Number of deals to return", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many ranked (cheapest-first) deals to return.", "default": 20 }, "currency": { "title": "Currency", "type": "string", "description": "Currency code for prices (e.g. USD, EUR, GBP).", "default": "USD" } } }, "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 } } } } } } } } } }