{ "openapi": "3.0.1", "info": { "title": "Skyscanner Flights Scraper - One-Way, Return and Multi-City", "description": "Search Skyscanner for one-way, return and multi-city flights on the routes and dates you give. Keep only what fits: stops, airlines, times, journey length, price. One row per itinerary with the lowest price, who sells it, flight numbers, times and stops.", "version": "0.1", "x-build-id": "xy2FHypF1zxhbY3Pw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~skyscanner-flights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-skyscanner-flights-scraper", "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/dami_studio~skyscanner-flights-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-skyscanner-flights-scraper", "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/dami_studio~skyscanner-flights-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-skyscanner-flights-scraper", "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", "maxItems": 50, "type": "array", "description": "One search per route and date. A one-way route is {\"origin\": \"JFK\", \"destination\": \"LAX\", \"date\": \"2026-10-20\"} or the short form \"JFK-LAX-2026-10-20\". For a return, add \"returnDate\", or write \"JFK-LAX-2026-10-20-2026-10-27\". For a multi-city trip, put two or three legs in order under \"legs\", each with its own origin, destination and date. Add \"lastDate\" to a one-way or return route to search every departure day from \"date\" to it, 7 days at most: each day is a search of its own, so four days means four lists of itineraries to pay for, and on a return the return date moves along with it. Use airport codes such as LHR or JFK, or a city code such as LON, NYC or PAR for every airport in that city. With no date, a one-way route searches the day 30 days after the run. Up to 50 searches a run. They wait together, so five take about as long as one." }, "searchUrls": { "title": "Skyscanner links", "maxItems": 50, "type": "array", "description": "Links to Skyscanner results pages, one per line, each run as a search. The airports, dates, adults, children's ages, cabin and 'direct flights only' come from the link; the market, currency and filters come from this form. A link for a whole month, or for more than three legs, is refused. If a link asks for nearby airports, only the airports it names are searched, and PROBLEMS says so.", "items": { "type": "string" } }, "market": { "title": "Market", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Which country's Skyscanner to search, as a two-letter code: US, UK, CA, DE and so on. For the United Kingdom it is UK; GB is accepted and treated as UK.", "default": "US" }, "locale": { "title": "Locale", "pattern": "^[A-Za-z]{2}[-_][A-Za-z]{2}$", "type": "string", "description": "Locale sent with the search, such as en-US or en-GB. Keep it in step with the market.", "default": "en-US" }, "currency": { "title": "Currency", "pattern": "^[A-Za-z]{3}$", "type": "string", "description": "Currency for the prices, as a three-letter code such as USD, GBP or EUR.", "default": "USD" }, "adults": { "title": "Adults", "minimum": 1, "maximum": 8, "type": "integer", "description": "Adult passengers, 1 to 8. The price on each row is for everyone on the booking, children included, not a price per person.", "default": 1 }, "childAges": { "title": "Children's ages", "type": "array", "description": "One age per child: [8, 1] is an eight-year-old and a baby. Ages 0 to 17, up to 8 children. Under 2 counts as an infant, and each infant needs an adult. Leave it empty if only adults are flying." }, "cabinClass": { "title": "Cabin class", "enum": [ "economy", "premium_economy", "business", "first" ], "type": "string", "description": "Which cabin to price.", "default": "economy" }, "maxStops": { "title": "Stops", "enum": [ "any", "0", "1", "2" ], "type": "string", "description": "Counted per leg, so on a return both directions have to pass.", "default": "any" }, "maxPrice": { "title": "Maximum price", "minimum": 1, "type": "number", "description": "For the whole group, in the currency above. Anything dearer is dropped." }, "maxDurationHours": { "title": "Maximum journey time", "minimum": 1, "maximum": 72, "type": "number", "description": "Per leg, from its first take-off to its last landing, connections included. 7.5 is seven and a half hours." }, "airlines": { "title": "Only these airlines", "maxItems": 30, "type": "array", "description": "Two-character codes such as BA, U2 or B6, or names such as British Airways. An itinerary stays only if every flight in it is sold by one of them.", "items": { "type": "string" } }, "excludeAirlines": { "title": "Leave out these airlines", "maxItems": 30, "type": "array", "description": "Codes or names, as above. An itinerary is dropped if any flight in it is sold by one of them, or flown by one on another airline's behalf.", "items": { "type": "string" } }, "departureTimeRange": { "title": "Departure time", "pattern": "^\\s*\\d{1,2}:\\d{2}\\s*-\\s*\\d{1,2}:\\d{2}\\s*$", "type": "string", "description": "When the outbound leg leaves, local time, on the 24-hour clock: 06:00-12:00. A range such as 22:00-06:00 runs past midnight. On a multi-city trip this and the arrival time apply to the first leg only." }, "arrivalTimeRange": { "title": "Arrival time", "pattern": "^\\s*\\d{1,2}:\\d{2}\\s*-\\s*\\d{1,2}:\\d{2}\\s*$", "type": "string", "description": "When the outbound leg lands, local time at the airport it lands at, such as 12:00-20:00." }, "returnDepartureTimeRange": { "title": "Return departure time", "pattern": "^\\s*\\d{1,2}:\\d{2}\\s*-\\s*\\d{1,2}:\\d{2}\\s*$", "type": "string", "description": "Return trips only: when the journey home leaves, local time, such as 15:00-21:00." }, "returnArrivalTimeRange": { "title": "Return arrival time", "pattern": "^\\s*\\d{1,2}:\\d{2}\\s*-\\s*\\d{1,2}:\\d{2}\\s*$", "type": "string", "description": "Return trips only: when the journey home lands, local time." }, "sortBy": { "title": "Order", "enum": [ "cheapest", "fastest", "earliest", "best" ], "type": "string", "description": "Fastest counts the whole trip, both ways on a return. Best is this Actor's own ranking, not the one on Skyscanner's site: each itinerary's price divided by the cheapest one's, plus its journey time divided by the quickest one's, lowest first.", "default": "cheapest" }, "maxItinerariesPerRoute": { "title": "Maximum itineraries per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Taken from the top once the filters and the order have run, so Fastest first with 10 gives the ten quickest that pass. A busy route has several hundred itineraries and a return can have over a thousand, and you pay for each one delivered.", "default": 500 } } }, "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 } } } } } } } } } }