{ "openapi": "3.0.1", "info": { "title": "StubHub Scraper - Events, Ticket Prices & Venues", "description": "Collect public StubHub events, ticket prices, performer profiles and venue details. Search the main storefront or supply regional event URLs. Pay per delivered row plus a start fee.", "version": "0.1", "x-build-id": "DVqSlPCnOetk6bdjA" }, "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": [ "auto", "search", "performer", "event", "venue", "grouping", "category", "explore", "suggest", "categories", "cities", "sitemap" ], "type": "string", "description": "Leave on Auto to select a mode from your target fields. Select Suggest, Cities, Categories or Sitemap explicitly to request those results.", "default": "auto" }, "startUrls": { "title": "StubHub URLs", "type": "array", "description": "StubHub event or list-page URLs. Each URL selects the matching page type; event links return event details.", "items": { "type": "string" } }, "query": { "title": "Search query", "type": "string", "description": "One search phrase, such as weeknd, lakers or hamilton. Used by Search and Suggest; Auto selects Search when this is the only target." }, "eventUrl": { "title": "Event URL", "pattern": "^\\s*(https?://)?([A-Za-z0-9-]+\\.)*stubhub\\.[a-z.]+/.*$", "type": "string", "description": "Canonical StubHub event link. The event ID is read from the URL when eventId is not supplied." }, "eventId": { "title": "Event ID", "pattern": "^\\s*\\d+\\s*$", "type": "string", "description": "Numeric StubHub event ID, such as 159358883. A current canonical event URL is preferable when available." }, "detailUrls": { "title": "Detail URLs", "type": "array", "description": "List of StubHub event URLs to collect. Use these for event details or ticket listings.", "items": { "type": "string" } }, "listingIds": { "title": "Event IDs", "type": "array", "description": "List of numeric StubHub event IDs. Despite the field name, these are event IDs, not ticket-listing IDs.", "items": { "type": "string" } }, "performerId": { "title": "Performer ID", "pattern": "^\\s*\\d+\\s*$", "type": "string", "description": "Numeric artist or team ID from /performer/ in a StubHub URL. Used by Performer and Cities." }, "performerSlug": { "title": "Performer slug", "type": "string", "description": "Artist or team name as it appears in the URL, such as the-weeknd. Optional when performerId is supplied." }, "citySlug": { "title": "City filter slug", "type": "string", "description": "City text from a performer city-filter URL, such as london. Use with cityId in Performer mode." }, "cityId": { "title": "City filter ID", "pattern": "^\\s*\\d+\\s*$", "type": "string", "description": "Numeric city filter ID from a performer URL, such as 4031. Use with citySlug in Performer mode." }, "venueId": { "title": "Venue ID", "pattern": "^\\s*\\d+\\s*$", "type": "string", "description": "Venue page ID from /venue/ in the URL. Output calls this venuePageId and may include a different venueId." }, "venueSlug": { "title": "Venue slug", "type": "string", "description": "Venue name as it appears in the page URL. Optional when venueId is supplied." }, "groupingId": { "title": "Grouping ID", "pattern": "^\\s*\\d+\\s*$", "type": "string", "description": "Numeric tour or show grouping ID from /grouping/ in the URL, such as 130466796." }, "groupingSlug": { "title": "Grouping slug", "type": "string", "description": "Tour or show name as it appears in the grouping URL. Optional when groupingId is supplied." }, "categoryId": { "title": "Category ID", "pattern": "^\\s*\\d+\\s*$", "type": "string", "description": "Numeric category ID from a category row or /category/ URL." }, "categorySlug": { "title": "Category slug", "type": "string", "description": "Category text for Category mode. Without categoryId, this text is used as a search phrase." }, "city": { "title": "Explore city", "type": "string", "description": "Explore city preset, such as london, nyc, warsaw or sydney. Supply both lat and lon to use explicit coordinates instead." }, "lat": { "title": "Latitude (explore)", "type": "number", "description": "Latitude for Explore mode. Supply with lon to override the city preset." }, "lon": { "title": "Longitude (explore)", "type": "number", "description": "Longitude for Explore mode. Supply with lat to override the city preset." }, "maxResults": { "title": "Maximum rows per query, URL or ID", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum rows for each input query, URL or ID: 1-500, default 70; larger requests are collected in parts of up to 70. Profiles and listings share the limit; the run stops at your maximum charge, with Free plans capped at 200 rows per run and 10 runs.", "default": 70 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum list pages to examine, from 1 to 20. A higher value may find more events but does not guarantee complete coverage.", "default": 1 }, "includeListings": { "title": "Include ticket listings", "type": "boolean", "description": "In Event mode, return one billed row per ticket listing, with event and venue fields copied onto each row. Missing listings do not prove an event is sold out; check inventoryStatus and inventoryComplete.", "default": false }, "maxShowMore": { "title": "Listing pagination effort", "minimum": 0, "maximum": 20, "type": "integer", "description": "Listing pagination effort after the first page, from 0 to 20. Additional pages may be examined to continue results, but delivered rows still respect maxResults.", "default": 5 }, "quantity": { "title": "Ticket quantity", "minimum": 1, "maximum": 12, "type": "integer", "description": "Only return listings that can be bought in this ticket quantity, from 1 to 12. Leave empty for all listings." }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Only return listings priced at or above this per-ticket amount. Leave empty for no lower bound." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Only return listings priced at or below this per-ticket amount. Leave empty for no upper bound." }, "sectionIds": { "title": "Section IDs", "type": "array", "description": "Keep only listings in these numeric section IDs; local filtering applied to collected listing rows.", "items": { "type": "integer" } }, "zoneIds": { "title": "Zone IDs", "type": "array", "description": "Keep only listings in these numeric zone IDs; local filtering applied to collected listing rows.", "items": { "type": "integer" } }, "includeSeatMap": { "title": "Include venue geometry", "type": "boolean", "description": "In Event mode, attach available zone, section and row geometry. This does not provide individual-seat coordinates or ticket availability.", "default": false }, "includePerformerProfile": { "title": "Include performer profile", "type": "boolean", "description": "In Performer mode, add a separately billed performer profile row. Available fields may include genres, a Spotify track and viewer counts; this row shares maxResults with events.", "default": false }, "includeVenueProfile": { "title": "Include venue profile", "type": "boolean", "description": "In Venue mode, add a separately billed venue profile row. Available fields may include capacity, coordinates and address; this row shares maxResults with events.", "default": false }, "enrichDetails": { "title": "Enrich venue street from event page", "type": "boolean", "description": "Fill missing event times and venue addresses from event details when available. This does not guarantee phone numbers or email addresses.", "default": true }, "trackChanges": { "title": "Track price/inventory changes", "type": "boolean", "description": "Compare complete event inventory observations across runs when includeListings is enabled. Incomplete observations are skipped; matching rows receive a changes object.", "default": false }, "alertWebhookUrl": { "title": "Alert webhook URL (optional)", "type": "string", "description": "With trackChanges, send a JSON alert to this URL for price drops or listing changes. The first snapshot does not send an alert." }, "host": { "title": "Target host", "enum": [ "stubhub.com", "stubhub.co.uk", "stubhub.ie", "stubhub.de", "stubhub.fr", "stubhub.es", "stubhub.it", "stubhub.be", "stubhub.nl", "stubhub.com.au" ], "type": "string", "description": "Select the StubHub storefront; regional event IDs are not interchangeable with stubhub.com IDs. Keep event URLs on their original host; coverage varies by storefront and mode.", "default": "stubhub.com" }, "proxyCountry": { "title": "Proxy country (ISO-2)", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Optional two-letter country code for country-sensitive results, such as gb. Leave empty unless you need a particular country." }, "acquisitionMode": { "title": "Collection method", "enum": [ "auto", "browser" ], "type": "string", "description": "Leave on Auto for normal use. The alternative method is intended for developer comparisons.", "default": "auto" }, "venueComplete": { "title": "Expand venue event coverage", "type": "boolean", "description": "Look for additional venue events through related performer pages. This does not guarantee a complete venue calendar.", "default": false }, "venueUnionMaxPerformers": { "title": "Venue expansion performer limit", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum performer pages to check when venueComplete is enabled, from 1 to 30.", "default": 12 }, "venueUnionMaxDetailChecks": { "title": "Venue expansion detail limit", "minimum": 0, "maximum": 60, "type": "integer", "description": "Maximum event details to check when verifying expanded venue results, from 0 to 60.", "default": 24 }, "sitemapChildLimit": { "title": "Sitemap child limit", "minimum": 1, "maximum": 51, "type": "integer", "description": "Maximum child sitemaps to examine in Sitemap mode, from 1 to 51. Use a small value for a first run; omission adds no explicit child limit." }, "sitemapKinds": { "title": "Sitemap kinds", "type": "array", "description": "Filter discovery rows by page kind: event, performer, venue, grouping, category, performer_city or url. Leave empty for all kinds.", "items": { "type": "string" } }, "sitemapPool": { "title": "Developer catalog test", "type": "boolean", "description": "Leave disabled. Used only by the developer for testing.", "default": false }, "prewarmSeed": { "title": "Developer preparation test", "minimum": 0, "maximum": 20, "type": "integer", "description": "Leave at 0. Used only by the developer for testing.", "default": 0 }, "workerBaseUrl": { "title": "Developer test URL", "type": "string", "description": "Leave empty. Used only by the developer for testing." } } }, "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 } } } } } } } } } }