{ "openapi": "3.0.1", "info": { "title": "AXS Scraper - Events, Venues and Ticketing Status", "description": "Extract AXS events, venues, performers, series and promotions across nine regional catalogs (US, UK, AU, SE, CA, NZ, DE, FR, JP). Get dates, venue addresses and public ticketing status; inventory requires an invitation. Pay per delivered row plus a start fee.", "version": "0.1", "x-build-id": "QQTtfQd6Cl5IcpD7o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~axs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-axs-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~axs-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-axs-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~axs-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-axs-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", "home", "search", "detail", "venue", "category", "inventory", "onsale", "catalog", "performer", "series", "offers", "genres", "discovery", "watch" ], "type": "string", "description": "Auto selects a mode from the target fields you fill; empty input starts a small example search. Choose inventory for invitation-only snapshots, onsale for ticket configuration, watch for one status check, or discovery for an unfiltered export.", "default": "auto" }, "startUrls": { "title": "Start URLs", "type": "array", "description": "AXS event, venue or category URLs. In inventory or onsale mode, AXS purchase links and shop.axs.com redirect links are also accepted; no ticket purchase or reservation is made.", "items": { "type": "string" } }, "eventIds": { "title": "Event IDs", "type": "array", "description": "Numeric AXS IDs from event URLs such as /events/1445907. Each ID is a separate input for maxResults; all targets share the run timeout and maximum cost.", "items": { "type": "string" } }, "ticketUrls": { "title": "FanSight purchase URLs", "type": "array", "description": "AXS purchase links for inventory or onsale, such as https://tix.axs.com/ or https://tickets-{cc}.axs.com/. Used only to observe ticket information, never to buy or reserve.", "items": { "type": "string" } }, "venueIds": { "title": "Venue IDs", "type": "array", "description": "Numeric AXS IDs from venue URLs such as /venues/124944.", "items": { "type": "string" } }, "performerIds": { "title": "Performer IDs", "type": "array", "description": "Numeric artist IDs from AXS performer URLs or catalog rows. Leave empty in performer mode to list performers.", "items": { "type": "string" } }, "seriesIds": { "title": "Series IDs", "type": "array", "description": "AXS series IDs for series mode. Find IDs with catalog mode first.", "items": { "type": "string" } }, "offerIds": { "title": "Promotion offer IDs", "type": "array", "description": "Promotion IDs for offers mode. These identify promotions, not ticket seats.", "items": { "type": "string" } }, "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword for search mode, such as concert. Enter a location in city or cityId instead." }, "q": { "title": "Query alias", "type": "string", "description": "Alternative name for searchQuery." }, "category": { "title": "Category", "enum": [ "music", "sports", "theatre", "festival", "comedy" ], "type": "string", "description": "Filter events by music, sports, theatre, festival or comedy within the scanned pages. A limited scan does not guarantee complete coverage." }, "city": { "title": "City", "type": "string", "description": "Supported US city name, such as Denver, CO. Results are matched against the venue city and state." }, "cityId": { "title": "City GeoNames id", "type": "string", "description": "City ID from an AXS URL with the form /category/cities/{id}/{slug}. For an unknown ID, also provide citySlug." }, "citySlug": { "title": "City slug", "type": "string", "description": "City slug from an AXS city URL, such as denver-co. Required when the cityId is not already recognized." }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Most Dataset rows for each search query, URL, or ID input (or for the selected browse mode when no list is supplied). Default 70; larger numbers are collected in parts of 70. All row types count together for that input. The run stops at your maximum total charge. Free Apify plan: 200 rows per run and 10 runs of this Actor.", "default": 70 }, "maxPages": { "title": "Max listing pages", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum listing pages to scan, from 1 to 5, starting at page. This does not guarantee that the entire catalog has been scanned.", "default": 1 }, "market": { "title": "Market", "enum": [ "us", "uk", "au", "se", "ca", "nz", "de", "fr", "jp" ], "type": "string", "description": "Regional AXS catalog: us, uk, au, se, ca, nz, de, fr or jp. us/uk use their siteId partitions; other markets filter the discovery feed by country. Inventory and onsale modes route by the event's region automatically.", "default": "us" }, "enrichDetails": { "title": "Enrich event detail", "type": "boolean", "description": "Add event details to listing rows when available. Enabled by default.", "default": true }, "enrichVenue": { "title": "Enrich venue page", "type": "boolean", "description": "Add information from the venue page when an event lacks a full address. Enabled by default.", "default": true }, "memberLinks": { "title": "Resolve member purchase links", "type": "boolean", "description": "Series mode only: add each member event's promotion purchase page (promoId, promoPageUrl, and ticketUrl when missing). Uses the headless page lane once per series and may fail gracefully behind region blocks, in which case rows are still returned without links. Enabled by default.", "default": true }, "entityTypes": { "title": "Entity types", "type": "array", "description": "Catalog supports events, venues, performers and series; search supports events, venues and performers. Discovery supports events, venues, performers and tours.", "default": [ "events" ], "items": { "type": "string" } }, "siteIds": { "title": "Catalog partitions", "type": "array", "description": "Optional numeric AXS catalog partition IDs for event listings, up to 8. The default is the selected market's main catalog partition; search, discovery, catalog and entity modes ignore this field.", "items": { "type": "string" } }, "includeSeats": { "title": "Include seat labels on ticket-offer rows", "type": "boolean", "description": "Keep observed seat labels on ticket-offer rows when includeOffers is enabled. Attribute lists are limited to 50 entries, with a count when shortened.", "default": true }, "includeOffers": { "title": "One Dataset row per ticket offer", "type": "boolean", "description": "Return separate ticket-offer rows in inventory or onsale mode, with parent event fields copied onto each row. All row types share the input limit; disabled by default.", "default": false }, "nearShowHours": { "title": "Watch: near-show window (hours)", "minimum": 1, "maximum": 168, "type": "integer", "description": "For watch mode, the suggested check interval drops from 180 to 60 seconds inside this many hours before the show.", "default": 24 }, "inventoryOnChange": { "title": "Watch: capture inventory when tickets come back", "type": "boolean", "description": "In watch mode, also capture inventory when tickets return to sale, for at most two events per run. Requires an inventoryKey and is disabled by default.", "default": false }, "watchState": { "title": "Watch state", "type": "object", "description": "Optional baseline map eventId -> previous watch snapshot (fields availabilityStatus/statusLabel/onsaleUrlLookupId/priceLow/priceHigh/onsaleDateTimeUTC/presaleDateTimeUTC/ticketEntry/checkedAt). Pass the prior run's row fields back so transition detection works across separate scheduled runs.", "default": {} }, "inventoryKey": { "title": "Inventory invitation key", "type": "string", "description": "Developer-issued invitation key required for inventory mode and watch inventoryOnChange. Without valid access, inventory is not collected and warnings include inventory_locked; onsale and status-only watch need no key." }, "includeRaw": { "title": "Include public source fields", "type": "boolean", "description": "Include additional public source fields after removing credential-like keys. Disabled by default.", "default": false }, "availabilityStatus": { "title": "Availability status", "type": "array", "description": "Only emit event rows whose availabilityStatus is one of the selected values (listing modes only).", "items": { "type": "string", "enum": [ "on_sale", "presale", "sold_out", "resale_only", "coming_soon", "unavailable", "cancelled", "postponed", "unknown" ], "enumTitles": [ "On sale", "Presale", "Sold out", "Resale only", "Coming soon", "Unavailable", "Cancelled", "Postponed", "Unknown" ] }, "default": [] }, "officialOnly": { "title": "Official inventory only", "type": "boolean", "description": "Skip resale-marketplace targets in inventory mode; emit primary/official rows only.", "default": false }, "fields": { "title": "Output fields", "type": "array", "description": "Optional list of output fields to retain. Identity and contact fields are kept even when not listed.", "items": { "type": "string" } }, "page": { "title": "Starting page", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Starting page for listing or entity results. Use the previous run's nextPage value to continue with the same filters.", "default": 1 }, "pageOffset": { "title": "Starting row within page", "minimum": 0, "maximum": 49, "type": "integer", "description": "Rows to skip within the starting page, from 0 to 49. Use the previous run's nextPageOffset value.", "default": 0 }, "cursor": { "title": "Continuation cursor", "type": "string", "description": "Catalog continuation string from RUN_SUMMARY.diagnostics.nextCursor. Keep the same entityTypes when continuing." }, "startDate": { "title": "Event start date inclusive", "type": "string", "description": "Inclusive lower bound for event time, as an ISO date or datetime in UTC. Applies within the scanned results and does not move forward automatically." }, "endDate": { "title": "Event end date inclusive", "type": "string", "description": "Inclusive upper bound for event time, as an ISO date or datetime in UTC. Applies within the scanned results and does not move forward automatically." }, "workerBaseUrl": { "title": "Developer test endpoint", "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 } } } } } } } } } }