{ "openapi": "3.0.1", "info": { "title": "Skyscanner API (Flights)", "description": "Get the best flight itineraries and calendar prices from Skyscanner! Supports one-way and round trips with various filters. It's fast and costs little!", "version": "2.4", "x-build-id": "NAmUGhzNzljPmv8um" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/canadesk~skyscanner-flights-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-canadesk-skyscanner-flights-api", "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/canadesk~skyscanner-flights-api/runs": { "post": { "operationId": "runs-sync-canadesk-skyscanner-flights-api", "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/canadesk~skyscanner-flights-api/run-sync": { "post": { "operationId": "run-sync-canadesk-skyscanner-flights-api", "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": { "process": { "title": "Process", "enum": [ "gfp", "gfa", "gcm", "gcd" ], "type": "string", "description": "", "default": "gfp" }, "query": { "title": "Query", "type": "array", "description": "Optional list of trips; replaces the single-trip fields. Supports origin/destination or multifrom/multidates for multi-city." }, "market": { "title": "Market", "enum": [ "United States", "Afghanistan", "Albania", "Algeria", "American Samoa", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "België", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Brasil", "British Virgin Islands", "Brunei", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Caribbean Netherlands", "Cayman Islands", "Central African Republic", "Chad", "Chile", "Christmas Island", "Città del Vaticano", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Cook Islands", "Costa Rica", "Cuba", "Curacao", "DR Congo", "Danmark", "Deutschland", "Djibouti", "Dominica", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "España", "Estonia", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "France", "French Polynesia", "Fürstentum Liechtenstein", "Gabon", "Gambia", "Georgia", "Ghana", "Gibraltar", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Guyane Française", "Haiti", "Honduras", "Hrvatska", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italia", "Ivory Coast", "Jamaica", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Lithuania", "Luxembourg", "Macau", "Madagascar", "Magyarország", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "México", "Namibia", "Nauru", "Nederland", "Nepal", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norge", "North Korea", "Northern Mariana Islands", "Oman", "Pakistan", "Palau", "Palestinian Territories", "Panamá", "Papua New Guinea", "Paraguay", "Perú", "Philippines", "Polska", "Portugal", "Principat d'Andorra", "Puerto Rico", "Qatar", "Republic of Macedonia", "República Dominicana", "Reunion", "România", "Rwanda", "Saint Barthelemy", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Samoa", "Sao Tome and Principe", "Saudi Arabia", "Schweiz", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Slovenia", "Slovensko", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Sudan", "Sri Lanka", "St Maarten", "St. Helena", "St. Pierre and Miquelon", "Sudan", "Suomi", "Suriname", "Sverige", "Swaziland", "Syria", "Tajikistan", "Tanzania", "Togo", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Türkiye", "US Virgin Islands", "Uganda", "United Arab Emirates", "United Kingdom", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Việt Nam", "Wallis and Futuna Islands", "Yemen", "Zambia", "Zimbabwe", "Österreich", "Česká republika", "Ελλάδα", "Κύπρος", "Беларусь", "България", "Россия", "Україна", "ไทย", "中国", "台灣", "日本", "香港", "대한민국" ], "type": "string", "description": "Simulates user country.", "default": "United States" }, "origin": { "title": "Flight origin", "type": "string", "description": "E.g., LAX or Los Angeles" }, "destination": { "title": "Flight destination", "type": "string", "description": "E.g., LAS or Las Vegas." }, "datefrom": { "title": "Departure date", "type": "string", "description": "Departure date, YYMMDD or YYYY-MM-DD. Defaults to 30 days from today." }, "dateto": { "title": "Return date", "type": "string", "description": "Leave empty for one-way flights. Format: YYMMDD." }, "adults": { "title": "Number of adults", "minimum": 1, "maximum": 8, "type": "integer", "description": "", "default": 1 }, "children": { "title": "Number of children", "type": "array", "description": "Must be of type INT < 16. Maximum 8 entries." }, "classtype": { "title": "Cabin class", "enum": [ "economy", "premiumeconomy", "business", "first" ], "type": "string", "description": "", "default": "economy" }, "maxResults": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Maximum flights, providers, calendar dates or destinations across all searches.", "default": 1000 }, "direct": { "title": "Direct flights only", "type": "boolean", "description": "", "default": false }, "nearby": { "title": "Nearby airports", "enum": [ "none", "all", "from", "to" ], "type": "string", "description": "", "default": "none" }, "format": { "title": "Group results by search", "type": "boolean", "description": "Keep results under a data array per search. Disable for individual flight or calendar rows.", "default": true }, "delay": { "title": "Delay", "minimum": 0, "maximum": 30, "type": "integer", "description": "Seconds between source requests, including polls.", "default": 2 }, "retries": { "title": "Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum additional polls while flight results are loading.", "default": 3 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 } } } } } } } } } }