{
  "openapi": "3.0.1",
  "info": {
    "title": "Skyscanner Scraper - Flights, Price Calendar & Everywhere",
    "description": "Scrape Skyscanner flights: every itinerary with price, all booking sites with prices and links, legs, segments, layovers, CO2. One-way, round trip, multi-city, flexible dates, 12-month price calendar, Everywhere deals, any market and currency, monitor mode. $0.90 per 1,000 itineraries.",
    "version": "0.1",
    "x-build-id": "RnglEi7O5gdMDdVid"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~skyscanner-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-skyscanner-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/topapi~skyscanner-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-skyscanner-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/topapi~skyscanner-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-skyscanner-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": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "flights",
              "calendar",
              "everywhere"
            ],
            "type": "string",
            "description": "flights = every itinerary for a route and date (price, every booking site with its price and link, legs, segments, layovers, CO2). calendar = the cheapest one-way fare for every day of the next 12 months. everywhere = the cheapest destinations from your origin (also chosen automatically when Destination is \"Everywhere\" or a country).",
            "default": "flights"
          },
          "origin": {
            "title": "From",
            "type": "string",
            "description": "Airport or city: an IATA code (JFK, LHR, NYC, LON), a name (London, Paris Orly) or a Skyscanner place id."
          },
          "destination": {
            "title": "To",
            "type": "string",
            "description": "Airport or city, a country (Italy) for its cheapest cities, or \"Everywhere\" for the cheapest destinations."
          },
          "departDate": {
            "title": "Departure date",
            "type": "string",
            "description": "YYYY-MM-DD, or +N for N days from today (+30). Empty = in 30 days. For Everywhere a month (YYYY-MM) also works. A past date moves forward by whole years."
          },
          "returnDate": {
            "title": "Return date (round trip)",
            "type": "string",
            "description": "YYYY-MM-DD or +N days. Empty = one-way."
          },
          "departDateEnd": {
            "title": "Departure date range end (flexible dates)",
            "type": "string",
            "description": "Search every departure day from Departure date to this date (up to 62 days). A return date keeps the same trip length."
          },
          "routes": {
            "title": "More routes (batch)",
            "type": "array",
            "description": "Several searches in one run: strings like \"JFK-LAX\" or \"JFK-LAX 2027-01-20 2027-01-27\", or objects {\"origin\":\"JFK\",\"destination\":\"LAX\",\"departDate\":\"2027-01-20\",\"returnDate\":\"2027-01-27\"}, or {\"legs\":[...]} for multi-city. Passengers, cabin, filters and market apply to all."
          },
          "startUrls": {
            "title": "Skyscanner search URLs",
            "type": "array",
            "description": "Paste skyscanner.* /transport/flights/{from}/{to}/{yymmdd}/{yymmdd}/ or /transport/flights-from/{from}/ links; route, dates, passengers and cabin are read from the link.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "multiCityLegs": {
            "title": "Multi-city legs",
            "type": "array",
            "description": "Extra legs after From -> To, e.g. [{\"origin\":\"LHR\",\"destination\":\"CDG\",\"date\":\"2027-02-01\"}]. A leg without a date departs 3 days after the previous one."
          },
          "adults": {
            "title": "Adults",
            "minimum": 1,
            "maximum": 9,
            "type": "integer",
            "description": "1-9. Prices are for all travellers together; pricePerPerson divides by adults + children.",
            "default": 1
          },
          "childAges": {
            "title": "Children's ages",
            "type": "array",
            "description": "One age (2-17) per child, e.g. [5, 9]."
          },
          "infants": {
            "title": "Infants (on lap, under 2)",
            "minimum": 0,
            "maximum": 8,
            "type": "integer",
            "description": "Babies under 2 on a lap; Skyscanner prices them with the adults."
          },
          "cabinClass": {
            "title": "Cabin class",
            "enum": [
              "economy",
              "premium_economy",
              "business",
              "first"
            ],
            "type": "string",
            "description": "Economy, premium economy, business or first.",
            "default": "economy"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "best",
              "cheapest",
              "fastest",
              "departure"
            ],
            "type": "string",
            "description": "best = Skyscanner's own ranking score.",
            "default": "best"
          },
          "maxStops": {
            "title": "Max stops per leg",
            "enum": [
              "any",
              "0",
              "1",
              "2"
            ],
            "type": "string",
            "description": "Stops allowed on each leg.",
            "default": "any"
          },
          "airlines": {
            "title": "Only these airlines",
            "type": "array",
            "description": "IATA codes or names (BA, UA, Ryanair): keeps itineraries flown only by these marketing carriers.",
            "items": {
              "type": "string"
            }
          },
          "excludeAirlines": {
            "title": "Exclude airlines",
            "type": "array",
            "description": "IATA codes: drops itineraries with any segment sold by these carriers.",
            "items": {
              "type": "string"
            }
          },
          "maxPrice": {
            "title": "Max price (total, in your currency)",
            "minimum": 0,
            "type": "integer",
            "description": "Drops itineraries (and destinations, calendar days) above this price."
          },
          "maxDurationMinutes": {
            "title": "Max duration per leg (minutes)",
            "minimum": 0,
            "type": "integer",
            "description": "Drops itineraries with any leg longer than this."
          },
          "excludeSelfTransfer": {
            "title": "Exclude self-transfer itineraries",
            "type": "boolean",
            "description": "Drops self-transfer itineraries (separate tickets you connect yourself).",
            "default": false
          },
          "maxResultsPerSearch": {
            "title": "Max rows per search",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Itineraries (or destinations) kept per search, after filters and sorting. Skyscanner returns the whole result set (often 300-600 itineraries); a calendar search returns every day in its window.",
            "default": 100
          },
          "maxItems": {
            "title": "Max rows in total",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap for the whole run; never more rows are delivered or charged. Empty = no cap."
          },
          "maxAgentsPerFlight": {
            "title": "Booking sites per itinerary",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How many booking sites (airline and agents, cheapest first, each with price, rating and booking link) each itinerary lists.",
            "default": 20
          },
          "calendarEndDate": {
            "title": "Calendar end date",
            "type": "string",
            "description": "calendar mode: last day to return (YYYY-MM-DD or +N). The window starts at Departure date (or today)."
          },
          "market": {
            "title": "Market (country you book from)",
            "type": "string",
            "description": "Two-letter country code: US, UK, DE, FR, IN, AU... It changes which fares and booking sites Skyscanner shows. Empty = US (or the site of a pasted URL)."
          },
          "currency": {
            "title": "Currency",
            "type": "string",
            "description": "ISO code (USD, GBP, EUR...). Empty = the market's own currency."
          },
          "locale": {
            "title": "Language",
            "type": "string",
            "description": "e.g. en-US, en-GB, de-DE. Empty = the market's own."
          },
          "monitorMode": {
            "title": "Monitor mode (only new or re-priced rows)",
            "type": "boolean",
            "description": "Remembers each row's price between runs and delivers only rows that are new or whose price changed, with previousPrice and priceChange. Unchanged rows are not delivered or charged. For scheduled fare tracking.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Keeps separate memories for separate schedules (letters, digits, dashes)."
          },
          "monitorDeliver": {
            "title": "Monitor delivers",
            "enum": [
              "changes",
              "drops"
            ],
            "type": "string",
            "description": "In monitor mode: deliver every price change, or only drops (new rows are always delivered).",
            "default": "changes"
          },
          "resetMonitor": {
            "title": "Reset monitor memory",
            "type": "boolean",
            "description": "Forget the monitor memory first, so this run delivers every row as new.",
            "default": false
          },
          "includeSearchSummary": {
            "title": "Add a free summary row per search",
            "type": "boolean",
            "description": "One unbilled row per flight search: total found, matching your filters, cheapest direct / 1-stop / 2+-stop fare, fastest time.",
            "default": false
          },
          "flattenOutput": {
            "title": "Flat rows (spreadsheet columns)",
            "type": "boolean",
            "description": "Nested legs, segments and booking sites become dashed columns (legs-0-segments-0-flightNumber).",
            "default": false
          },
          "maxPollSeconds": {
            "title": "Max seconds to wait for a search to settle",
            "minimum": 10,
            "maximum": 90,
            "type": "integer",
            "description": "Skyscanner streams partner prices in over 5-35 s; each search is read until it settles or this time passes (empty = 40). A run of only a few rows reads for less, so its compute stays under what it bills; those rows carry resultsComplete: false."
          },
          "maxConcurrency": {
            "title": "Searches at a time",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Empty = 3 at 256 MB, 5 at 512 MB, 8 at 1 GB+."
          },
          "proxyConfiguration": {
            "title": "Proxy (optional: your own proxy URLs)",
            "type": "object",
            "description": "Leave empty: the actor picks its exits (direct, then fresh Apify datacenter sessions, then residential). Your own proxy URLs are used as given."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}