{
  "data": {
    "id": "OMvw5q04TgfysjBFw",
    "actId": "ytrWZsmBw1kEQ4GSQ",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-18T18:33:53.112Z",
    "finishedAt": "2026-11-18T18:34:05.116Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 11925,
      "runTimeSecs": 11.925,
      "computeUnits": 0.01325,
      "imageSizeBytes": 358419456
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Skiplagged Route Fare & Booking Provider Finder Input\",\n  \"description\": \"Search Skiplagged for flight fares by route, batch of routes, pasted search URLs, or a flexible-date price calendar. Returns prices, airlines, flight numbers, layovers, hidden-city flags and booking providers.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch. `search` uses one origin/destination, `byRoutes` reads the routes array, `byUrls` parses pasted Skiplagged URLs, and `calendar` returns a flexible-date price calendar for one route.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byRoutes\",\n        \"byUrls\",\n        \"calendar\"\n      ],\n      \"enumTitles\": [\n        \"Search one route\",\n        \"Search multiple routes\",\n        \"Search from pasted Skiplagged URLs\",\n        \"Flexible-date price calendar\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"origin\": {\n      \"title\": \"Origin\",\n      \"type\": \"string\",\n      \"description\": \"Origin airport/metro code (`JFK`, `NYC`), Skiplagged city slug (`new-york`, `tokyo`, `dubai-emirate`) or city name (`New York`). Mode=search and mode=calendar.\",\n      \"editor\": \"textfield\",\n      \"default\": \"NYC\",\n      \"prefill\": \"NYC\",\n      \"sectionCaption\": \"Route\",\n      \"sectionDescription\": \"The route searched in mode=search and mode=calendar. Airport codes, metro codes, city names and Skiplagged slugs are accepted.\"\n    },\n    \"destination\": {\n      \"title\": \"Destination\",\n      \"type\": \"string\",\n      \"description\": \"Destination airport/metro code (`LHR`, `LON`), Skiplagged city slug (`tokyo`, `dubai-emirate`) or city name (`London`).\",\n      \"editor\": \"textfield\",\n      \"default\": \"LON\",\n      \"prefill\": \"LON\"\n    },\n    \"departDate\": {\n      \"title\": \"Departure date\",\n      \"type\": \"string\",\n      \"description\": \"Departure date as `YYYY-MM-DD`. Leave blank to use six weeks from today. Past dates advance to a future month, and a past round-trip gap is preserved.\",\n      \"editor\": \"textfield\"\n    },\n    \"returnDate\": {\n      \"title\": \"Return date\",\n      \"type\": \"string\",\n      \"description\": \"Return date as `YYYY-MM-DD` for a round-trip search. Leave blank for one-way.\",\n      \"editor\": \"textfield\"\n    },\n    \"originAirports\": {\n      \"title\": \"Origin airports\",\n      \"type\": \"array\",\n      \"description\": \"Optional exact airports to search instead of `origin`, e.g. `[\\\"JFK\\\", \\\"EWR\\\"]`. When set, these override the single origin value (mode=search, byRoutes).\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": [],\n      \"sectionCaption\": \"Airport coverage\",\n      \"sectionDescription\": \"Optional multi-airport and nearby-airport options. Metro codes already cover every airport in the city; these options let you choose specific airports or extend the search area.\"\n    },\n    \"destinationAirports\": {\n      \"title\": \"Destination airports\",\n      \"type\": \"array\",\n      \"description\": \"Optional exact airports to search instead of `destination`, e.g. `[\\\"LHR\\\", \\\"LGW\\\"]`. When set, these override the single destination value (mode=search, byRoutes).\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"includeNearbyAirports\": {\n      \"title\": \"Include nearby airports\",\n      \"type\": \"boolean\",\n      \"description\": \"Also search airports near the origin and destination (e.g. HPN and ISP around New York). Ignored when an airport list is set (mode=search, byRoutes, byUrls).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"expandAirports\": {\n      \"title\": \"Expand metro routes for more rows\",\n      \"type\": \"boolean\",\n      \"description\": \"Skiplagged returns at most about 300 itineraries per leg. When on, the actor also searches each airport of the smaller side of a metro route (e.g. JFK, EWR and LGA for NYC) and merges the unique results. Costs a few extra requests (mode=search, byRoutes, byUrls).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"routes\": {\n      \"title\": \"Routes (mode=byRoutes)\",\n      \"type\": \"array\",\n      \"description\": \"Batch of routes, one object per route: `{\\\"origin\\\":\\\"NYC\\\",\\\"destination\\\":\\\"LON\\\",\\\"departDate\\\":\\\"2026-09-01\\\",\\\"returnDate\\\":\\\"2026-09-08\\\"}`. `returnDate`, `originAirports` and `destinationAirports` are optional.\",\n      \"editor\": \"json\",\n      \"default\": [],\n      \"prefill\": [],\n      \"sectionCaption\": \"Batch inputs\",\n      \"sectionDescription\": \"Inputs used by mode=byRoutes and mode=byUrls.\"\n    },\n    \"startUrls\": {\n      \"title\": \"Skiplagged URLs (mode=byUrls)\",\n      \"type\": \"array\",\n      \"description\": \"Skiplagged flight-search URLs, e.g. `https://skiplagged.com/flights/NYC/LON/2026-09-01/2026-09-08`, `https://skiplagged.com/flights/LON/dubai-emirate/2026-09-17` or `https://skiplagged.com/flights/NYC/tokyo/2026-09-17`. Airport codes and multi-word or single-word city slugs are accepted.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"tripType\": {\n      \"title\": \"Trip type\",\n      \"type\": \"string\",\n      \"description\": \"One-way, round-trip, or auto-detect from whether a return date is present.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"auto\",\n        \"one-way\",\n        \"round-trip\"\n      ],\n      \"enumTitles\": [\n        \"Auto-detect from dates\",\n        \"One-way only\",\n        \"Round-trip only\"\n      ],\n      \"default\": \"auto\",\n      \"prefill\": \"auto\",\n      \"sectionCaption\": \"Trip and passengers\",\n      \"sectionDescription\": \"Cabin and passenger mix are sent to Skiplagged, and the returned itinerary reports the passenger counts and fare class it actually priced.\"\n    },\n    \"cabinClass\": {\n      \"title\": \"Cabin class\",\n      \"type\": \"string\",\n      \"description\": \"Requested cabin. `premium-economy` is sent as Skiplagged's `premium` fare class. The real fare class returned by Skiplagged is always included on each record as `fareClass`.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"economy\",\n        \"premium-economy\",\n        \"business\",\n        \"first\"\n      ],\n      \"enumTitles\": [\n        \"Economy\",\n        \"Premium economy\",\n        \"Business\",\n        \"First\"\n      ],\n      \"default\": \"economy\",\n      \"prefill\": \"economy\"\n    },\n    \"adults\": {\n      \"title\": \"Adults\",\n      \"type\": \"integer\",\n      \"description\": \"Number of adult passengers (12+). Prices on each record are the total for the requested passenger mix.\",\n      \"minimum\": 1,\n      \"maximum\": 9,\n      \"default\": 1,\n      \"prefill\": 1\n    },\n    \"children\": {\n      \"title\": \"Children\",\n      \"type\": \"integer\",\n      \"description\": \"Number of child passengers (2-11).\",\n      \"minimum\": 0,\n      \"maximum\": 8,\n      \"default\": 0,\n      \"prefill\": 0\n    },\n    \"infantsLap\": {\n      \"title\": \"Infants (on lap)\",\n      \"type\": \"integer\",\n      \"description\": \"Number of lap infants (under 2, no seat).\",\n      \"minimum\": 0,\n      \"maximum\": 8,\n      \"default\": 0,\n      \"prefill\": 0\n    },\n    \"infantsSeat\": {\n      \"title\": \"Infants (own seat)\",\n      \"type\": \"integer\",\n      \"description\": \"Number of infants (under 2) with their own seat.\",\n      \"minimum\": 0,\n      \"maximum\": 8,\n      \"default\": 0,\n      \"prefill\": 0\n    },\n    \"directOnly\": {\n      \"title\": \"Direct flights only\",\n      \"type\": \"boolean\",\n      \"description\": \"Only emit nonstop itineraries to the deplaning airport.\",\n      \"default\": false,\n      \"prefill\": false,\n      \"sectionCaption\": \"Filters\",\n      \"sectionDescription\": \"Optional filters applied after the search response. Leave them unset or false to keep every itinerary.\"\n    },\n    \"maxStops\": {\n      \"title\": \"Max stops\",\n      \"type\": \"integer\",\n      \"description\": \"Drop itineraries with more stops than this before the deplaning airport. 0 means nonstop.\",\n      \"minimum\": 0,\n      \"maximum\": 3,\n      \"default\": 3,\n      \"prefill\": 3\n    },\n    \"minPrice\": {\n      \"title\": \"Min price (USD)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop itineraries cheaper than this total price in whole USD.\",\n      \"minimum\": 0,\n      \"maximum\": 50000\n    },\n    \"maxPrice\": {\n      \"title\": \"Max price (USD)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop itineraries pricier than this total price in whole USD.\",\n      \"minimum\": 0,\n      \"maximum\": 50000\n    },\n    \"airlines\": {\n      \"title\": \"Include airlines\",\n      \"type\": \"array\",\n      \"description\": \"Only emit itineraries that include at least one of these 2-letter IATA airline codes, e.g. `AA`, `BA`, `DL`.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"excludeAirlines\": {\n      \"title\": \"Exclude airlines\",\n      \"type\": \"array\",\n      \"description\": \"Drop itineraries that include any of these 2-letter IATA airline codes.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"hiddenCity\": {\n      \"title\": \"Hidden-city itineraries\",\n      \"type\": \"string\",\n      \"description\": \"Include all itineraries, keep only hidden-city fares, or drop hidden-city fares. Hidden-city itineraries end at a different ticketed airport than your destination; check airline baggage and missed-leg rules before booking.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"include\",\n        \"only\",\n        \"exclude\"\n      ],\n      \"enumTitles\": [\n        \"Include all itineraries\",\n        \"Only hidden-city itineraries\",\n        \"Exclude hidden-city itineraries\"\n      ],\n      \"default\": \"include\",\n      \"prefill\": \"include\"\n    },\n    \"departAfter\": {\n      \"title\": \"Depart after (HH:MM)\",\n      \"type\": \"string\",\n      \"description\": \"Keep itineraries whose first departure is at or after this local time, e.g. `08:00`.\",\n      \"editor\": \"textfield\"\n    },\n    \"departBefore\": {\n      \"title\": \"Depart before (HH:MM)\",\n      \"type\": \"string\",\n      \"description\": \"Keep itineraries whose first departure is at or before this local time, e.g. `22:00`.\",\n      \"editor\": \"textfield\"\n    },\n    \"arriveAfter\": {\n      \"title\": \"Arrive after (HH:MM)\",\n      \"type\": \"string\",\n      \"description\": \"Keep itineraries whose deplaning arrival is at or after this local time.\",\n      \"editor\": \"textfield\"\n    },\n    \"arriveBefore\": {\n      \"title\": \"Arrive before (HH:MM)\",\n      \"type\": \"string\",\n      \"description\": \"Keep itineraries whose deplaning arrival is at or before this local time.\",\n      \"editor\": \"textfield\"\n    },\n    \"maxDurationMinutes\": {\n      \"title\": \"Max duration (minutes)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop itineraries longer than this many minutes to the deplaning airport, e.g. `600` for 10 hours.\",\n      \"minimum\": 0,\n      \"maximum\": 10080\n    },\n    \"maxLayoverMinutes\": {\n      \"title\": \"Max layover (minutes)\",\n      \"type\": \"integer\",\n      \"description\": \"Drop itineraries with any layover longer than this many minutes.\",\n      \"minimum\": 0,\n      \"maximum\": 10080\n    },\n    \"sortBy\": {\n      \"title\": \"Sort by\",\n      \"type\": \"string\",\n      \"description\": \"Order of emitted records within each route.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"price\",\n        \"duration\",\n        \"departureTime\",\n        \"stops\"\n      ],\n      \"enumTitles\": [\n        \"Price\",\n        \"Duration\",\n        \"Departure time\",\n        \"Stops\"\n      ],\n      \"default\": \"price\",\n      \"prefill\": \"price\",\n      \"sectionCaption\": \"Output\",\n      \"sectionDescription\": \"Record ordering and the run-wide result cap.\"\n    },\n    \"sortOrder\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"Ascending (cheapest/shortest/earliest/fewest first) or descending.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"asc\",\n        \"desc\"\n      ],\n      \"enumTitles\": [\n        \"Ascending\",\n        \"Descending\"\n      ],\n      \"default\": \"asc\",\n      \"prefill\": \"asc\"\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on emitted records for the whole run, across all routes.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 50,\n      \"prefill\": 3\n    },\n    \"calendarStartDate\": {\n      \"title\": \"Calendar start date (mode=calendar)\",\n      \"type\": \"string\",\n      \"description\": \"First date to include in the flexible-date calendar as `YYYY-MM-DD`. Leave blank to start from the earliest returned day.\",\n      \"editor\": \"textfield\",\n      \"sectionCaption\": \"Calendar\",\n      \"sectionDescription\": \"Options for mode=calendar. The calendar always covers the next 61 days returned by Skiplagged.\"\n    },\n    \"calendarDays\": {\n      \"title\": \"Calendar days (mode=calendar)\",\n      \"type\": \"integer\",\n      \"description\": \"How many days of the calendar to return, counting from the start date. For round-trip calendars this applies per calendar type (departure and return), so up to twice as many rows can be returned.\",\n      \"minimum\": 1,\n      \"maximum\": 61,\n      \"default\": 30,\n      \"prefill\": 7\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Skiplagged Route Fare & Booking Provider Finder\n\nScrape **Skiplagged** flight fares — including the hidden-city and self-transfer itineraries Skiplagged is known for — and get one clean record per itinerary with the price, airlines, flight numbers, layovers, stops, hidden-city flag and every booking provider that quotes the fare. Search one route, batch many routes in one run, paste Skiplagged search links, or pull a flexible-date price calendar. No login, no cookies, no proxy setup.\n\n## What this actor does\n\n- **Four modes:** `search` (one route), `byRoutes` (many routes in one run), `byUrls` (paste Skiplagged flight-search links), `calendar` (daily prices for the next 61 days)\n- **Hidden-city aware:** every itinerary records whether the ticket ends beyond your destination, where you actually get off, and the true ticketed airport\n- **Self-transfer aware:** `virtualInterline` marks separately ticketed/virtual-interline combinations from Skiplagged's itinerary-level `vi` flag\n- **Real cabin and passenger pricing:** economy, premium economy, business and first; adults, children and lap/seated infants are sent correctly and the returned counts are reported\n- **Failures stay visible:** a route whose retries are exhausted is named in the run status while successful routes are still emitted\n- **Booking providers:** all providers with their prices (`bookingOptions`) plus the cheapest provider names (`bookingProviders`)\n- **Filters:** nonstop, max stops, price band, include/exclude airlines, hidden-city include/only/exclude, departure/arrival time windows, max duration, max layover, sort direction\n- **Whole-metro coverage:** airport codes, metro codes, city names and Skiplagged slugs; optional nearby-airport search and metro expansion for more than 300 rows\n- **Empty fields are omitted** — no `null` values in the dataset\n\n## Output per flight itinerary\n\n- `flightId`, `legType` — `outbound` or `inbound`\n- `originAirport`, `originAirportName`, `originCity`, `originState`, `originCountry`\n- `destinationAirport`, `destinationAirportName`, `destinationCity`, `destinationState`, `destinationCountry` — the airport where you get off\n- State/province is emitted only when Skiplagged returns that airport as a single-airport result. Metro and multi-airport searches omit it rather than mixing a metro-level state with an airport-level city (for example, Newark/EWR would otherwise contradict “New York”). Country is omitted when the source reports a multi-country list.\n- `departureTime`, `arrivalTime` — ISO 8601 with timezone offset; `arrivalTime` is the deplaning arrival\n- `durationMinutes`, `duration` — travel time to the deplaning airport (e.g. `7h 30m`)\n- `stops`, `direct` — stops before the deplaning airport\n- `hiddenCity` — `true` when the ticket continues past your destination\n- `ticketedDestinationAirport`, `ticketedDestinationCity`, `ticketedStops` — present only on hidden-city rows: where the ticket really ends\n- `virtualInterline` — `true` when Skiplagged marks the itinerary as a self-transfer/virtual-interline combination (`vi` in the source)\n- `airlines[]`, `airlineCodes[]`, `primaryAirline`\n- `segments[]` — one entry per flight leg: `airlineCode`, `airlineName`, `flightNumber`, `departureAirport`, `departureAirportName`, `departureTime`, `arrivalAirport`, `arrivalAirportName`, `arrivalTime`, `durationMinutes`; legs after the deplaning point carry `beyondTicket: true`\n- `layovers[]` — one entry per connection before deplaning: `airport`, `airportName`, `durationMinutes`, `duration`\n- `price`, `currency` — total price for the requested passenger mix, in USD\n- `fareClass` — cabin Skiplagged actually priced; `requestedCabinClass` — what you asked for\n- `adults`, `children`, `infantsLap`, `infantsSeat` — passenger counts Skiplagged returned\n- `bookingOptions[]` — every provider and its price: `provider`, `price`\n- `bookingProviders[]` — provider name(s) quoting the lowest price\n- `minRoundTripPrice` — combined round-trip total when Skiplagged quotes one (outbound rows)\n- `departDate`, `returnDate`, `originQuery`, `destinationQuery`, `searchedOriginAirports[]`, `searchedDestinationAirports[]` — the airport lists are the overall searched sets, including expansion rows\n- `rank` — position within the route after filtering and sorting; `routeIndex` in batch modes\n- `sourceUrl` — the Skiplagged search-results page for this route and date (Cloudflare-protected; works in a browser, bare HTTP clients may receive 403)\n- `recordType: \"skiplaggedFlight\"`, `scrapedAt`\n\n## Output per fare-calendar row (mode = `calendar`)\n\n- `recordType: \"skiplaggedFareCalendar\"`, `calendarType` — `departure` or `return`\n- `departDate`, `returnDate`, `tripType`\n- `originCode`, `destinationCode`, `originCity`, `destinationCity`, `originAirports[]`, `destinationAirports[]`\n- `price`, `currency` — round-trip total when a return date is involved, otherwise the one-way price\n- `oneWayPrice` — one-way price when Skiplagged quotes it next to a round-trip total\n- `priceLevel` — `low` or `high` when Skiplagged marks the day\n- `fareClass`, `requestedCabinClass`, `adults`, `children`, `infantsLap`, `infantsSeat`\n- `sourceUrl`, `rank`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `byRoutes` / `byUrls` / `calendar` |\n| `origin` | string | `NYC` | Origin airport/metro code, city name or Skiplagged slug (mode=search, calendar) |\n| `destination` | string | `LON` | Destination airport/metro code, city name or Skiplagged slug |\n| `departDate` | string | – | `YYYY-MM-DD`; blank = six weeks from today; past dates advance to a future month and a past round-trip gap is preserved |\n| `returnDate` | string | – | `YYYY-MM-DD`; blank = one-way |\n| `originAirports` | array | `[]` | Exact airports to search instead of `origin`, e.g. `[\"JFK\",\"EWR\"]` |\n| `destinationAirports` | array | `[]` | Exact airports to search instead of `destination` |\n| `includeNearbyAirports` | bool | `false` | Also search airports near both ends; ignored when airport lists are set |\n| `expandAirports` | bool | `false` | Split a metro route into the smaller side's airports to get past the 300-row cap; raise `maxItems` above 300 to see the extra rows |\n| `routes` | array | `[]` | Batch of `{origin, destination, departDate, returnDate}` objects (mode=byRoutes) |\n| `startUrls` | array | `[]` | Skiplagged flight-search URLs, codes or slugs, including single-word slugs such as `tokyo` (mode=byUrls) |\n| `tripType` | string | `auto` | `auto` / `one-way` / `round-trip` |\n| `cabinClass` | string | `economy` | `economy` / `premium-economy` / `business` / `first` |\n| `adults` | int | `1` | Adults (1-9); prices are totals for the whole party |\n| `children` | int | `0` | Children (0-8) |\n| `infantsLap` | int | `0` | Lap infants (0-8) |\n| `infantsSeat` | int | `0` | Seated infants (0-8) |\n| `directOnly` | bool | `false` | Only nonstop itineraries to the deplaning airport |\n| `maxStops` | int | `3` | Maximum stops before deplaning (0 = nonstop) |\n| `minPrice` | int | – | Minimum total price in whole USD |\n| `maxPrice` | int | – | Maximum total price in whole USD |\n| `airlines` | array | `[]` | Only itineraries flying at least one of these IATA airline codes |\n| `excludeAirlines` | array | `[]` | Drop itineraries flying any of these IATA airline codes |\n| `hiddenCity` | string | `include` | `include` / `only` / `exclude` |\n| `departAfter` | string | – | First departure at or after this local `HH:MM` |\n| `departBefore` | string | – | First departure at or before this local `HH:MM` |\n| `arriveAfter` | string | – | Deplaning arrival at or after this local `HH:MM` |\n| `arriveBefore` | string | – | Deplaning arrival at or before this local `HH:MM` |\n| `maxDurationMinutes` | int | – | Maximum minutes to the deplaning airport |\n| `maxLayoverMinutes` | int | – | Maximum minutes for any layover |\n| `sortBy` | string | `price` | `price` / `duration` / `departureTime` / `stops` |\n| `sortOrder` | string | `asc` | `asc` / `desc` |\n| `maxItems` | int | `50` | Run-wide record cap (1-1000) |\n| `calendarStartDate` | string | – | First calendar date `YYYY-MM-DD` (mode=calendar) |\n| `calendarDays` | int | `30` | Days per calendar type (mode=calendar); a round-trip calendar can return departure and return rows, up to twice this many |\n\nDefaults: `[]` means empty; `–` means unset. Field names above are the exact JSON keys.\n\n### Example: hidden-city only, nonstop to London\n\n```json\n{\n  \"mode\": \"search\",\n  \"origin\": \"NYC\",\n  \"destination\": \"LON\",\n  \"departDate\": \"2026-12-12\",\n  \"hiddenCity\": \"only\",\n  \"maxStops\": 0,\n  \"sortBy\": \"price\",\n  \"maxItems\": 20\n}\n```\n\nPinned control case (verified 2026-11-18): NYC→LON on `2026-12-12` returned 11 hidden economy rows (all nonstop to the deplaning airport) and 28/28 hidden business rows. Use that date and cabin for deterministic hidden-city checks; other dates can legitimately return zero hidden rows because the 300-row result set is source-variable.\n\n### Example: round-trip business with filters\n\n```json\n{\n  \"mode\": \"search\",\n  \"origin\": \"JFK\",\n  \"destination\": \"LHR\",\n  \"departDate\": \"2026-12-10\",\n  \"returnDate\": \"2026-12-17\",\n  \"cabinClass\": \"business\",\n  \"adults\": 2,\n  \"excludeAirlines\": [\"BA\"],\n  \"departAfter\": \"18:00\",\n  \"maxLayoverMinutes\": 240,\n  \"sortBy\": \"duration\"\n}\n```\n\n### Example: batch routes with metro expansion\n\n```json\n{\n  \"mode\": \"byRoutes\",\n  \"routes\": [\n    { \"origin\": \"NYC\", \"destination\": \"LON\", \"departDate\": \"2026-12-10\" },\n    { \"origin\": \"SFO\", \"destination\": \"TYO\", \"departDate\": \"2027-01-05\", \"returnDate\": \"2027-01-19\" }\n  ],\n  \"expandAirports\": true,\n  \"maxItems\": 500\n}\n```\n\n### Example: pasted Skiplagged links\n\n```json\n{\n  \"mode\": \"byUrls\",\n  \"startUrls\": [\n    \"https://skiplagged.com/flights/NYC/LON/2026-12-10/2026-12-17\",\n    \"https://skiplagged.com/flights/LON/dubai-emirate/2026-12-20\"\n  ]\n}\n```\n\n### Example: flexible-date calendar\n\n```json\n{\n  \"mode\": \"calendar\",\n  \"origin\": \"NYC\",\n  \"destination\": \"LON\",\n  \"calendarDays\": 30,\n  \"cabinClass\": \"economy\",\n  \"maxItems\": 40\n}\n```\n\n## Use cases\n\n- **Fare monitoring** — schedule daily searches and compare price and provider changes on the same route\n- **Hidden-city research** — isolate hidden-city fares, see the ticketed destination and the real deplaning airport, and measure how much they save\n- **Travel agencies** — batch a client list of routes into one dataset with consistent filters\n- **Corporate travel** — check cabin and passenger-mix pricing for employee itineraries\n- **Price-comparison products** — feed live Skiplagged fares and provider quotes into your own search experience\n- **Seasonality analysis** — use the flexible-date calendar to compare daily prices across a month\n\n## FAQ\n\n**What is the data source?** Skiplagged's public flight-search results (skiplagged.com), which aggregate fares from airlines and online travel agencies. Search is one JSON request per route, plus one per expanded or nearby airport when those options are enabled; the calendar is one request per route.\n\n**Is this affiliated with Skiplagged?** No — this is an independent, third-party actor that reads publicly available Skiplagged search results.\n\n**What is a hidden-city itinerary?** Skiplagged can show a cheaper fare where the ticket ends farther than your destination. You get off at your destination and skip the final leg. The record sets `hiddenCity: true`, keeps `destinationAirport` as the airport where you get off, and adds `ticketedDestinationAirport` for where the ticket really ends. Hidden-city travel has airline rules: do not check bags, and any later segments on the same ticket are cancelled if you skip a leg. Confirm the fare rules before booking.\n\n**How do I spot self-transfer or virtual-interline itineraries?** `virtualInterline: true` is copied from Skiplagged's itinerary-level `vi` flag. These itineraries combine separately ticketed or virtual-interline segments, so check baggage transfer, recheck requirements and missed-connection rules before booking. The flag can occur even when all flown segments use one airline.\n\n**Why do my passenger counts change the price now?** The actor sends Skiplagged's `counts[...]` parameters, so the returned itinerary and price reflect the whole party. `price` is the total, not a per-person fare. The `adults`, `children`, `infantsLap` and `infantsSeat` fields show what Skiplagged returned.\n\n**Does the cabin class work?** Yes. `economy`, `premium-economy` (sent as `premium`), `business` and `first` are sent as Skiplagged's fare class, and `fareClass` on each record shows what was actually priced. Some routes have no inventory in a given cabin; those searches return fewer rows or none.\n\n**Why does a round-trip search return separate outbound and inbound records?** Skiplagged prices round-trips as two one-way tickets. Each leg is a record with `legType` set, and outbound rows may include `minRoundTripPrice` for the combined total.\n\n**How do I get more than 300 rows for a metro route?** Skiplagged caps a single search at about 300 itineraries per leg. Set `expandAirports: true`; the actor also searches the individual airports on the smaller side of the metro (for NYC: JFK, EWR and LGA) and merges unique itineraries. Raise `maxItems` above the default 50 if you want to keep more than 50 rows. It costs a few extra requests per route.\n\n**What is the difference between `bookingProviders` and `bookingOptions`?** `bookingOptions` lists every provider and its price for the itinerary. `bookingProviders` lists only the provider name(s) quoting the lowest price.\n\n**Do I need a proxy or an API key?** No. The actor uses Apify Proxy automatically and retries transient 403/429/5xx responses. There is no login, cookie or API key. A route whose retries are exhausted is reported in the run status instead of being silently dropped.\n\n**Which currency are prices in?** USD, exactly as Skiplagged returns them. Skiplagged's public JSON API does not convert currencies.\n\n**Can I search \"anywhere\"?** Skiplagged's public JSON API does not expose an anywhere-destination search; the actor therefore requires a destination. For cheap destinations, run a batch of routes from the same origin.\n\n**Are hotel prices included?** No. This actor is focused on flight itineraries and fare calendars. Hotels are a separate product.\n\n## Limitations\n\n- A single search returns at most about 300 itineraries per leg, and that 300-row sample can vary between identical requests. `expandAirports` improves coverage by merging airport-level searches but does not paginate the whole inventory.\n- Departure dates must be between yesterday and roughly 11 months ahead, as enforced by Skiplagged. Older past dates are advanced to a future month; round-trip gaps are preserved.\n- `originState`/`destinationState` are omitted for metro and multi-airport searches because Skiplagged reports state at metro level. Use single-airport searches when you need state/province, or use the airport code/city fields.\n- `sourceUrl` points at a Cloudflare-protected Skiplagged page. It works in a browser; bare HTTP clients may receive a 403 challenge.\n- Currency conversion, hotel rates and an anywhere-destination search are not available from the public JSON API.\n- Hidden-city itineraries carry airline policy risk: no checked bags, and skipped segments cancel the rest of the ticket. Self-transfer/virtual-interline itineraries (`virtualInterline: true`) carry separate-ticket and missed-connection risk.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "skiplagged-route-fare-and-booking-provider-finder",
      "title": "Skiplagged Route Fare & Booking Provider Finder",
      "description": "Search Skiplagged flight fares for one route, a batch of routes, pasted search URLs, or a flexible-date calendar. Returns price, airlines, flight numbers, layovers, hidden-city flags and booking providers for each itinerary.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Skiplagged Route Fare & Booking Provider Finder\n\nScrape **Skiplagged** flight fares — including the hidden-city and self-transfer itineraries Skiplagged is known for — and get one clean record per itinerary with the price, airlines, flight numbers, layovers, stops, hidden-city flag and every booking provider that quotes the fare. Search one route, batch many routes in one run, paste Skiplagged search links, or pull a flexible-date price calendar. No login, no cookies, no proxy setup.\n\n## What this actor does\n\n- **Four modes:** `search` (one route), `byRoutes` (many routes in one run), `byUrls` (paste Skiplagged flight-search links), `calendar` (daily prices for the next 61 days)\n- **Hidden-city aware:** every itinerary records whether the ticket ends beyond your destination, where you actually get off, and the true ticketed airport\n- **Self-transfer aware:** `virtualInterline` marks separately ticketed/virtual-interline combinations from Skiplagged's itinerary-level `vi` flag\n- **Real cabin and passenger pricing:** economy, premium economy, business and first; adults, children and lap/seated infants are sent correctly and the returned counts are reported\n- **Failures stay visible:** a route whose retries are exhausted is named in the run status while successful routes are still emitted\n- **Booking providers:** all providers with their prices (`bookingOptions`) plus the cheapest provider names (`bookingProviders`)\n- **Filters:** nonstop, max stops, price band, include/exclude airlines, hidden-city include/only/exclude, departure/arrival time windows, max duration, max layover, sort direction\n- **Whole-metro coverage:** airport codes, metro codes, city names and Skiplagged slugs; optional nearby-airport search and metro expansion for more than 300 rows\n- **Empty fields are omitted** — no `null` values in the dataset\n\n## Output per flight itinerary\n\n- `flightId`, `legType` — `outbound` or `inbound`\n- `originAirport`, `originAirportName`, `originCity`, `originState`, `originCountry`\n- `destinationAirport`, `destinationAirportName`, `destinationCity`, `destinationState`, `destinationCountry` — the airport where you get off\n- State/province is emitted only when Skiplagged returns that airport as a single-airport result. Metro and multi-airport searches omit it rather than mixing a metro-level state with an airport-level city (for example, Newark/EWR would otherwise contradict “New York”). Country is omitted when the source reports a multi-country list.\n- `departureTime`, `arrivalTime` — ISO 8601 with timezone offset; `arrivalTime` is the deplaning arrival\n- `durationMinutes`, `duration` — travel time to the deplaning airport (e.g. `7h 30m`)\n- `stops`, `direct` — stops before the deplaning airport\n- `hiddenCity` — `true` when the ticket continues past your destination\n- `ticketedDestinationAirport`, `ticketedDestinationCity`, `ticketedStops` — present only on hidden-city rows: where the ticket really ends\n- `virtualInterline` — `true` when Skiplagged marks the itinerary as a self-transfer/virtual-interline combination (`vi` in the source)\n- `airlines[]`, `airlineCodes[]`, `primaryAirline`\n- `segments[]` — one entry per flight leg: `airlineCode`, `airlineName`, `flightNumber`, `departureAirport`, `departureAirportName`, `departureTime`, `arrivalAirport`, `arrivalAirportName`, `arrivalTime`, `durationMinutes`; legs after the deplaning point carry `beyondTicket: true`\n- `layovers[]` — one entry per connection before deplaning: `airport`, `airportName`, `durationMinutes`, `duration`\n- `price`, `currency` — total price for the requested passenger mix, in USD\n- `fareClass` — cabin Skiplagged actually priced; `requestedCabinClass` — what you asked for\n- `adults`, `children`, `infantsLap`, `infantsSeat` — passenger counts Skiplagged returned\n- `bookingOptions[]` — every provider and its price: `provider`, `price`\n- `bookingProviders[]` — provider name(s) quoting the lowest price\n- `minRoundTripPrice` — combined round-trip total when Skiplagged quotes one (outbound rows)\n- `departDate`, `returnDate`, `originQuery`, `destinationQuery`, `searchedOriginAirports[]`, `searchedDestinationAirports[]` — the airport lists are the overall searched sets, including expansion rows\n- `rank` — position within the route after filtering and sorting; `routeIndex` in batch modes\n- `sourceUrl` — the Skiplagged search-results page for this route and date (Cloudflare-protected; works in a browser, bare HTTP clients may receive 403)\n- `recordType: \"skiplaggedFlight\"`, `scrapedAt`\n\n## Output per fare-calendar row (mode = `calendar`)\n\n- `recordType: \"skiplaggedFareCalendar\"`, `calendarType` — `departure` or `return`\n- `departDate`, `returnDate`, `tripType`\n- `originCode`, `destinationCode`, `originCity`, `destinationCity`, `originAirports[]`, `destinationAirports[]`\n- `price`, `currency` — round-trip total when a return date is involved, otherwise the one-way price\n- `oneWayPrice` — one-way price when Skiplagged quotes it next to a round-trip total\n- `priceLevel` — `low` or `high` when Skiplagged marks the day\n- `fareClass`, `requestedCabinClass`, `adults`, `children`, `infantsLap`, `infantsSeat`\n- `sourceUrl`, `rank`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` / `byRoutes` / `byUrls` / `calendar` |\n| `origin` | string | `NYC` | Origin airport/metro code, city name or Skiplagged slug (mode=search, calendar) |\n| `destination` | string | `LON` | Destination airport/metro code, city name or Skiplagged slug |\n| `departDate` | string | – | `YYYY-MM-DD`; blank = six weeks from today; past dates advance to a future month and a past round-trip gap is preserved |\n| `returnDate` | string | – | `YYYY-MM-DD`; blank = one-way |\n| `originAirports` | array | `[]` | Exact airports to search instead of `origin`, e.g. `[\"JFK\",\"EWR\"]` |\n| `destinationAirports` | array | `[]` | Exact airports to search instead of `destination` |\n| `includeNearbyAirports` | bool | `false` | Also search airports near both ends; ignored when airport lists are set |\n| `expandAirports` | bool | `false` | Split a metro route into the smaller side's airports to get past the 300-row cap; raise `maxItems` above 300 to see the extra rows |\n| `routes` | array | `[]` | Batch of `{origin, destination, departDate, returnDate}` objects (mode=byRoutes) |\n| `startUrls` | array | `[]` | Skiplagged flight-search URLs, codes or slugs, including single-word slugs such as `tokyo` (mode=byUrls) |\n| `tripType` | string | `auto` | `auto` / `one-way` / `round-trip` |\n| `cabinClass` | string | `economy` | `economy` / `premium-economy` / `business` / `first` |\n| `adults` | int | `1` | Adults (1-9); prices are totals for the whole party |\n| `children` | int | `0` | Children (0-8) |\n| `infantsLap` | int | `0` | Lap infants (0-8) |\n| `infantsSeat` | int | `0` | Seated infants (0-8) |\n| `directOnly` | bool | `false` | Only nonstop itineraries to the deplaning airport |\n| `maxStops` | int | `3` | Maximum stops before deplaning (0 = nonstop) |\n| `minPrice` | int | – | Minimum total price in whole USD |\n| `maxPrice` | int | – | Maximum total price in whole USD |\n| `airlines` | array | `[]` | Only itineraries flying at least one of these IATA airline codes |\n| `excludeAirlines` | array | `[]` | Drop itineraries flying any of these IATA airline codes |\n| `hiddenCity` | string | `include` | `include` / `only` / `exclude` |\n| `departAfter` | string | – | First departure at or after this local `HH:MM` |\n| `departBefore` | string | – | First departure at or before this local `HH:MM` |\n| `arriveAfter` | string | – | Deplaning arrival at or after this local `HH:MM` |\n| `arriveBefore` | string | – | Deplaning arrival at or before this local `HH:MM` |\n| `maxDurationMinutes` | int | – | Maximum minutes to the deplaning airport |\n| `maxLayoverMinutes` | int | – | Maximum minutes for any layover |\n| `sortBy` | string | `price` | `price` / `duration` / `departureTime` / `stops` |\n| `sortOrder` | string | `asc` | `asc` / `desc` |\n| `maxItems` | int | `50` | Run-wide record cap (1-1000) |\n| `calendarStartDate` | string | – | First calendar date `YYYY-MM-DD` (mode=calendar) |\n| `calendarDays` | int | `30` | Days per calendar type (mode=calendar); a round-trip calendar can return departure and return rows, up to twice this many |\n\nDefaults: `[]` means empty; `–` means unset. Field names above are the exact JSON keys.\n\n### Example: hidden-city only, nonstop to London\n\n```json\n{\n  \"mode\": \"search\",\n  \"origin\": \"NYC\",\n  \"destination\": \"LON\",\n  \"departDate\": \"2026-12-12\",\n  \"hiddenCity\": \"only\",\n  \"maxStops\": 0,\n  \"sortBy\": \"price\",\n  \"maxItems\": 20\n}\n```\n\nPinned control case (verified 2026-11-18): NYC→LON on `2026-12-12` returned 11 hidden economy rows (all nonstop to the deplaning airport) and 28/28 hidden business rows. Use that date and cabin for deterministic hidden-city checks; other dates can legitimately return zero hidden rows because the 300-row result set is source-variable.\n\n### Example: round-trip business with filters\n\n```json\n{\n  \"mode\": \"search\",\n  \"origin\": \"JFK\",\n  \"destination\": \"LHR\",\n  \"departDate\": \"2026-12-10\",\n  \"returnDate\": \"2026-12-17\",\n  \"cabinClass\": \"business\",\n  \"adults\": 2,\n  \"excludeAirlines\": [\"BA\"],\n  \"departAfter\": \"18:00\",\n  \"maxLayoverMinutes\": 240,\n  \"sortBy\": \"duration\"\n}\n```\n\n### Example: batch routes with metro expansion\n\n```json\n{\n  \"mode\": \"byRoutes\",\n  \"routes\": [\n    { \"origin\": \"NYC\", \"destination\": \"LON\", \"departDate\": \"2026-12-10\" },\n    { \"origin\": \"SFO\", \"destination\": \"TYO\", \"departDate\": \"2027-01-05\", \"returnDate\": \"2027-01-19\" }\n  ],\n  \"expandAirports\": true,\n  \"maxItems\": 500\n}\n```\n\n### Example: pasted Skiplagged links\n\n```json\n{\n  \"mode\": \"byUrls\",\n  \"startUrls\": [\n    \"https://skiplagged.com/flights/NYC/LON/2026-12-10/2026-12-17\",\n    \"https://skiplagged.com/flights/LON/dubai-emirate/2026-12-20\"\n  ]\n}\n```\n\n### Example: flexible-date calendar\n\n```json\n{\n  \"mode\": \"calendar\",\n  \"origin\": \"NYC\",\n  \"destination\": \"LON\",\n  \"calendarDays\": 30,\n  \"cabinClass\": \"economy\",\n  \"maxItems\": 40\n}\n```\n\n## Use cases\n\n- **Fare monitoring** — schedule daily searches and compare price and provider changes on the same route\n- **Hidden-city research** — isolate hidden-city fares, see the ticketed destination and the real deplaning airport, and measure how much they save\n- **Travel agencies** — batch a client list of routes into one dataset with consistent filters\n- **Corporate travel** — check cabin and passenger-mix pricing for employee itineraries\n- **Price-comparison products** — feed live Skiplagged fares and provider quotes into your own search experience\n- **Seasonality analysis** — use the flexible-date calendar to compare daily prices across a month\n\n## FAQ\n\n**What is the data source?** Skiplagged's public flight-search results (skiplagged.com), which aggregate fares from airlines and online travel agencies. Search is one JSON request per route, plus one per expanded or nearby airport when those options are enabled; the calendar is one request per route.\n\n**Is this affiliated with Skiplagged?** No — this is an independent, third-party actor that reads publicly available Skiplagged search results.\n\n**What is a hidden-city itinerary?** Skiplagged can show a cheaper fare where the ticket ends farther than your destination. You get off at your destination and skip the final leg. The record sets `hiddenCity: true`, keeps `destinationAirport` as the airport where you get off, and adds `ticketedDestinationAirport` for where the ticket really ends. Hidden-city travel has airline rules: do not check bags, and any later segments on the same ticket are cancelled if you skip a leg. Confirm the fare rules before booking.\n\n**How do I spot self-transfer or virtual-interline itineraries?** `virtualInterline: true` is copied from Skiplagged's itinerary-level `vi` flag. These itineraries combine separately ticketed or virtual-interline segments, so check baggage transfer, recheck requirements and missed-connection rules before booking. The flag can occur even when all flown segments use one airline.\n\n**Why do my passenger counts change the price now?** The actor sends Skiplagged's `counts[...]` parameters, so the returned itinerary and price reflect the whole party. `price` is the total, not a per-person fare. The `adults`, `children`, `infantsLap` and `infantsSeat` fields show what Skiplagged returned.\n\n**Does the cabin class work?** Yes. `economy`, `premium-economy` (sent as `premium`), `business` and `first` are sent as Skiplagged's fare class, and `fareClass` on each record shows what was actually priced. Some routes have no inventory in a given cabin; those searches return fewer rows or none.\n\n**Why does a round-trip search return separate outbound and inbound records?** Skiplagged prices round-trips as two one-way tickets. Each leg is a record with `legType` set, and outbound rows may include `minRoundTripPrice` for the combined total.\n\n**How do I get more than 300 rows for a metro route?** Skiplagged caps a single search at about 300 itineraries per leg. Set `expandAirports: true`; the actor also searches the individual airports on the smaller side of the metro (for NYC: JFK, EWR and LGA) and merges unique itineraries. Raise `maxItems` above the default 50 if you want to keep more than 50 rows. It costs a few extra requests per route.\n\n**What is the difference between `bookingProviders` and `bookingOptions`?** `bookingOptions` lists every provider and its price for the itinerary. `bookingProviders` lists only the provider name(s) quoting the lowest price.\n\n**Do I need a proxy or an API key?** No. The actor uses Apify Proxy automatically and retries transient 403/429/5xx responses. There is no login, cookie or API key. A route whose retries are exhausted is reported in the run status instead of being silently dropped.\n\n**Which currency are prices in?** USD, exactly as Skiplagged returns them. Skiplagged's public JSON API does not convert currencies.\n\n**Can I search \"anywhere\"?** Skiplagged's public JSON API does not expose an anywhere-destination search; the actor therefore requires a destination. For cheap destinations, run a batch of routes from the same origin.\n\n**Are hotel prices included?** No. This actor is focused on flight itineraries and fare calendars. Hotels are a separate product.\n\n## Limitations\n\n- A single search returns at most about 300 itineraries per leg, and that 300-row sample can vary between identical requests. `expandAirports` improves coverage by merging airport-level searches but does not paginate the whole inventory.\n- Departure dates must be between yesterday and roughly 11 months ahead, as enforced by Skiplagged. Older past dates are advanced to a future month; round-trip gaps are preserved.\n- `originState`/`destinationState` are omitted for metro and multi-airport searches because Skiplagged reports state at metro level. Use single-airport searches when you need state/province, or use the airport code/city fields.\n- `sourceUrl` points at a Cloudflare-protected Skiplagged page. It works in a browser; bare HTTP clients may receive a 403 challenge.\n- Currency conversion, hotel rates and an anywhere-destination search are not available from the public JSON API.\n- Hidden-city itineraries carry airline policy risk: no checked bags, and skipped segments cancel the rest of the ticket. Self-transfer/virtual-interline itineraries (`virtualInterline: true`) carry separate-ticket and missed-connection risk.\n",
      "input": {
        "title": "Skiplagged Route Fare & Booking Provider Finder Input",
        "description": "Search Skiplagged for flight fares by route, batch of routes, pasted search URLs, or a flexible-date price calendar. Returns prices, airlines, flight numbers, layovers, hidden-city flags and booking providers.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch. `search` uses one origin/destination, `byRoutes` reads the routes array, `byUrls` parses pasted Skiplagged URLs, and `calendar` returns a flexible-date price calendar for one route.",
            "editor": "select",
            "enum": [
              "search",
              "byRoutes",
              "byUrls",
              "calendar"
            ],
            "enumTitles": [
              "Search one route",
              "Search multiple routes",
              "Search from pasted Skiplagged URLs",
              "Flexible-date price calendar"
            ],
            "default": "search",
            "prefill": "search"
          },
          "origin": {
            "title": "Origin",
            "type": "string",
            "description": "Origin airport/metro code (`JFK`, `NYC`), Skiplagged city slug (`new-york`, `tokyo`, `dubai-emirate`) or city name (`New York`). Mode=search and mode=calendar.",
            "editor": "textfield",
            "default": "NYC",
            "prefill": "NYC",
            "sectionCaption": "Route",
            "sectionDescription": "The route searched in mode=search and mode=calendar. Airport codes, metro codes, city names and Skiplagged slugs are accepted."
          },
          "destination": {
            "title": "Destination",
            "type": "string",
            "description": "Destination airport/metro code (`LHR`, `LON`), Skiplagged city slug (`tokyo`, `dubai-emirate`) or city name (`London`).",
            "editor": "textfield",
            "default": "LON",
            "prefill": "LON"
          },
          "departDate": {
            "title": "Departure date",
            "type": "string",
            "description": "Departure date as `YYYY-MM-DD`. Leave blank to use six weeks from today. Past dates advance to a future month, and a past round-trip gap is preserved.",
            "editor": "textfield"
          },
          "returnDate": {
            "title": "Return date",
            "type": "string",
            "description": "Return date as `YYYY-MM-DD` for a round-trip search. Leave blank for one-way.",
            "editor": "textfield"
          },
          "originAirports": {
            "title": "Origin airports",
            "type": "array",
            "description": "Optional exact airports to search instead of `origin`, e.g. `[\"JFK\", \"EWR\"]`. When set, these override the single origin value (mode=search, byRoutes).",
            "editor": "stringList",
            "default": [],
            "prefill": [],
            "sectionCaption": "Airport coverage",
            "sectionDescription": "Optional multi-airport and nearby-airport options. Metro codes already cover every airport in the city; these options let you choose specific airports or extend the search area."
          },
          "destinationAirports": {
            "title": "Destination airports",
            "type": "array",
            "description": "Optional exact airports to search instead of `destination`, e.g. `[\"LHR\", \"LGW\"]`. When set, these override the single destination value (mode=search, byRoutes).",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "includeNearbyAirports": {
            "title": "Include nearby airports",
            "type": "boolean",
            "description": "Also search airports near the origin and destination (e.g. HPN and ISP around New York). Ignored when an airport list is set (mode=search, byRoutes, byUrls).",
            "default": false,
            "prefill": false
          },
          "expandAirports": {
            "title": "Expand metro routes for more rows",
            "type": "boolean",
            "description": "Skiplagged returns at most about 300 itineraries per leg. When on, the actor also searches each airport of the smaller side of a metro route (e.g. JFK, EWR and LGA for NYC) and merges the unique results. Costs a few extra requests (mode=search, byRoutes, byUrls).",
            "default": false,
            "prefill": false
          },
          "routes": {
            "title": "Routes (mode=byRoutes)",
            "type": "array",
            "description": "Batch of routes, one object per route: `{\"origin\":\"NYC\",\"destination\":\"LON\",\"departDate\":\"2026-09-01\",\"returnDate\":\"2026-09-08\"}`. `returnDate`, `originAirports` and `destinationAirports` are optional.",
            "editor": "json",
            "default": [],
            "prefill": [],
            "sectionCaption": "Batch inputs",
            "sectionDescription": "Inputs used by mode=byRoutes and mode=byUrls."
          },
          "startUrls": {
            "title": "Skiplagged URLs (mode=byUrls)",
            "type": "array",
            "description": "Skiplagged flight-search URLs, e.g. `https://skiplagged.com/flights/NYC/LON/2026-09-01/2026-09-08`, `https://skiplagged.com/flights/LON/dubai-emirate/2026-09-17` or `https://skiplagged.com/flights/NYC/tokyo/2026-09-17`. Airport codes and multi-word or single-word city slugs are accepted.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "tripType": {
            "title": "Trip type",
            "type": "string",
            "description": "One-way, round-trip, or auto-detect from whether a return date is present.",
            "editor": "select",
            "enum": [
              "auto",
              "one-way",
              "round-trip"
            ],
            "enumTitles": [
              "Auto-detect from dates",
              "One-way only",
              "Round-trip only"
            ],
            "default": "auto",
            "prefill": "auto",
            "sectionCaption": "Trip and passengers",
            "sectionDescription": "Cabin and passenger mix are sent to Skiplagged, and the returned itinerary reports the passenger counts and fare class it actually priced."
          },
          "cabinClass": {
            "title": "Cabin class",
            "type": "string",
            "description": "Requested cabin. `premium-economy` is sent as Skiplagged's `premium` fare class. The real fare class returned by Skiplagged is always included on each record as `fareClass`.",
            "editor": "select",
            "enum": [
              "economy",
              "premium-economy",
              "business",
              "first"
            ],
            "enumTitles": [
              "Economy",
              "Premium economy",
              "Business",
              "First"
            ],
            "default": "economy",
            "prefill": "economy"
          },
          "adults": {
            "title": "Adults",
            "type": "integer",
            "description": "Number of adult passengers (12+). Prices on each record are the total for the requested passenger mix.",
            "minimum": 1,
            "maximum": 9,
            "default": 1,
            "prefill": 1
          },
          "children": {
            "title": "Children",
            "type": "integer",
            "description": "Number of child passengers (2-11).",
            "minimum": 0,
            "maximum": 8,
            "default": 0,
            "prefill": 0
          },
          "infantsLap": {
            "title": "Infants (on lap)",
            "type": "integer",
            "description": "Number of lap infants (under 2, no seat).",
            "minimum": 0,
            "maximum": 8,
            "default": 0,
            "prefill": 0
          },
          "infantsSeat": {
            "title": "Infants (own seat)",
            "type": "integer",
            "description": "Number of infants (under 2) with their own seat.",
            "minimum": 0,
            "maximum": 8,
            "default": 0,
            "prefill": 0
          },
          "directOnly": {
            "title": "Direct flights only",
            "type": "boolean",
            "description": "Only emit nonstop itineraries to the deplaning airport.",
            "default": false,
            "prefill": false,
            "sectionCaption": "Filters",
            "sectionDescription": "Optional filters applied after the search response. Leave them unset or false to keep every itinerary."
          },
          "maxStops": {
            "title": "Max stops",
            "type": "integer",
            "description": "Drop itineraries with more stops than this before the deplaning airport. 0 means nonstop.",
            "minimum": 0,
            "maximum": 3,
            "default": 3,
            "prefill": 3
          },
          "minPrice": {
            "title": "Min price (USD)",
            "type": "integer",
            "description": "Drop itineraries cheaper than this total price in whole USD.",
            "minimum": 0,
            "maximum": 50000
          },
          "maxPrice": {
            "title": "Max price (USD)",
            "type": "integer",
            "description": "Drop itineraries pricier than this total price in whole USD.",
            "minimum": 0,
            "maximum": 50000
          },
          "airlines": {
            "title": "Include airlines",
            "type": "array",
            "description": "Only emit itineraries that include at least one of these 2-letter IATA airline codes, e.g. `AA`, `BA`, `DL`.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "excludeAirlines": {
            "title": "Exclude airlines",
            "type": "array",
            "description": "Drop itineraries that include any of these 2-letter IATA airline codes.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "hiddenCity": {
            "title": "Hidden-city itineraries",
            "type": "string",
            "description": "Include all itineraries, keep only hidden-city fares, or drop hidden-city fares. Hidden-city itineraries end at a different ticketed airport than your destination; check airline baggage and missed-leg rules before booking.",
            "editor": "select",
            "enum": [
              "include",
              "only",
              "exclude"
            ],
            "enumTitles": [
              "Include all itineraries",
              "Only hidden-city itineraries",
              "Exclude hidden-city itineraries"
            ],
            "default": "include",
            "prefill": "include"
          },
          "departAfter": {
            "title": "Depart after (HH:MM)",
            "type": "string",
            "description": "Keep itineraries whose first departure is at or after this local time, e.g. `08:00`.",
            "editor": "textfield"
          },
          "departBefore": {
            "title": "Depart before (HH:MM)",
            "type": "string",
            "description": "Keep itineraries whose first departure is at or before this local time, e.g. `22:00`.",
            "editor": "textfield"
          },
          "arriveAfter": {
            "title": "Arrive after (HH:MM)",
            "type": "string",
            "description": "Keep itineraries whose deplaning arrival is at or after this local time.",
            "editor": "textfield"
          },
          "arriveBefore": {
            "title": "Arrive before (HH:MM)",
            "type": "string",
            "description": "Keep itineraries whose deplaning arrival is at or before this local time.",
            "editor": "textfield"
          },
          "maxDurationMinutes": {
            "title": "Max duration (minutes)",
            "type": "integer",
            "description": "Drop itineraries longer than this many minutes to the deplaning airport, e.g. `600` for 10 hours.",
            "minimum": 0,
            "maximum": 10080
          },
          "maxLayoverMinutes": {
            "title": "Max layover (minutes)",
            "type": "integer",
            "description": "Drop itineraries with any layover longer than this many minutes.",
            "minimum": 0,
            "maximum": 10080
          },
          "sortBy": {
            "title": "Sort by",
            "type": "string",
            "description": "Order of emitted records within each route.",
            "editor": "select",
            "enum": [
              "price",
              "duration",
              "departureTime",
              "stops"
            ],
            "enumTitles": [
              "Price",
              "Duration",
              "Departure time",
              "Stops"
            ],
            "default": "price",
            "prefill": "price",
            "sectionCaption": "Output",
            "sectionDescription": "Record ordering and the run-wide result cap."
          },
          "sortOrder": {
            "title": "Sort order",
            "type": "string",
            "description": "Ascending (cheapest/shortest/earliest/fewest first) or descending.",
            "editor": "select",
            "enum": [
              "asc",
              "desc"
            ],
            "enumTitles": [
              "Ascending",
              "Descending"
            ],
            "default": "asc",
            "prefill": "asc"
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on emitted records for the whole run, across all routes.",
            "minimum": 1,
            "maximum": 1000,
            "default": 50,
            "prefill": 3
          },
          "calendarStartDate": {
            "title": "Calendar start date (mode=calendar)",
            "type": "string",
            "description": "First date to include in the flexible-date calendar as `YYYY-MM-DD`. Leave blank to start from the earliest returned day.",
            "editor": "textfield",
            "sectionCaption": "Calendar",
            "sectionDescription": "Options for mode=calendar. The calendar always covers the next 61 days returned by Skiplagged."
          },
          "calendarDays": {
            "title": "Calendar days (mode=calendar)",
            "type": "integer",
            "description": "How many days of the calendar to return, counting from the start date. For round-trip calendars this applies per calendar type (departure and return), so up to twice as many rows can be returned.",
            "minimum": 1,
            "maximum": 61,
            "default": 30,
            "prefill": 7
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Skiplagged Route Fare & Booking Provider Finder Output",
        "description": "Skiplagged flight itineraries (price, airlines, segments, layovers, hidden-city flag, self-transfer/virtual-interline flag, booking providers) and, in calendar mode, daily fare-calendar rows. State/province is emitted only for single-airport source responses. Empty fields are omitted.",
        "properties": {
          "flights": {
            "type": "string",
            "title": "Skiplagged flights and fare calendars",
            "description": "Dataset containing scraped Skiplagged flight itineraries (recordType=skiplaggedFlight) and flexible-date fare-calendar rows (recordType=skiplaggedFareCalendar).",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Flights",
              "transformation": {
                "fields": [
                  "originAirport",
                  "destinationAirport",
                  "departureTime",
                  "arrivalTime",
                  "airlines",
                  "stops",
                  "hiddenCity",
                  "virtualInterline",
                  "price",
                  "minRoundTripPrice",
                  "currency",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "606beaddc0c30128aefceb789a7d106408c0bce894094e1a754ab69484cf30f3",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.01325
    }
  }
}