# Skiplagged Flight Search Scraper (`crawlerbros/skiplagged-scraper`) Actor

Scrape Skiplagged's flight search results - one-way, round-trip, and multi-route fare comparisons with real prices, airlines, flight numbers, durations, stops, and booking-provider data. No login, no proxy required.

- **URL**: https://apify.com/crawlerbros/skiplagged-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** Automation, Travel, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Skiplagged Flight Search Scraper

Scrape **Skiplagged** — the flight fare-comparison search engine known for surfacing hidden-city and self-transfer itineraries that other search engines don't show. Search a single route, batch many routes in one run, or feed it Skiplagged search-page URLs directly. Get real prices, airlines, flight numbers, timings, layovers, and the cheapest booking provider for every itinerary. No login, no proxy, no cookies required.

### What this actor does

- **Three modes:** `search` (single route), `byRoutes` (batch multiple routes in one run), `byUrls` (paste Skiplagged search-page links)
- **One-way and round-trip** — round-trip searches return the outbound and return legs as separate priced itineraries, each tagged with `legType`, matching how Skiplagged itself prices them
- **Passenger mix:** adults, children, and infants (lap or seated)
- **Filters:** direct-only, max stops, price range, airline allow-list, sort order
- **Booking providers:** every itinerary lists which travel site(s) currently offer its lowest price
- **Empty fields are omitted**

### Output per flight itinerary

- `flightId`, `legType` — `outbound` or `inbound`
- `originAirport`, `originCity`, `originState`, `originCountry`, `destinationAirport`, `destinationCity`, `destinationState`, `destinationCountry`
- `departureTime`, `arrivalTime` — ISO 8601 with timezone offset
- `durationMinutes`, `duration` — human-readable (e.g. `7h 30m`)
- `stops`, `direct`
- `airlines[]`, `airlineCodes[]`, `primaryAirline`
- `segments[]` — one entry per flight leg: `airlineCode`, `airlineName`, `flightNumber`, `departureAirport`, `departureTime`, `arrivalAirport`, `arrivalTime`, `durationMinutes`
- `layovers[]` — one entry per connection: `airport`, `durationMinutes`, `duration` (human-readable). Omitted on direct itineraries.
- `price`, `currency`
- `fareClass` — cabin actually returned by Skiplagged for this itinerary
- `requestedCabinClass` — the cabin class you asked for
- `adults`, `children`, `infantsLap`, `infantsSeat`
- `bookingProviders[]` — travel site(s) offering the lowest listed price
- `minRoundTripPrice` — combined round-trip total, present on `outbound` records for round-trip searches
- `sourceUrl` — the Skiplagged search-results page for this route/date
- `recordType: "skiplaggedFlight"`, `scrapedAt`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search` / `byRoutes` / `byUrls` |
| `origin` | string | `NYC` | Origin IATA airport or metro code (mode=search) |
| `destination` | string | `LON` | Destination IATA airport or metro code (mode=search) |
| `departDate` | string | – | `YYYY-MM-DD`; defaults to 6 weeks from today if blank |
| `returnDate` | string | – | `YYYY-MM-DD`; omit for one-way |
| `routes` | array | – | Batch of `{origin, destination, departDate, returnDate}` objects (mode=byRoutes) |
| `startUrls` | array | – | Skiplagged flights-search URLs (mode=byUrls) |
| `tripType` | string | `auto` | `auto` / `one-way` / `round-trip` |
| `cabinClass` | string | `economy` | `economy` / `premium-economy` / `business` / `first` |
| `adults` | int | `1` | Adult passengers (1-9) |
| `children` | int | `0` | Child passengers (0-8) |
| `infantsLap` | int | `0` | Lap infants (0-8) |
| `infantsSeat` | int | `0` | Seated infants (0-8) |
| `directOnly` | bool | `false` | Only nonstop itineraries |
| `maxStops` | int | `3` | Drop itineraries with more stops |
| `minPrice` | int | – | Drop itineraries cheaper than this (USD) |
| `maxPrice` | int | – | Drop itineraries pricier than this (USD) |
| `airlines` | array | – | Only itineraries flying at least one of these IATA airline codes |
| `sortBy` | string | `price` | `price` / `duration` / `departureTime` / `stops` |
| `maxItems` | int | `50` | Hard cap on emitted records (1-1000) |

#### Example: one-way search

```json
{
  "mode": "search",
  "origin": "JFK",
  "destination": "LAX",
  "departDate": "2026-09-15",
  "directOnly": true
}
````

