Skyscanner API Bulk (Flights) Actor

Overview

This actor programmatically queries Skyscanner for flight data. It supports fetching prices, listing providers, and retrieving calendar-based pricing. Output is returned as raw JSON for integration into other systems.

Key Features

• Multiple Query Types: Get flight prices, list flight providers, or fetch monthly/daily calendar prices.
• Flexible Itineraries: Supports one-way, round-trip, and complex multi-city searches.
• Open Search: Use "everywhere" as a destination to find all available flights from an origin.
• Detailed Parameters: Filter by cabin class, passenger counts (adults/children), direct flights, and nearby airports.
• Bulk Processing: Handles multiple search queries in a single run via a JSON array.

How to Use

Configure the actor via its input parameters.

Core Parameters:
* Process: Select the operation (Get Flight Prices, Get Flight Providers, Get Calendar Prices).
* Market: Choose a country/locale (sets domain, currency, language).
* Query: A JSON array containing one or more search objects (see below).
* Retries/Delay: Adjust based on search complexity. Simple searches need fewer retries (e.g., 2) and shorter waits (e.g., 3 seconds). Complex multi-city searches may require more retries (e.g., 5+) and longer delays.

Query Fields (JSON Object):
Define your search within the Query array. Use IATA airport codes (e.g., "lax") for best performance.

Round-trip/One-way Example:

{
  "origin": "cdg",
  "destination": "lyon", // Use "everywhere" for open search
  "datefrom": "251004", // Format: YYMMDD
  "dateto": "251007",
  "adults": 2,
  "children": [5, 10], // Array of child ages
  "classtype": "economy",
  "direct": false
}

Multi-city Example:
Multi-city searches override the origin/destination and date fields. Provide paired arrays for airports and dates.

{
  "adults": 1,
  "children": [15],
  "classtype": "business",
  "multifrom": ["yvr", "lax", "lax", "las"], // Itinerary: YVR->LAX, LAX->LAS
  "multidates": ["2025-09-01", "2025-09-15"]
}

Note: The nearbyAirports parameter is ignored for multi-city searches.

Input/Output

Input: The primary input is the Query JSON array. Skyscanner prices are rounded up on their public website; this API returns exact amounts (e.g., $708.01 instead of $709).

Output: The actor returns raw, structured JSON. The schema varies by process.

For Get Flight Providers:
Returns a list of airlines/alliances.

{
  "query": "...",
  "currency": "USD",
  "data": [{
    "providers": [{
      "id": "aa",
      "name": "American Airlines",
      "isCarrier": true,
      "rating": 4.1,
      "feedbackCount": 1200
    }],
    "alliances": [{ "id": 1, "name": "oneworld" }]
  }]
}

For Get Flight Prices:
Returns detailed itineraries with pricing, booking links, and metadata.

{
  "query": "...",
  "currency": "USD",
  "data": [{
    "id": "itinerary_123",
    "price": 708.01,
    "legs": [...],
    "vendor": "Booking.com",
    "url": "https://www.skyscanner.net/...",
    "eco": 245.2, // CO2 emissions estimate
    "score": 95.5 // Recommendation score
  }]
}