{ "openapi": "3.0.1", "info": { "title": "Ticketmaster Scraper - Events, Tickets & Prices", "description": "Collect Ticketmaster events, ticket prices, artist calendars and venue details across 23 supported markets. Pay per delivered row plus a small start fee; optional ticket and review rows use the same row limit.", "version": "0.2", "x-build-id": "uZeOHVbjoGhshuTvl" }, "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": [ "auto", "search", "artist", "venue", "category", "event" ], "type": "string", "description": "Leave on Auto to select a mode from your target fields. If a selected mode has no target, the Actor follows another target you supplied.", "default": "auto" }, "query": { "title": "Search query", "type": "string", "description": "Search keyword, such as concert. With no target fields, the Actor starts a normally billed concert example with at most 3 rows." }, "eventUrl": { "title": "Event URL", "pattern": "^\\s*(https?://)?([A-Za-z0-9-]+\\.)*ticketmaster\\.[A-Za-z.]{2,10}(/.*)?$", "type": "string", "description": "Link to a Ticketmaster event page on a supported country site, with or without www. The event ID is read from the event link." }, "eventId": { "title": "Event ID", "pattern": "^[0-9A-Za-z_-]{6,40}$", "type": "string", "description": "Event ID from a Ticketmaster link: 6 to 40 letters, numbers, underscores or hyphens. Standard and resale event IDs are accepted." }, "artistId": { "title": "Artist ID", "type": "string", "description": "Numeric artist ID from a Ticketmaster artist page, such as 779049. Required for artist mode unless you provide a target URL list." }, "artistSlug": { "title": "Artist slug", "type": "string", "description": "Optional artist URL label alongside artistId. A slug alone does not identify an artist for collection." }, "venueId": { "title": "Venue ID", "type": "string", "description": "Numeric venue ID from a Ticketmaster venue page, such as 106601. Required for venue mode unless you provide a target URL list." }, "venueSlug": { "title": "Venue slug", "type": "string", "description": "Optional venue URL label alongside venueId. A slug alone does not identify a venue for collection." }, "categorySlug": { "title": "Category slug", "enum": [ "concerts", "sports", "arts-theater", "family" ], "type": "string", "description": "Browse concerts, sports, arts-theater or family events. Use categoryId or classificationId for other supported category filters." }, "categoryId": { "title": "Category ID", "type": "string", "description": "Ticketmaster segment ID, such as KZFzniwnSyZfZ7v7nJ for Music. Known IDs select the matching category." }, "startUrls": { "title": "Start URLs (override)", "type": "array", "description": "List of Ticketmaster event or browse page URLs. A nonempty target list replaces scalar event targets; each input has its own maxResults allowance.", "items": { "type": "string" } }, "detailUrls": { "title": "Detail URLs", "type": "array", "description": "List of Ticketmaster event page URLs. Each input has its own maxResults allowance.", "items": { "type": "string" } }, "listingIds": { "title": "Event IDs", "type": "array", "description": "List of event IDs or Ticketmaster event page URLs. A nonempty target list replaces eventId and eventUrl.", "items": { "type": "string" } }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum delivered and billed rows per input, shared by events and optional rows: default 70, prefill 3, maximum 500; larger requests are collected in parts of 70. The run also stops at your maximum cost; Free plan users have 10 runs with at most 200 rows per run.", "default": 70 }, "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 country site to search, such as us, uk, de or au. Choose one of the 23 listed markets; event and ticket coverage varies by country.", "default": "us" }, "startDate": { "title": "Start date (search filter)", "type": "string", "description": "Include events on or after this calendar date in YYYY-MM-DD format. Leave empty for all upcoming dates; it must not be later than endDate." }, "endDate": { "title": "End date (search filter)", "type": "string", "description": "Include events on or before this calendar date in YYYY-MM-DD format. Use a current or future date, not earlier than startDate, or leave empty." }, "sort": { "title": "Sort (search)", "enum": [ "relevance", "date" ], "type": "string", "description": "Search ordering: relevance or date. The input form selects relevance.", "default": "relevance" }, "classificationId": { "title": "Classification (genre/segment)", "type": "string", "description": "Classification ID, category slug or alias such as comedy, rock, nfl or musicals. Use it instead of query to browse a classification." }, "latitude": { "title": "Latitude (geo search)", "minimum": -90, "maximum": 90, "type": "number", "description": "Search-center latitude from -90 to 90. Supply longitude as well." }, "longitude": { "title": "Longitude (geo search)", "minimum": -180, "maximum": 180, "type": "number", "description": "Search-center longitude from -180 to 180. Supply latitude as well." }, "radius": { "title": "Radius (geo search)", "minimum": 0.1, "maximum": 20000, "type": "number", "description": "Search radius from 0.1 to 20000 in radiusUnit. When omitted, the distance is 50." }, "radiusUnit": { "title": "Radius unit", "enum": [ "miles", "km" ], "type": "string", "description": "Distance unit for geographic search: miles or km. The default is miles.", "default": "miles" }, "detailLevel": { "title": "Event detail level", "enum": [ "full", "fast" ], "type": "string", "description": "Choose full for more event details, or fast for reduced-detail collection. Returned detailLevel labels describe actual coverage and do not guarantee live inventory.", "default": "full" }, "includePricing": { "title": "Include pricing (event mode)", "type": "boolean", "description": "Add separately billed listing and offer rows within the same maxResults allowance as the event. Recommended pick quantity is a purchase group size, not remaining stock.", "default": false }, "includeSeatManifest": { "title": "Include seating layout and availability", "type": "boolean", "description": "Request seating layout and available seat counts; price levels may add separately billed offer rows within maxResults. Layout geometry is not remaining inventory.", "default": false }, "includeReviews": { "title": "Include reviews (artist mode)", "type": "boolean", "description": "Add separately billed public artist review rows when available. Reviews share the same maxResults allowance.", "default": false }, "includeSuggestions": { "title": "Include top suggestions", "type": "boolean", "description": "Add separately billed suggested-event rows in browse modes when available. Suggestions share the same maxResults allowance.", "default": false }, "enrichDetails": { "title": "Include venue contacts", "type": "boolean", "description": "Add available public venue box-office phone numbers and address details. Enabled by default; missing contacts remain empty.", "default": true }, "shardByDate": { "title": "Search date windows", "type": "boolean", "description": "Split supported browse searches into date windows to work beyond individual search-page limits. Results are deduplicated by event ID but still respect row and cost limits.", "default": false }, "dateShardDays": { "title": "Date window length (days)", "minimum": 1, "maximum": 92, "type": "integer", "description": "Date-window length when shardByDate is enabled: 1 to 92 days. The default is 7.", "default": 7 }, "enumerate": { "title": "Browse saved market targets", "type": "boolean", "description": "With no keyword or ID target, browse saved targets for the selected market instead of starting the small example search. Coverage depends on available targets and does not guarantee every event.", "default": false }, "seedKind": { "title": "Saved target type", "enum": [ "classification", "venue", "attraction", "all" ], "type": "string", "description": "Saved target family for enumerate: classification, venue, attraction or all. Classification targets find events; venue and attraction targets can provide profile rows.", "default": "classification" }, "trackChanges": { "title": "Track changes (monitoring)", "type": "boolean", "description": "Compare delivered rows with previously saved pricing and status snapshots and add a tracking field. The first snapshot does not trigger an alert.", "default": false }, "alertWebhookUrl": { "title": "Alert webhook URL", "type": "string", "description": "With trackChanges enabled, send ticketmaster.event.changed alerts to this public HTTPS URL when observed prices or status change. First snapshots do not alert; redirects are not followed." }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 25, "type": "integer", "description": "Page-count hint from 1 to 25. Collection can continue until the row allowance is filled or the source ends.", "default": 1 }, "workerBaseUrl": { "title": "Developer test setting", "type": "string", "description": "Leave empty. Used only by the developer for testing." }, "timeBudgetSecs": { "title": "Time budget (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Total time allowance, including waiting, from 30 to 3600 seconds. Leave empty to use the run timeout; if both are set, the shorter limit applies." }, "onTimeout": { "title": "When time runs out", "enum": [ "partial", "fail" ], "type": "string", "description": "Choose partial to save available rows and finish with RUN_SUMMARY.status=PARTIAL, or fail to reject the unfinished result without saving those rows. A deadline reached without rows fails with a reason.", "default": "partial" }, "progressIntervalSecs": { "title": "Progress update interval (seconds)", "minimum": 2, "maximum": 30, "type": "integer", "description": "How often the status message and PROGRESS record are refreshed, from 2 to 30 seconds. The default is 4.", "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 } } } } } } } } } }