#### Example: round-trip with passenger mix and price cap

```json
{
  "mode": "search",
  "origin": "NYC",
  "destination": "LON",
  "departDate": "2026-09-01",
  "returnDate": "2026-09-08",
  "adults": 2,
  "children": 1,
  "maxPrice": 800,
  "sortBy": "duration"
}
```

#### Example: batch multiple routes in one run

```json
{
  "mode": "byRoutes",
  "routes": [
    { "origin": "NYC", "destination": "LON", "departDate": "2026-09-01" },
    { "origin": "SFO", "destination": "TYO", "departDate": "2026-10-05", "returnDate": "2026-10-19" }
  ],
  "maxItems": 100
}
```

#### Example: from a pasted Skiplagged URL

```json
{
  "mode": "byUrls",
  "startUrls": ["https://skiplagged.com/flights/NYC/LON/2026-09-01/2026-09-08"]
}
```

### Use cases

- **Fare monitoring** — track route prices over time for travel alerts or dashboards
- **Travel agencies** — compare provider pricing across a batch of client routes in one run
- **Corporate travel** — bulk-check fares for multiple employee itineraries
- **Price-comparison tools** — feed real fare data into your own travel search product
- **Market research** — analyze airline pricing and route competitiveness

### FAQ

**What's the data source?** Skiplagged's public flight-search results (skiplagged.com), which aggregate fares from multiple online travel agencies and airlines.

**Is this affiliated with Skiplagged?** No — this is an independent, third-party actor that reads Skiplagged's public search results. It is not affiliated with or endorsed by Skiplagged.

**Why does a round-trip search return separate outbound/inbound records instead of one combined itinerary?** Skiplagged prices round-trips as two independently-booked one-way tickets (its well-known self-transfer/hidden-city model), not as a single bundled fare. Each leg is returned as its own record with `legType` set to `outbound` or `inbound`, plus `minRoundTripPrice` on the outbound record showing the combined total Skiplagged currently quotes.

**Why doesn't `cabinClass` always change the results?** Skiplagged's public search primarily returns economy inventory for most routes regardless of the requested cabin. The actor always reports the real `fareClass` Skiplagged returned alongside your `requestedCabinClass`, so you can see when the two differ.

**Why do `adults`/`children`/`infantsLap`/`infantsSeat` on output records not always match my requested passenger counts?** The `price` shown is always a real per-passenger fare, and the `adults`/`children`/etc. fields reflect exactly what Skiplagged's search response reports for that itinerary — which for its public (non-logged-in) search is typically `1 adult` regardless of the passenger counts you request. The actor never fabricates these fields; it passes your requested counts to Skiplagged and reports back only what Skiplagged's API actually returns.

**What does `bookingProviders` mean?** Skiplagged compares prices across several travel sites (airlines, OTAs, meta-search partners) for the same itinerary. This field lists whichever provider(s) are currently offering the lowest price shown.

**What are `originState`/`destinationState`?** Skiplagged reports a state or region for the queried city/metro area (e.g. `New York` for a US search, `England` for a UK search). This field is omitted when Skiplagged doesn't report one for that country.

**Can I search by city instead of a specific airport?** Yes — 3-letter metro codes like `NYC` (covers JFK/LGA/EWR) or `LON` (covers LHR/LGW/STN/LTN/LCY) are supported alongside single-airport codes like `JFK` or `LHR`.

**How fresh are the prices?** Prices reflect what Skiplagged's search API returns at the moment the actor runs — the same live pricing shown to a visitor on skiplagged.com.

**Why Skiplagged and not Skyscanner?** This actor originally targeted Skyscanner. Live testing showed every request to skyscanner.com and skyscanner.net — via both a real browser session and a plain HTTP request — was redirected 100% of the time to a hard bot-detection challenge page before any search results ever loaded, with no way to pass it without paid residential proxy infrastructure. Skiplagged is a same-category flight fare-comparison engine whose public search results are reliably accessible, so it replaces Skyscanner as this actor's data source.

# Actor input Schema

## `mode` (type: `string`):

What to fetch.

## `origin` (type: `string`):

Origin IATA airport code (e.g. `JFK`) or metro/city code (e.g. `NYC` covers JFK, LGA, EWR).

## `destination` (type: `string`):

Destination IATA airport code (e.g. `LHR`) or metro/city code (e.g. `LON` covers LHR, LGW, STN, LTN, LCY).

## `departDate` (type: `string`):

Departure date as `YYYY-MM-DD`. Leave blank to default to 6 weeks from today (keeps the daily test run always valid).

## `returnDate` (type: `string`):

Return date as `YYYY-MM-DD` for a round-trip search. Leave blank for a one-way search.

## `routes` (type: `array`):

Batch of routes to search in one run. Each item: `{"origin":"NYC","destination":"LON","departDate":"2026-09-01","returnDate":"2026-09-08"}` (`returnDate` optional for one-way).

## `startUrls` (type: `array`):

Skiplagged flight-search page URLs, e.g. `https://skiplagged.com/flights/NYC/LON/2026-09-01/2026-09-08`.

## `tripType` (type: `string`):

One-way or round-trip. Auto-detected from whether a return date is present; this only matters when `returnDate` is ambiguous.

## `cabinClass` (type: `string`):

Requested cabin class. Skiplagged's public search does not always honor this — the real `fareClass` returned by the upstream is always included on every record.

## `adults` (type: `integer`):

Number of adult passengers (12+).

## `children` (type: `integer`):

Number of child passengers (2-11).

## `infantsLap` (type: `integer`):

Number of lap infants (under 2, no seat).

## `infantsSeat` (type: `integer`):

Number of infants (under 2) with their own seat.

## `directOnly` (type: `boolean`):

Only emit nonstop itineraries.

## `maxStops` (type: `integer`):

Drop itineraries with more stops than this.

## `minPrice` (type: `integer`):

Drop itineraries cheaper than this (whole USD).

## `maxPrice` (type: `integer`):

Drop itineraries pricier than this (whole USD).

## `airlines` (type: `array`):

Only emit itineraries that include at least one of these 2-letter IATA airline codes, e.g. `AA`, `BA`, `DL`.

## `sortBy` (type: `string`):

Order of emitted records.

## `maxItems` (type: `integer`):

Hard cap on emitted records (per run, across all routes).

## Actor input object example

```json
{
  "mode": "search",
  "origin": "NYC",
  "destination": "LON",
  "routes": [],
  "startUrls": [],
  "tripType": "auto",
  "cabinClass": "economy",
  "adults": 1,
  "children": 0,
  "infantsLap": 0,
  "infantsSeat": 0,
  "directOnly": false,
  "maxStops": 3,
  "airlines": [],
  "sortBy": "price",
  "maxItems": 50
}
```

# Actor output Schema

## `flights` (type: `string`):

