{ "openapi": "3.0.1", "info": { "title": "Ticketmaster Scraper | Events, Tickets & Seat-Level Prices", "description": "Scrape Ticketmaster concerts, sports, theater & family events in 23 countries. Search by keyword, artist, venue, category or geo; get dates, venues, sold-out status & seat-level primary + resale prices. Price tracking with webhook alerts. Free tier available.", "version": "0.1", "x-build-id": "hrQ28D0xkxdoJvgVc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~ticketmaster-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-ticketmaster-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~ticketmaster-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-ticketmaster-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~ticketmaster-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-ticketmaster-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", "artist", "venue", "category", "event" ], "type": "string", "description": "search | artist | venue | category | event", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Free-text search for mode=search, e.g. 'concert', 'lakers', 'hamilton'. Maps to ticketmaster /search. Store Test / empty defaults use 'concert' (1 high-success row).", "default": "concert" }, "market": { "title": "Market", "enum": [ "us", "uk", "ie", "ca", "au", "nz", "mx", "de", "at", "ch", "fr", "be", "nl", "it", "es", "se", "no", "dk", "fi", "pl", "cz", "ae", "za" ], "type": "string", "description": "Ticketmaster market host: us (ticketmaster.com), uk (ticketmaster.co.uk), ie, ca, au, nz, mx, de, at, ch, fr, be, nl, it, es, se, no, dk, fi, pl, cz, ae, za. Egress geo is pinned to the market automatically.", "default": "us" }, "startDate": { "title": "Start date (search filter)", "type": "string", "description": "mode=search: only events on/after this real calendar date (YYYY-MM-DD); must not be after endDate." }, "endDate": { "title": "End date (search filter)", "type": "string", "description": "mode=search: only events on/before this real calendar date (YYYY-MM-DD); must not be before startDate." }, "sort": { "title": "Sort (search)", "enum": [ "relevance", "date" ], "type": "string", "description": "mode=search sort order.", "default": "relevance" }, "classificationId": { "title": "Classification (genre/segment)", "type": "string", "description": "Filter by Ticketmaster classification: a genre/segment/subGenre id (KnvZfZ7v... / KZFzniwn...), a discover slug (concerts/sports/arts-theater/family), or a name alias (comedy, rock, hip-hop, country, latin, classical, reggae, jazz, metal, r&b, electronic, nfl, nba, mlb, soccer, boxing, mma, f1, theatre, musicals, circus, festivals, ...). mode=category browses it directly; mode=search without query behaves as a category browse. Not combinable with query." }, "latitude": { "title": "Latitude (geo search)", "minimum": -90, "maximum": 90, "type": "number", "description": "mode=search: geo center latitude (requires longitude)." }, "longitude": { "title": "Longitude (geo search)", "minimum": -180, "maximum": 180, "type": "number", "description": "mode=search: geo center longitude (requires latitude)." }, "radius": { "title": "Radius (geo search)", "minimum": 0.1, "maximum": 20000, "type": "number", "description": "mode=search: geo radius from 0.1 to 20000 (default 50)." }, "radiusUnit": { "title": "Radius unit", "enum": [ "miles", "km" ], "type": "string", "description": "Geo radius unit.", "default": "miles" }, "detailLevel": { "title": "Detail level (event mode)", "enum": [ "full", "fast" ], "type": "string", "description": "Requested event path: full opens the rendered EDP when needed; fast avoids that page. Output detailLevel is exactly one of tmr-ismds, ras-avsc, ras-manifest, edp-metadata, bff-metadata, discovery-metadata. edp-metadata means the EDP document was parsed for metadata and static seat-manifest counts, not live inventory.", "default": "full" }, "includePricing": { "title": "Include pricing (event mode)", "type": "boolean", "description": "Opt in to separately billed quickpick/resale listing rows and seat-map/RAS offer rows. All child rows share the same per-input maxResults allowance as their parent event. The event parent keeps compact counts and min/max summaries. Quickpicks quantity/pickSize is a recommended group size, not remaining inventory.", "default": false }, "includeSeatManifest": { "title": "Include seat manifest (event mode)", "type": "boolean", "description": "Opt in to seat geometry and RAS surfaces. RAS price levels can become separately billed offer rows and share the same per-input maxResults allowance; seatSkeleton/seatManifest describe layout and are not real-time remaining inventory.", "default": false }, "includeReviews": { "title": "Include reviews (artist mode)", "type": "boolean", "description": "mode=artist: also emit independent billed review rows (rowType=review). Uses the HTML path (reviews are not in the JSON API).", "default": false }, "includeSuggestions": { "title": "Include top suggestions", "type": "boolean", "description": "Browse modes: also emit independent top-suggestion rows (rowType=suggestion).", "default": false }, "enrichDetails": { "title": "Enrich venue contact (leads)", "type": "boolean", "description": "Fetch each unique venue page for box-office phones and full street address. Search cards only have 门牌; phones live on Venue generalInfoBlocks. Default on.", "default": true }, "shardByDate": { "title": "Shard by date (full crawls)", "type": "boolean", "description": "Browse modes: when the result total exceeds ~500 (API page cap), walk startDate..endDate in dateShardDays windows, deduped by eventId. Enables full-market crawls.", "default": false }, "dateShardDays": { "title": "Date shard window (days)", "minimum": 1, "maximum": 92, "type": "integer", "description": "Window size in days for shardByDate (1-92).", "default": 7 }, "trackChanges": { "title": "Track changes (monitoring)", "type": "boolean", "description": "Snapshot each emitted event's pricing/status into a named KV store and diff against the previous run: sold/new seat picks, per-pick price changes, lowestPrice movement, ticketingStatus/soldOut/cancelled/postponed/rescheduled transitions. Each row gains a `tracking` block. Best with mode=event schedules.", "default": false }, "alertWebhookUrl": { "title": "Alert webhook URL", "type": "string", "description": "With trackChanges: POST a JSON alert (ticketmaster.event.changed) to this public HTTPS URL when a diff shows price drops, inventory movement, or status changes. First snapshots never alert." }, "artistId": { "title": "Artist ID", "type": "string", "description": "Ticketmaster numeric artist/attraction id for mode=artist, e.g. 779049 (Shakira). From /{slug}-tickets/artist/{id}." }, "artistSlug": { "title": "Artist slug", "type": "string", "description": "Artist slug, e.g. shakira. Optional label alongside the required artistId." }, "venueId": { "title": "Venue ID", "type": "string", "description": "Ticketmaster numeric venue id for mode=venue, e.g. 106601 (Kaseya Center)." }, "venueSlug": { "title": "Venue slug", "type": "string", "description": "Venue seo path, e.g. kaseya-center-tickets-miami. Optional label alongside the required venueId." }, "categorySlug": { "title": "Category slug", "enum": [ "concerts", "sports", "arts-theater", "family" ], "type": "string", "description": "Discover category for mode=category: concerts | sports | arts-theater | family." }, "categoryId": { "title": "Category ID", "type": "string", "description": "Ticketmaster segment id (e.g. KZFzniwnSyZfZ7v7nJ = Music). Mapped to a discover slug when known." }, "eventId": { "title": "Event ID", "pattern": "^[0-9A-Za-z_-]{6,40}$", "type": "string", "description": "Ticketmaster event id for mode=event. Accepts TMOL HOST hex IDs, TMR/Z IDs, and underscore-bearing IDs (6-40 letters/numbers/_/-), for example Z1r9uZrrZbpZ1Avqe_0." }, "eventUrl": { "title": "Event URL", "type": "string", "description": "Full Ticketmaster event URL for mode=event; HOST, TMR/Z, and underscore-bearing event IDs are derived from /event/{id}." }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum delivered and billed rows for each Start URL, Detail URL, or Event ID in an explicit list; a scalar search, artist, venue, category, or event request counts as one input. All row types for one input share this allowance. Default 70; larger requests are collected in parts of 70. The whole run stops at your maximum total charge. Free Apify plan: 200 rows per run and 10 runs.", "default": 70 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 25, "type": "integer", "description": "Compatibility page hint. The entity row stream pages internally until maxResults is filled or the source ends.", "default": 1 }, "startUrls": { "title": "Start URLs (override)", "type": "array", "description": "Explicit Ticketmaster URLs; mode is inferred per URL (/event/{id} = event detail, others = list).", "items": { "type": "string" } }, "detailUrls": { "title": "Detail URLs", "type": "array", "description": "Event detail (EDP) URLs.", "items": { "type": "string" } }, "listingIds": { "title": "Event IDs", "type": "array", "description": "TMOL event ids or Ticketmaster /event/{id} URLs (batch event detail). A non-empty list is a complete target override: eventId/eventUrl are ignored.", "items": { "type": "string" } }, "workerBaseUrl": { "title": "Worker base URL (optional)", "type": "string", "description": "Local-development override. On the Apify platform it is honored only when it exactly matches the configured worker.opendata.best/b/ticketmaster-com broker route; other values are ignored." }, "timeBudgetSecs": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Total time for this run, including waiting in the queue. The scraper plans around it: slow browser steps that cannot finish in time are skipped, and quick event data is saved first. Leave empty to use the run timeout. When you call the Actor with a short timeout (for example from an MCP client), the shorter of the two is used." }, "onTimeout": { "title": "When time runs out", "enum": [ "partial", "fail" ], "type": "string", "description": "partial: save the rows collected so far and finish successfully; RUN_SUMMARY.status is PARTIAL and explains what was skipped. fail: finish as failed (error deadline_exceeded) without saving or charging for rows. A run that collected no rows always fails with a clear reason.", "default": "partial" }, "progressIntervalSecs": { "title": "Progress update interval (seconds)", "minimum": 2, "maximum": 30, "type": "integer", "description": "How often the run checks the job and refreshes the status message and the PROGRESS record in the key-value store (2-30).", "default": 4 } } }, "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 } } } } } } } } } }