# StubHub Ticket Marketplace Scraper (`crawlerbros/stubhub-scraper`) Actor Scrape StubHub.com event listings by keyword, artist, team, venue, or category. Get event title, date/time, venue, city/state, category, and listing URL - no login required. - **URL**: https://apify.com/crawlerbros/stubhub-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, E-commerce, Agents - **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 ## StubHub Scraper Scrape [StubHub](https://www.stubhub.com) — one of the world's largest ticket resale marketplaces for concerts, sports, and theater. Search events by artist / team / venue / keyword, or browse by category (NBA, NFL, Pop/Rock, Comedy, and 33 more). Get event titles, dates, venues, cities, and direct listing URLs. No login, no cookies, no proxy required. ### What this actor does - **Two modes:** `search` (free-text keyword) and `byCategory` (taxonomy browse — 36 sports/concert/theater categories) - **Filters:** event date range, country, confirmed-date-only, active-listings-only - **Empty fields are omitted** — every record only contains data StubHub actually provided ### Output per event - `eventId` — StubHub's internal numeric event ID - `eventTitle` — event / performer / team name - `eventDate`, `eventTime`, `dayOfWeek` — human-readable date/time as shown on StubHub - `eventDateTime` — UTC ISO 8601 timestamp (when StubHub resolves one server-side) - `venueName`, `venueId`, `venueCity`, `venueState`, `venueLocation` - `country`, `countryCode` - `isDateConfirmed`, `isTimeConfirmed`, `hasActiveListings` - `unavailabilityMessage` — StubHub's own reason text when the event currently has no active listings (e.g. `"Sold out for now"`), when shown - `isDateTbd` — the exact date/time is still to-be-determined (event is scheduled but not fully pinned down) - `eventCountdown` — StubHub's human-readable countdown/urgency message for the event (e.g. `"This weekend"`), when shown - `allowPublicPurchase` — whether the general public can currently buy tickets for this event (`false` for e.g. presale-restricted or unlisted events) - `isMultidayEvent` — event spans multiple days (festivals, multi-night residencies, etc.) - `rescheduledFromDate` — the event's original date, when StubHub shows it was rescheduled (omitted when not rescheduled) - `listingUrl` / `sourceUrl` — canonical StubHub event page - `recordType: "event"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` / `byCategory` | | `searchQuery` | string | – | Free-text query (required for `search`; optional refinement for `byCategory`) | | `category` | select | – | Event category (required for `byCategory`; optional search hint for `search` — StubHub does not guarantee results are restricted to it) | | `country` | select | – | `US` or `CA` — records missing country data are not excluded | | `dateFrom` / `dateTo` | string (ISO 8601) | – | Event date-range filter | | `confirmedDateOnly` | bool | `false` | Only include events with a confirmed date (excludes TBD) | | `activeListingsOnly` | bool | `false` | Only include events that currently have active ticket listings (excludes sold-out events) | | `maxItems` | int | `20` | Hard cap on emitted records (1–100) | #### Example: search by artist ```json { "mode": "search", "searchQuery": "Taylor Swift", "maxItems": 20 } ```` #### Example: browse NBA tickets ```json { "mode": "byCategory", "category": "6453", "maxItems": 20 } ``` #### Example: search with category and date-range filters ```json { "mode": "search", "searchQuery": "concert", "category": "260542", "dateFrom": "2026-08-01T00:00:00+00:00", "confirmedDateOnly": true } ``` ### Use cases - **Ticket / availability monitoring** — track when new events go on sale for a favorite artist or team - **Event discovery** — feed StubHub's live event catalog into an events aggregator - **Fan tooling** — build alerts for a favorite artist's or team's tour dates - **Market research** — track event density and calendar coverage by category ### Limitations - **Result size per query:** StubHub's search endpoint (`/search?q=...`) returns up to ~20 results per keyword query server-side, regardless of `maxItems`. This is an upstream limit of the search-results page itself, not a bug — the actor faithfully reports every result the page returns. For broader coverage, run multiple `search` / `byCategory` calls with different keywords or categories. - **Ticket price and ticket-count are not available.** StubHub renders these fields client-side, after the page loads, via a request gated by the site's DataDome bot-protection layer — the same protection that blocks individual event ticket-listing pages and StubHub's city/geography browse pages entirely (HTTP 403, confirmed from both a direct connection and Apify's free AUTO proxy). Rather than ship unreliable or fabricated pricing data, the actor focuses on the event metadata (title, date, venue, location) that StubHub serves reliably and consistently on every request. - **`listingUrl` loads fine in a real browser but returns HTTP 403 to plain HTTP clients** (curl, `requests`, etc.) — StubHub's DataDome protection requires executing the page's JS challenge, which only a real browser (or a JS-capable engine) can do. The URL itself is correct and canonical; simply open it in a browser rather than fetching it programmatically. - **No dedicated city-browse mode.** An earlier version of this actor included a `byCity` mode backed by StubHub's per-metro-area browse pages; those pages returned HTTP 403 consistently from Apify's cloud infrastructure (both direct and via the free AUTO proxy group), so the mode was removed rather than ship an unreliable feature. To find events in a specific city, include the city name in `searchQuery` (e.g. `"concerts in Chicago"`) — result relevance depends on StubHub's own search ranking. - **Global coverage:** StubHub's search index spans many countries; the `country` filter currently offers a curated `US`/`CA` shortlist since those are the two markets consistently observed in test data. Events from other countries still appear in `search` / `byCategory` results (see the `country` / `countryCode` output fields) — they're just not filterable via the dropdown yet. - **`category` is a search hint, not a guaranteed filter.** StubHub's `/search` endpoint does not reliably restrict results to the requested `categoryId` server-side — e.g. a `category=NBA` search can still return college-football or lacrosse events that merely match the keyword. Because StubHub never reports an individual event's own category in the scraped data, the actor does not fabricate a `category`/`categoryGroup` output field from the input filter; only fields StubHub actually returns per-event are included. ### FAQ **Do I need a StubHub account or cookies?** No. Both modes hit publicly server-rendered pages that don't require login. **Why isn't there a ticket price field?** StubHub only renders ticket pricing after client-side JavaScript executes a request that's protected against automated access (DataDome). The actor reports rich event metadata (title, date, venue, location) reliably instead of guessing at prices. **What's the difference between `search` and `byCategory`?** `search` runs StubHub's free-text search; `byCategory` runs the same search pre-filtered to one of StubHub's 36 curated categories (e.g. `NBA`, `Pop/Rock`, `Comedy`), optionally refined with your own `searchQuery`. **Can I get more than 20 results for a single keyword?** Not from a single call — that's StubHub's own page-level cap. Run multiple calls with different keywords/categories for broader coverage. **How fresh is the data?** Real-time — every run fetches StubHub's live search/browse pages directly. **Can I exclude sold-out events?** Yes — set `activeListingsOnly` to `true` to only return events that currently have active ticket listings. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `searchQuery` (type: `string`): Free-text query — artist, team, venue, or event name (mode=search, required; mode=byCategory, optional refinement). ## `category` (type: `string`): Event category (mode=byCategory, required; mode=search, optional filter). ## `country` (type: `string`): Filter results to a specific country, e.g. `US` or `CA`. Records missing country data are not excluded. ## `dateFrom` (type: `string`): Only include events on/after this UTC datetime, e.g. `2026-08-01T00:00:00+00:00`. Records without a resolvable event datetime are not excluded. ## `dateTo` (type: `string`): Only include events on/before this UTC datetime. Records without a resolvable event datetime are not excluded. ## `confirmedDateOnly` (type: `boolean`): Only include events whose date is confirmed (excludes TBD-date events). ## `activeListingsOnly` (type: `boolean`): Only include events that currently have active ticket listings (excludes sold-out / no-tickets-available events). ## `maxItems` (type: `integer`): Hard cap on emitted records. Note: StubHub's search endpoint returns up to ~20 results per keyword query (an upstream page-level limit). ## Actor input object example ```json { "mode": "search", "searchQuery": "Taylor Swift", "category": "260542", "country": "", "dateFrom": "", "dateTo": "", "confirmedDateOnly": false, "activeListingsOnly": false, "maxItems": 20 } ``` # Actor output Schema ## `events` (type: `string`): Dataset containing all scraped StubHub events. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "searchQuery": "Taylor Swift", "category": "260542", "country": "", "dateFrom": "", "dateTo": "", "confirmedDateOnly": false, "activeListingsOnly": false, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/stubhub-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "searchQuery": "Taylor Swift", "category": "260542", "country": "", "dateFrom": "", "dateTo": "", "confirmedDateOnly": False, "activeListingsOnly": False, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/stubhub-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", "searchQuery": "Taylor Swift", "category": "260542", "country": "", "dateFrom": "", "dateTo": "", "confirmedDateOnly": false, "activeListingsOnly": false, "maxItems": 20 }' | apify call crawlerbros/stubhub-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/stubhub-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "StubHub Ticket Marketplace Scraper", "description": "Scrape StubHub.com event listings by keyword, artist, team, venue, or category. Get event title, date/time, venue, city/state, category, and listing URL - no login required.", "version": "1.0", "x-build-id": "s3hhTpQRgid7tQclh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~stubhub-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-stubhub-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~stubhub-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-stubhub-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~stubhub-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-stubhub-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", "byCategory" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text query — artist, team, venue, or event name (mode=search, required; mode=byCategory, optional refinement).", "default": "" }, "category": { "title": "Category", "enum": [ "", "6453", "6456", "5084", "4871", "5062", "263024", "1012", "1009", "5099", "5213", "26796", "273026", "14163", "4080", "1006", "5133", "260542", "1207", "1059", "1014", "1027", "1023", "1026", "259833", "1022", "1205", "1015", "1017", "259716", "6403", "358959", "4654", "356499", "1013", "2294", "150002820" ], "type": "string", "description": "Event category (mode=byCategory, required; mode=search, optional filter).", "default": "" }, "country": { "title": "Country (2-letter code)", "enum": [ "", "US", "CA" ], "type": "string", "description": "Filter results to a specific country, e.g. `US` or `CA`. Records missing country data are not excluded.", "default": "" }, "dateFrom": { "title": "Event date from (ISO 8601)", "type": "string", "description": "Only include events on/after this UTC datetime, e.g. `2026-08-01T00:00:00+00:00`. Records without a resolvable event datetime are not excluded.", "default": "" }, "dateTo": { "title": "Event date to (ISO 8601)", "type": "string", "description": "Only include events on/before this UTC datetime. Records without a resolvable event datetime are not excluded.", "default": "" }, "confirmedDateOnly": { "title": "Confirmed dates only", "type": "boolean", "description": "Only include events whose date is confirmed (excludes TBD-date events).", "default": false }, "activeListingsOnly": { "title": "Active listings only", "type": "boolean", "description": "Only include events that currently have active ticket listings (excludes sold-out / no-tickets-available events).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard cap on emitted records. Note: StubHub's search endpoint returns up to ~20 results per keyword query (an upstream page-level limit).", "default": 20 } } }, "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 } } } } } } } } } } ```