Dataset containing all scraped Skiplagged flight itineraries.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "origin": "NYC",
    "destination": "LON",
    "routes": [],
    "startUrls": [],
    "tripType": "auto",
    "cabinClass": "economy",
    "adults": 1,
    "children": 0,
    "infantsLap": 0,
    "infantsSeat": 0,
    "directOnly": false,
    "maxStops": 3,
    "airlines": [],
    "sortBy": "price",
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/skiplagged-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "origin": "NYC",
    "destination": "LON",
    "routes": [],
    "startUrls": [],
    "tripType": "auto",
    "cabinClass": "economy",
    "adults": 1,
    "children": 0,
    "infantsLap": 0,
    "infantsSeat": 0,
    "directOnly": False,
    "maxStops": 3,
    "airlines": [],
    "sortBy": "price",
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/skiplagged-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "origin": "NYC",
  "destination": "LON",
  "routes": [],
  "startUrls": [],
  "tripType": "auto",
  "cabinClass": "economy",
  "adults": 1,
  "children": 0,
  "infantsLap": 0,
  "infantsSeat": 0,
  "directOnly": false,
  "maxStops": 3,
  "airlines": [],
  "sortBy": "price",
  "maxItems": 50
}' |
apify call crawlerbros/skiplagged-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/skiplagged-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Skiplagged Flight Search Scraper",
        "description": "Scrape Skiplagged's flight search results - one-way, round-trip, and multi-route fare comparisons with real prices, airlines, flight numbers, durations, stops, and booking-provider data. No login, no proxy required.",
        "version": "1.0",
        "x-build-id": "fErLsz8zSzfhoXspl"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/crawlerbros~skiplagged-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-crawlerbros-skiplagged-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/crawlerbros~skiplagged-scraper/runs": {
            "post": {
                "operationId": "runs-sync-crawlerbros-skiplagged-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/crawlerbros~skiplagged-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-crawlerbros-skiplagged-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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "search",
                            "byRoutes",
                            "byUrls"
                        ],
                        "type": "string",
                        "description": "What to fetch.",
                        "default": "search"
                    },
                    "origin": {
                        "title": "Origin (mode=search)",
                        "type": "string",
                        "description": "Origin IATA airport code (e.g. `JFK`) or metro/city code (e.g. `NYC` covers JFK, LGA, EWR).",
                        "default": "NYC"
                    },
                    "destination": {
                        "title": "Destination (mode=search)",
                        "type": "string",
                        "description": "Destination IATA airport code (e.g. `LHR`) or metro/city code (e.g. `LON` covers LHR, LGW, STN, LTN, LCY).",
                        "default": "LON"
                    },
                    "departDate": {
                        "title": "Departure date (mode=search)",
                        "type": "string",
                        "description": "Departure date as `YYYY-MM-DD`. Leave blank to default to 6 weeks from today (keeps the daily test run always valid)."
                    },
                    "returnDate": {
                        "title": "Return date (mode=search)",
                        "type": "string",
                        "description": "Return date as `YYYY-MM-DD` for a round-trip search. Leave blank for a one-way search."
                    },
                    "routes": {
                        "title": "Routes (mode=byRoutes)",
                        "type": "array",
                        "description": "Batch of routes to search in one run. Each item: `{\"origin\":\"NYC\",\"destination\":\"LON\",\"departDate\":\"2026-09-01\",\"returnDate\":\"2026-09-08\"}` (`returnDate` optional for one-way).",
                        "default": []
                    },
                    "startUrls": {
                        "title": "Skiplagged URLs (mode=byUrls)",
                        "type": "array",
                        "description": "Skiplagged flight-search page URLs, e.g. `https://skiplagged.com/flights/NYC/LON/2026-09-01/2026-09-08`.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "tripType": {
                        "title": "Trip type",
                        "enum": [
                            "auto",
                            "one-way",
                            "round-trip"
                        ],
                        "type": "string",
                        "description": "One-way or round-trip. Auto-detected from whether a return date is present; this only matters when `returnDate` is ambiguous.",
                        "default": "auto"
                    },
                    "cabinClass": {
                        "title": "Cabin class",
                        "enum": [
                            "economy",
                            "premium-economy",
                            "business",
                            "first"
                        ],
                        "type": "string",
                        "description": "Requested cabin class. Skiplagged's public search does not always honor this — the real `fareClass` returned by the upstream is always included on every record.",
                        "default": "economy"
                    },
                    "adults": {
                        "title": "Adults",
                        "minimum": 1,
                        "maximum": 9,
                        "type": "integer",
                        "description": "Number of adult passengers (12+).",
                        "default": 1
                    },
                    "children": {
                        "title": "Children",
                        "minimum": 0,
                        "maximum": 8,
                        "type": "integer",
                        "description": "Number of child passengers (2-11).",
                        "default": 0
                    },
                    "infantsLap": {
                        "title": "Infants (on lap)",
                        "minimum": 0,
                        "maximum": 8,
                        "type": "integer",
                        "description": "Number of lap infants (under 2, no seat).",
                        "default": 0
                    },
                    "infantsSeat": {
                        "title": "Infants (own seat)",
                        "minimum": 0,
                        "maximum": 8,
                        "type": "integer",
                        "description": "Number of infants (under 2) with their own seat.",
                        "default": 0
                    },
                    "directOnly": {
                        "title": "Direct flights only",
                        "type": "boolean",
                        "description": "Only emit nonstop itineraries.",
                        "default": false
                    },
                    "maxStops": {
                        "title": "Max stops",
                        "minimum": 0,
                        "maximum": 3,
                        "type": "integer",
                        "description": "Drop itineraries with more stops than this.",
                        "default": 3
                    },
                    "minPrice": {
                        "title": "Min price (USD)",
                        "minimum": 0,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Drop itineraries cheaper than this (whole USD)."
                    },
                    "maxPrice": {
                        "title": "Max price (USD)",
                        "minimum": 0,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Drop itineraries pricier than this (whole USD)."
                    },
                    "airlines": {
                        "title": "Filter by airline IATA codes",
                        "type": "array",
                        "description": "Only emit itineraries that include at least one of these 2-letter IATA airline codes, e.g. `AA`, `BA`, `DL`.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "sortBy": {
                        "title": "Sort by",
                        "enum": [
                            "price",
                            "duration",
                            "departureTime",
                            "stops"
                        ],
                        "type": "string",
                        "description": "Order of emitted records.",
                        "default": "price"
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Hard cap on emitted records (per run, across all routes).",
                        "default": 50
                    }
                }
            },
            "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
