# Stubhub Tickets Listings Scraper (`stealth_mode/stubhub-tickets-listings-scraper`) Actor

Scrape real-time ticket listings from StubHub with pricing, seat details, availability, and 75+ data fields. Perfect for ticket resellers, market analysts, and event data aggregators seeking structured ticket inventory.

- **URL**: https://apify.com/stealth\_mode/stubhub-tickets-listings-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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.md):

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

## StubHub Tickets Listings Scraper: Extract Event Ticket Data Instantly

---

### What Is StubHub?

StubHub is one of the world's largest peer-to-peer ticket marketplaces, hosting millions of live event tickets—concerts, sports, theater, comedy—from sellers worldwide. With dynamic pricing, seat-level inventory, and constantly updating availability, manually tracking or analyzing StubHub listings is impractical at scale. The **StubHub Tickets Listings Scraper** automates data extraction, turning listings into structured, actionable records.

---

### Overview

The **StubHub Tickets Listings Scraper** extracts comprehensive ticket inventory data from event listing pages, capturing pricing, seat location, seller information, and marketplace signals. Designed for:

- **Ticket resellers** monitoring competitor inventory and price trends
- **Market analysts** studying ticket market dynamics and demand patterns
- **Aggregator platforms** building cross-marketplace ticket databases
- **Event organizers** tracking secondary market activity for their events
- **Researchers** analyzing ticketing economics and consumer behavior

Key strengths include granular seat-level data, real-time pricing fields, deal scoring metrics, and configurable pagination to handle large inventory pages efficiently.

---

### Input Format

The scraper accepts a JSON configuration object with three core parameters:

```json
{
  "urls": [
    "https://www.stubhub.com/bts-saint-denis-tickets-7-17-2026/event/160262406/?quantity=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

#### Input Parameters Explained

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array of strings | Direct links to StubHub event listing pages. Include the event ID and optional quantity parameter for consistency. |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues processing remaining URLs if some fail. Recommended for bulk runs. If `false`, the entire scraper stops at the first failure. |
| `max_items_per_url` | Integer | Maximum ticket listings extracted per page. Default is `20`; can be increased to `200` for high-volume collection. Higher values extend runtime but capture more inventory snapshots. |

**Example URL structure:**

```
https://www.stubhub.com/[EVENT-NAME]-tickets-[DATE]/event/[EVENT-ID]/?quantity=[QTY]
```

> **Tip:** Add `?quantity=2` to filter for multi-ticket bundles, or omit it to capture all listing sizes.

***

### Output Format

**Sample output**

```json
{
  "id": 12316339801,
  "event_id": 160790802,
  "section": "411",
  "section_id": 1191672,
  "section_map_name": "411",
  "section_type": 2,
  "row": "54",
  "seat": "18_19",
  "seat_from_internal": "18",
  "has_seat_details": false,
  "has_seat_details_us": null,
  "available_tickets": 2,
  "formatted_fees": "",
  "grid_listing_price_and_fee_disclosure": {
    "has_value": false
  },
  "is_all_in_grid_listing_price_and_fee_disclosure": null,
  "inventory_listing_score": {
    "star_rating": 5,
    "deal_score": "8.998472393895899",
    "seat_quality_score": "1.164824319"
  },
  "show_recently_sold": null,
  "show_partnership_logo": null,
  "show_clear_view": null,
  "available_quantities": [
    2
  ],
  "ticket_class": 1288,
  "ticket_class_name": "Upper Tier",
  "max_quantity": 2,
  "has_listing_notes": null,
  "listing_notes": [
    {
      "listing_note_id": 106,
      "listing_note_content_id": 1683691,
      "formatted_listing_note_content": "Under 15s accompanied by an adult",
      "listing_note_type_id": 2,
      "show_to_buyer": true,
      "hide_in_mock": false,
      "site_added_listing_note": false,
      "aisle_listing_note_with_split": false,
      "listing_note_description_content_id": 1683692,
      "formatted_listing_note_description": "Children under 15 must be accompanied by an adult aged 18 or over."
    },
    {
      "listing_note_id": -1,
      "listing_note_content_id": 3338094,
      "formatted_listing_note_content": "Clear view",
      "listing_note_type_id": 3,
      "show_to_buyer": true,
      "hide_in_mock": false,
      "site_added_listing_note": false,
      "aisle_listing_note_with_split": false,
      "listing_note_description_content_id": 3338095,
      "formatted_listing_note_description": "You'll have an unrestricted view of the show."
    }
  ],
  "listing_note_buckets": [
    {
      "listing_note_bucket_id": 24,
      "formatted_listing_note_content": "Under 15s accompanied by an adult",
      "display_order": 24,
      "shows_raw_note_text": true,
      "source_listing_note_id": 106
    },
    {
      "listing_note_bucket_id": 26,
      "formatted_listing_note_content": "Clear view",
      "display_order": 8,
      "shows_raw_note_text": true,
      "source_listing_note_id": -1
    }
  ],
  "row_id": null,
  "is_users_listing": null,
  "is_pre_uploaded": null,
  "row_content": null,
  "is_speculative_row": null,
  "raw_price": 914.76,
  "price": "$915",
  "formatted_total_price": "$1,830",
  "strike_through_price": null,
  "strike_through_discount_percent": null,
  "strike_through_amount_off": null,
  "strike_through_price_default_currency": null,
  "ticket_type_id": null,
  "ticket_type_name": "Mobile Transfer ticket",
  "ticket_type_group_id": null,
  "listing_type_id": null,
  "listing_currency_code": null,
  "buyer_currency_code": null,
  "face_value": 250.0,
  "face_value_currency_code": null,
  "vfs_url": "https://img.vggcdn.net/img/vfsimage2/797514/1288_1191672/0.jpg?im=Resize=(500,271)&v=78",
  "formatted_active_since": null,
  "formatted_deal_score": null,
  "is_seated_together": null,
  "show_vfs_in_listing": null,
  "hide_seat_and_row_info": null,
  "is_unmapped_section": null,
  "aip_hash": null,
  "is_mlb_verified": null,
  "created_date_time": "2026-04-10T20:50:59.9570000Z",
  "show_cheapest_tag": null,
  "show_best_deal_tag": null,
  "show_best_deal_in_section_tag": null,
  "show_best_view_tag": null,
  "show_top_choice_tag": null,
  "top_choice_bucket": null,
  "is_most_affordable": null,
  "listing_ranking_score": null,
  "is_zone_ticket_class": null,
  "is_sponsored": null,
  "is_sponsored_secondary": null,
  "is_mirror_listing": null,
  "cross_sell_source": null,
  "is_cheapest_listing": null,
  "is_favorite": null,
  "aggregate_favorites": null,
  "listing_id": 12316339801,
  "can_be_relisted": null,
  "listing_impression_id": "0A4DE8AC-8BF9-40F7-B366-2BDAFB3A977A",
  "is_better_value_listing": null,
  "has_row_level_vfs": null,
  "is_deal_score_eligible_for_display": null,
  "listing_highlight_data": {
    "highlight_site_messages_with_type": [
      {
        "message": "Amazing Value",
        "qualifier": "Based on price, view, seat quality and more",
        "has_value": true,
        "message_type": "ValueBased"
      },
      {
        "message": "Popular Pick",
        "qualifier": "41 people viewed this event in the past hour",
        "has_value": true,
        "message_type": "NumberOfViewsSocialProofBased"
      }
    ],
    "listing_note_ids_replaced_by_highlight": []
  },
  "from_url": "https://www.stubhub.com/celine-dion-nanterre-tickets-9-19-2026/event/160790802/?quantity=2"
}
```

Each ticket listing returns a comprehensive record with 75+ fields organized into functional categories:

#### Listing & Event Identification

| Field | Meaning |
|---|---|
| `ID` | Unique identifier for this specific ticket listing on StubHub |
| `Listing ID` | Alternative primary key; used for tracking listing changes |
| `Event ID` | The event this ticket belongs to (links to other listings for the same event) |
| `Ticket Type ID` | Categorizes ticket type (e.g., general admission, VIP, accessible) |
| `Ticket Type Name` | Human-readable ticket class name |
| `Ticket Type Group ID` | Groups related ticket types |

#### Seat & Location Details

| Field | Meaning |
|---|---|
| `Section` | Stadium/venue section name (e.g., "101", "Lower Bowl") |
| `Section ID` | Internal ID for the section |
| `Section Map Name` | Display name used in seating maps |
| `Section Type` | Category (e.g., "Reserved", "General", "Standing Room") |
| `Row` | Row number or identifier within the section |
| `Row ID` | Internal row identifier |
| `Seat` | Specific seat number(s) in the row |
| `Seat From Internal` | Internal seat reference for complex layouts |
| `Has Seat Details` | Boolean indicating whether granular seat info exists |
| `Is Seated Together` | Whether multiple tickets are in adjacent seats |
| `Hide Seat And Row Info` | Some listings obscure seat details; this flag indicates masked data |
| `Is Unmapped Section` | Venue sections not yet mapped in StubHub's system |
| `Is Zone Ticket Class` | Ticket covers a general zone rather than fixed seats |

#### Pricing & Fees

| Field | Meaning |
|---|---|
| `Raw Price` | Base ticket price set by the seller (before fees) |
| `Price` | Display price, typically the base price |
| `Formatted Total Price` | Final price shown to buyer (base + all fees, formatted with currency) |
| `Strike Through Price` | Original/inflated price used to show discount (marketing) |
| `Strike Through Discount Percent` | Percentage discount advertised (e.g., "20% off") |
| `Strike Through Amount Off` | Dollar amount savings shown to buyer |
| `Strike Through Price Default Currency` | Currency code for the markdown |
| `Face Value` | Official face value printed on the ticket by the event organizer |
| `Face Value Currency Code` | Currency of the face value |
| `Formatted Fees` | Buyer fees formatted for display |
| `Listing Currency Code` | Currency in which the seller listed the ticket |
| `Buyer Currency Code` | Currency in which the buyer will be charged |

#### Availability & Inventory

| Field | Meaning |
|---|---|
| `Available Tickets` | Number of tickets in this listing available for purchase |
| `Available Quantities` | Array of available quantity options (e.g., 1, 2, 3, 4 tickets) |
| `Max Quantity` | Maximum tickets a single buyer can purchase from this listing |
| `Inventory Listing Score` | Internal ranking score for the listing's inventory status |

#### Marketplace Signals & Ranking

| Field | Meaning |
|---|---|
| `Formatted Deal Score` | StubHub's deal metric (lower is better value) |
| `Is Deal Score Eligible For Display` | Whether the deal score meets display criteria |
| `Listing Ranking Score` | Overall ranking position for search/browse (higher = better) |
| `Show Cheapest Tag` | Flag for displaying "Cheapest Ticket" badge |
| `Show Best Deal Tag` | Flag for "Best Deal" badge across event |
| `Show Best Deal In Section Tag` | Flag for "Best Deal in Section" badge |
| `Show Best View Tag` | Flag for "Best View" badge (based on seat quality) |
| `Show Top Choice Tag` | Flag for "Top Choice" (popular/trusted seller) badge |
| `Show Recently Sold` | Indicates recently sold listings shown for social proof |
| `Is Cheapest Listing` | Boolean: this is the lowest-priced ticket for the event |
| `Is Most Affordable` | Boolean: positioned as affordable/budget option |
| `Is Better Value Listing` | Boolean: good value relative to market |

#### Seller & Listing Metadata

| Field | Meaning |
|---|---|
| `Is Users Listing` | Boolean: the current logged-in user's own listing (for resellers) |
| `Is Pre Uploaded` | Boolean: ticket uploaded before sale (vs. automatically listed) |
| `Is Speculative Row` | Boolean: row number inferred/estimated by system |
| `Created Date Time` | When the listing was first posted to StubHub |
| `Formatted Active Since` | Human-readable posting date |
| `Is MLB Verified` | Boolean: MLB-verified authentic ticket (for sports) |
| `Can Be Relisted` | Boolean: seller can relist this ticket if it doesn't sell |
| `Listing Impression ID` | Tracks how this listing was displayed/impressioned |

#### Special Listing Types & Flags

| Field | Meaning |
|---|---|
| `Listing Type ID` | Type code (e.g., mobile transfer, physical mailing) |
| `Is Mirror Listing` | Boolean: duplicate listing (seller listed same ticket twice) |
| `Is Sponsored` | Boolean: seller paid for placement/promotion |
| `Is Sponsored Secondary` | Boolean: secondary promotional placement |
| `Cross Sell Source` | Source if this listing was syndicated from another seller |
| `Is Favorite` | Boolean: user has marked this listing as favorite |
| `Aggregate Favorites` | Total number of times this listing is favorited |

#### Content & Display

| Field | Meaning |
|---|---|
| `Has Listing Notes` | Boolean: seller included special notes (e.g., "Great view!") |
| `Listing Notes` | Free-text seller notes about the tickets |
| `Listing Note Buckets` | Categorized seller notes for easier parsing |
| `Row Content` | Additional row-level metadata |
| `VFS URL` | "View from Seat" video URL (if available) |
| `Show VFS In Listing` | Boolean: whether to display the view-from-seat video |
| `Has Row Level VFS` | Video available at row level (not individual seat) |
| `Show Clear View` | Boolean: "Clear View" badge for unobstructed sightlines |
| `Show Partnership Logo` | Partner vendor badge (e.g., official reseller) |
| `Listing Highlight Data` | Rich highlight metadata for UI rendering |

#### Buyer Protection & Compliance

| Field | Meaning |
|---|---|
| `AIP Hash` | Anti-fraud/integrity protection hash |
| `Top Choice Bucket` | Seller reputation tier for "Top Choice" status |
| `Is Grid Listing Price And Fee Disclosure` | Compliant price transparency flag |
| `Grid Listing Price And Fee Disclosure` | Full fee breakdown for regulatory compliance |

***

### How to Use

1. **Copy event URL** — Navigate to StubHub, find an event, and copy the listing page URL from your browser.
2. **Prepare input** — Paste the URL into the `urls` array. For bulk scraping, add multiple URLs separated by commas.
3. **Configure limits** — Set `max_items_per_url` to `20` for quick previews or `200` for comprehensive inventory snapshots.
4. **Run the scraper** — Initiate the actor. Monitor logs for progress.
5. **Download output** — Export results as JSON, CSV, or Excel for analysis.

**Best practices:**

- Use `max_items_per_url: 200` to capture the full inventory snapshot for trending analysis.
- Set `ignore_url_failures: true` for resilience if some event pages become unavailable.
- Combine pricing and deal score fields to identify market arbitrage opportunities.

***

### Use Cases & Business Value

- **Pricing intelligence:** Track competitor pricing and adjust markups in real time
- **Market analysis:** Measure demand patterns, seller competition, and margin trends
- **Arbitrage identification:** Spot price differences across events, sections, or dates
- **Inventory tracking:** Monitor ticket sell-through rates and supply-demand elasticity
- **API alternative:** Replace manual browsing with automated, structured data feeds

The StubHub Tickets Listings Scraper transforms unstructured marketplace data into actionable business intelligence, enabling data-driven ticketing strategies.

***

### Conclusion

The **StubHub Tickets Listings Scraper** is the essential tool for anyone serious about ticket market data. With 75+ fields covering pricing, inventory, seat location, and marketplace signals, it delivers insights that spreadsheet analysis simply cannot match. Whether you're a reseller optimizing margins, an analyst tracking market trends, or a platform builder, this scraper saves hours of manual work and unlocks competitive advantage.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the tickets listings urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://www.stubhub.com/bts-saint-denis-tickets-7-17-2026/event/160262406/?quantity=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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 = {
    "urls": [
        "https://www.stubhub.com/bts-saint-denis-tickets-7-17-2026/event/160262406/?quantity=2"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/stubhub-tickets-listings-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 = {
    "urls": ["https://www.stubhub.com/bts-saint-denis-tickets-7-17-2026/event/160262406/?quantity=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/stubhub-tickets-listings-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 '{
  "urls": [
    "https://www.stubhub.com/bts-saint-denis-tickets-7-17-2026/event/160262406/?quantity=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/stubhub-tickets-listings-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Stubhub Tickets Listings Scraper",
        "description": "Scrape real-time ticket listings from StubHub with pricing, seat details, availability, and 75+ data fields. Perfect for ticket resellers, market analysts, and event data aggregators seeking structured ticket inventory.",
        "version": "0.0",
        "x-build-id": "36GnQmbxg4g1tN5aW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~stubhub-tickets-listings-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-stubhub-tickets-listings-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/stealth_mode~stubhub-tickets-listings-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-stubhub-tickets-listings-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/stealth_mode~stubhub-tickets-listings-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-stubhub-tickets-listings-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "URLs of the tickets listings urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the tickets listings urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
