{ "openapi": "3.0.1", "info": { "title": "StubHub Scraper | Ticket Prices, Events, Venues & Performers", "description": "Extract StubHub ticket prices, events, venues and performers — concerts, sports, theater, comedy and festivals worldwide. Search, entity autocomplete, ticket listings and price-drop tracking. A StubHub API alternative for price monitoring and market research.", "version": "0.1", "x-build-id": "Xukhra8taAnDvkNM8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~stubhub-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-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/lentic_clockss~stubhub-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-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/lentic_clockss~stubhub-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-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", "properties": { "mode": { "title": "Mode", "enum": [ "search", "performer", "event", "venue", "grouping", "category", "explore", "suggest", "categories", "cities", "sitemap" ], "type": "string", "description": "search | performer | event | venue | grouping | category | explore | suggest (entity autocomplete rows, needs query) | categories (live category tree: 3 tops, 36 subs) | cities (performer city presets with lat/lon/cityId, needs performerId/performerSlug) | sitemap (zero-credential catalog discovery: ~2.22M event/performer/venue/category URLs from the public new-sitemap tree)", "default": "search" }, "host": { "title": "Target host", "enum": [ "stubhub.com", "stubhub.co.uk", "stubhub.ie", "stubhub.de", "stubhub.fr", "stubhub.es", "stubhub.nl", "stubhub.com.au" ], "type": "string", "description": "stubhub.com is the US/Canada inventory site. stubhub.co.uk, .ie, .de, .fr, .es, .nl and .com.au are a separate bfx inventory site: keep the event URL on that host. A UK event id is not a stubhub.com event id. .com.au follows through to the Ireland storefront.", "default": "stubhub.com" }, "proxyCountry": { "title": "Proxy country (ISO-2)", "type": "string", "description": "Pin the egress country, e.g. gb for UK inventory. Event LDPs redirect to a regional homepage when the egress geo mismatches the event country; also pins the Bright Data browser session (deep pagination, listings, explore)." }, "includePerformerProfile": { "title": "Include performer profile", "type": "boolean", "description": "mode=performer: prepend a performer metadata row (genres, spotifyTopTrackId, hottest event, hourly viewer count, leagueId/isTeamSport, available-event totals).", "default": false }, "includeVenueProfile": { "title": "Include venue profile", "type": "boolean", "description": "mode=venue: prepend a venue metadata row (capacity, lat/lon, full address, topLevelCategories).", "default": false }, "enrichDetails": { "title": "Enrich venue street from event page", "type": "boolean", "description": "Fill missing event time and venue address from event pages. Rich list sources may already supply these fields. No invented venue phones or email.", "default": true }, "acquisitionMode": { "title": "Collection route", "enum": [ "auto", "browser" ], "type": "string", "description": "Auto selects the supported public list route with browser fallback. Browser retains browser-only collection for comparison or rollback.", "default": "auto" }, "includeSeatMap": { "title": "Include venue geometry", "type": "boolean", "description": "Event detail only. Return zone/section/row GeoJSON when venueConfigId is available. Geometry is not inventory and does not contain individual-seat coordinates.", "default": false }, "venueComplete": { "title": "Expand venue event coverage", "type": "boolean", "description": "Bounded union of venue and performer pages, filtered back to the venue. Does not guarantee every event.", "default": false }, "venueUnionMaxPerformers": { "title": "Venue expansion performer limit", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum performer pages checked when expanding venue coverage.", "default": 12 }, "venueUnionMaxDetailChecks": { "title": "Venue expansion detail limit", "minimum": 0, "maximum": 60, "type": "integer", "description": "Maximum event detail checks used to verify venue membership during expansion.", "default": 24 }, "query": { "title": "Search query", "type": "string", "description": "Free-text search for mode=search, e.g. 'weeknd', 'lakers', 'hamilton'. Maps to stubhub.com/secure/search. Console Test prefills a short query so Start works without extra fields.", "default": "weeknd" }, "performerId": { "title": "Performer ID", "type": "string", "description": "StubHub numeric performer id for mode=performer, e.g. 714235 (The Weeknd). From /{slug}-tickets/performer/{id}." }, "performerSlug": { "title": "Performer slug", "type": "string", "description": "Performer slug, e.g. the-weeknd. Optional when performerId is given (slug mismatch redirects to canonical)." }, "citySlug": { "title": "City filter slug", "type": "string", "description": "Optional city filter for mode=performer, e.g. london. Pairs with cityId." }, "cityId": { "title": "City filter ID", "type": "string", "description": "Optional city filter id for mode=performer, e.g. 4031 (london). Path-encoded /{citySlug}-city/{cityId}." }, "venueId": { "title": "Venue ID", "type": "string", "description": "Venue page ID from /venue/{id}, not the separate venueId in event hydration. Output preserves both as venuePageId and venueId." }, "venueSlug": { "title": "Venue slug", "type": "string", "description": "Venue slug (optional alongside venueId)." }, "groupingId": { "title": "Grouping ID", "type": "string", "description": "StubHub numeric grouping (tour/show) id for mode=grouping, e.g. 130466796 (The Notebook The Musical)." }, "groupingSlug": { "title": "Grouping slug", "type": "string", "description": "Grouping slug (optional alongside groupingId)." }, "categoryId": { "title": "Category ID", "type": "string", "description": "StubHub numeric category id for mode=category (/category/{id})." }, "categorySlug": { "title": "Category slug", "type": "string", "description": "Category slug for mode=category. Without categoryId, falls back to a search query with this text." }, "eventId": { "title": "Event ID", "type": "string", "description": "StubHub numeric event id for mode=event, e.g. 159358883." }, "eventUrl": { "title": "Event URL", "type": "string", "description": "Full StubHub event URL for mode=event (eventId derived if missing)." }, "city": { "title": "Explore city", "type": "string", "description": "City name for mode=explore (geo preset: nyc, la, london, warsaw, tokyo, sydney, ...). Or pass explicit lat/lon." }, "lat": { "title": "Latitude (explore)", "type": "number", "description": "Explicit latitude for mode=explore (overrides city preset)." }, "lon": { "title": "Longitude (explore)", "type": "number", "description": "Explicit longitude for mode=explore (overrides city preset)." }, "maxResults": { "title": "Max results per query, URL, or ID", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum Dataset rows for each input query, URL, or ID (1-500; default 70). Larger values are collected in parts of up to 70 rows. Event, entity, optional profile, and ticket-listing rows all share the budget for their input. The run stops at your maximum total charge; free Apify plans allow 200 rows per run and 10 runs.", "default": 70 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum list pages. Explore uses its page parameter; other incomplete lists may require browser pagination. See listCoverage for actual completeness.", "default": 1 }, "includeListings": { "title": "Include ticket listings", "type": "boolean", "description": "For event detail, emit one Dataset row per ticket listing instead of embedding listings in one event row. Every listing row has rowType=listing, id/listingId, and copied event/date/venue/address/URL fields. Missing extraction does not mean sold out; inventoryComplete reports verified coverage.", "default": false }, "maxShowMore": { "title": "Max show-more clicks", "minimum": 0, "maximum": 20, "type": "integer", "description": "For mode=event with includeListings: minimum listings pagination effort beyond page 1 (0-20). The worker may fetch additional pages required to reach a returned cursor while still emitting at most maxResults rows.", "default": 5 }, "trackChanges": { "title": "Track price/inventory changes", "type": "boolean", "description": "For mode=event with includeListings: snapshot listings to a persistent store and diff against the previous run — adds a changes object (newListings, soldListings, priceDrops, priceChanges). Schedule the Actor to build price history over time.", "default": false }, "alertWebhookUrl": { "title": "Alert webhook URL (optional)", "type": "string", "description": "With trackChanges: POST a JSON alert to this URL when prices drop or inventory moves (never on the first snapshot)." }, "startUrls": { "title": "Start URLs (override)", "type": "array", "description": "Explicit StubHub URLs; mode is inferred per URL (/event/{id} = detail, others = list).", "items": { "type": "string" } }, "detailUrls": { "title": "Detail URLs", "type": "array", "description": "Event detail URLs (alias of startUrls for event LDP).", "items": { "type": "string" } }, "listingIds": { "title": "Event IDs", "type": "array", "description": "StubHub numeric event ids.", "items": { "type": "string" } }, "sitemapChildLimit": { "title": "Sitemap child limit", "minimum": 1, "maximum": 51, "type": "integer", "description": "mode=sitemap: cap child sitemaps fetched, 1–51 (each ~45k URLs). Omit for the full tree; small values make a fast discovery smoke." }, "sitemapKinds": { "title": "Sitemap kinds", "type": "array", "description": "mode=sitemap: filter emitted rows to event / performer / venue / category / performer_city / url. Omit for all.", "items": { "type": "string" } }, "sitemapPool": { "title": "Sitemap pool", "type": "boolean", "description": "mode=sitemap: harvest the FULL tree (all 51 children, ~2.22M URLs) streamed to a JSONL seed-pool file under the worker state dir — the run returns a small preview + seedPool {path, rows, urlsScanned} in warnings instead of buffering ~2.2M rows into the dataset.", "default": false }, "prewarmSeed": { "title": "Prewarm seed count", "minimum": 0, "maximum": 20, "type": "integer", "description": "After the credential session issues, fetch this many event LDPs from the sitemap seed pool (sitemapPool harvest) as a behavioural warmup + bundle-liveness check before the real query. 0 = off (default).", "default": 0 }, "workerBaseUrl": { "title": "Worker base URL (optional)", "type": "string", "description": "Override Cloud Run worker origin (allowlisted HTTPS). Default from Actor env." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }