{
  "openapi": "3.0.1",
  "info": {
    "title": "Skyscanner Scraper — $0.80/1K flights, agents & calendar",
    "description": "Scrape Skyscanner flight prices by route and date: price, airlines, flight numbers, stops, layovers, times, duration, and every travel agent with its price, rating and booking link. One-way, round trip, multi-city and a 12-month price calendar. Export, schedule, or call via API and MCP.",
    "version": "0.1",
    "x-build-id": "cTgfPbClPc0ThrzPa"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lergassy~skyscanner-flights-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lergassy-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/lergassy~skyscanner-flights-scraper/runs": {
      "post": {
        "operationId": "runs-sync-lergassy-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/lergassy~skyscanner-flights-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-lergassy-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": {
          "origin": {
            "title": "🛫 From",
            "type": "string",
            "description": "Enter the departure airport or city: an IATA code (<code>JFK</code>, <code>LHR</code>), a city code that covers every airport of the city (<code>NYCA</code>, <code>LOND</code>) or a city name. Separate several with commas to search every combination."
          },
          "destination": {
            "title": "🛬 To",
            "type": "string",
            "description": "Enter the arrival airport or city, in the same formats as From. Several, comma-separated, are searched one by one."
          },
          "departureDate": {
            "title": "📅 Departure date",
            "type": "string",
            "description": "Date as <code>YYYY-MM-DD</code>, or <code>+30</code> for \"30 days from today\" (keeps saved tasks and schedules from going stale). Several dates, comma-separated, each become a search. In Price calendar mode it is the first day of the calendar (optional)."
          },
          "returnDate": {
            "title": "🔁 Return date (round trip)",
            "type": "string",
            "description": "Leave empty for one-way. <code>YYYY-MM-DD</code> or <code>+37</code>. Must be on or after the departure date."
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "flights",
              "calendar"
            ],
            "type": "string",
            "description": "<b>Flights</b>: one row per itinerary for each search. <b>Price calendar</b>: one row per departure day with the cheapest one-way price Skyscanner has seen, for the next ~12 months, from one fast request per route.",
            "default": "flights"
          },
          "startUrls": {
            "title": "🔗 Skyscanner search URLs",
            "type": "array",
            "description": "Paste Skyscanner flight search links, e.g. <code>https://www.skyscanner.net/transport/flights/lond/nyca/261210/261217/?adultsv2=2</code>. Route, dates, passengers and cabin are read from the link. Any Skyscanner domain works.",
            "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": "For a multi-city / open-jaw trip, list 2–6 legs as <code>[{\"origin\":\"LHR\",\"destination\":\"JFK\",\"date\":\"2026-12-05\"},{\"origin\":\"BOS\",\"destination\":\"LHR\",\"date\":\"2026-12-12\"}]</code>. Searched as one trip, in addition to the From/To fields."
          },
          "adults": {
            "title": "👤 Adults",
            "minimum": 1,
            "maximum": 9,
            "type": "integer",
            "description": "Number of adult passengers (16+). Prices are for all passengers together.",
            "default": 1
          },
          "childAges": {
            "title": "🧒 Children ages",
            "type": "array",
            "description": "Ages of children (0–15), one number per child, e.g. <code>[4, 9]</code>. Age under 2 counts as an infant on lap."
          },
          "cabinClass": {
            "title": "💺 Cabin class",
            "enum": [
              "economy",
              "premium_economy",
              "business",
              "first"
            ],
            "type": "string",
            "description": "Cabin to search.",
            "default": "economy"
          },
          "maxResultsPerSearch": {
            "title": "💯 Max flights per search",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many itineraries to keep from each search, after filters and sorting. Skyscanner returns 10–2,000 per search; every kept row is billed.",
            "default": 50
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "best",
              "cheapest",
              "fastest"
            ],
            "type": "string",
            "description": "Order in which itineraries are kept and written. Best follows Skyscanner's own score (price, duration and stops).",
            "default": "best"
          },
          "maxStops": {
            "title": "Max stops",
            "enum": [
              "any",
              "0",
              "1",
              "2"
            ],
            "type": "string",
            "description": "Keep only itineraries where no leg has more stops than this.",
            "default": "any"
          },
          "airlines": {
            "title": "✈️ Airlines (IATA codes)",
            "type": "array",
            "description": "Keep only itineraries flown by at least one of these airlines, by 2-letter code: <code>BA</code>, <code>AA</code>, <code>DL</code>. Empty = all airlines.",
            "items": {
              "type": "string"
            }
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Drop itineraries above this total price, in the selected currency. Empty = no limit."
          },
          "excludeSelfTransfer": {
            "title": "Exclude self-transfer",
            "type": "boolean",
            "description": "Drop itineraries where you have to collect bags and check in again between separate tickets.",
            "default": false
          },
          "maxAgentsPerFlight": {
            "title": "Agents per flight",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "How many booking options (travel agents and airlines, each with price, rating and booking link) to list in the <code>agents</code> column of each row, cheapest first. 0 = only the cheapest one in <code>cheapestAgent</code>/<code>bookingUrl</code>.",
            "default": 20
          },
          "market": {
            "title": "🌍 Market (country)",
            "type": "string",
            "description": "2-letter country of the point of sale (<code>US</code>, <code>UK</code>, <code>DE</code>, <code>ID</code>, <code>AU</code>…). Skyscanner shows different agents and prices per market.",
            "default": "US"
          },
          "currency": {
            "title": "💱 Currency",
            "type": "string",
            "description": "ISO currency for all prices: <code>USD</code>, <code>EUR</code>, <code>GBP</code>, <code>IDR</code>…",
            "default": "USD"
          },
          "locale": {
            "title": "Language",
            "type": "string",
            "description": "Language of place names, e.g. <code>en-US</code>, <code>en-GB</code>, <code>de-DE</code>.",
            "default": "en-US"
          },
          "calendarEndDate": {
            "title": "Calendar end date",
            "type": "string",
            "description": "Price calendar mode only: last day to include (<code>YYYY-MM-DD</code> or <code>+90</code>). Empty = everything Skyscanner has (about 12 months)."
          },
          "includeRunSummary": {
            "title": "Add a free summary row",
            "type": "boolean",
            "description": "Add one free row at the end of the dataset: rows delivered and events charged. Filter it out with <code>type != \"notice\"</code>.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}