{
  "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": "4i8uTfZCkHh8x0mkF"
  },
  "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 date (YYYY-MM-DD)."
          },
          "endDate": {
            "title": "End date (search filter)",
            "type": "string",
            "description": "mode=search: only events on/before this date (YYYY-MM-DD)."
          },
          "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)",
            "type": "number",
            "description": "mode=search: geo radius (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": "mode=event: full = metadata+pricing merged with the browser-rendered event page (seatManifest/smartQueue, slower); fast = JSON only, no browser (~2s per event).",
            "default": "full"
          },
          "includePricing": {
            "title": "Include pricing (event mode)",
            "type": "boolean",
            "description": "mode=event: attach seat-level pricing (primary/resale picks + offer fee breakdown) and derive lowestPrice/highestPrice.",
            "default": true
          },
          "includeSeatManifest": {
            "title": "Include seat manifest (event mode)",
            "type": "boolean",
            "description": "mode=event detailLevel=full: parse seat geometry counts (sections/rows/seats) from the event page.",
            "default": true
          },
          "includeReviews": {
            "title": "Include reviews (artist mode)",
            "type": "boolean",
            "description": "mode=artist: also emit review rows (recordType=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 top-suggestion event rows (recordType=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 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 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 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 when artistId is given."
          },
          "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 alongside 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",
            "type": "string",
            "description": "TMOL event id for mode=event, e.g. 0D0064EA9A88501D (from /event/{id} URLs or search results)."
          },
          "eventUrl": {
            "title": "Event URL",
            "type": "string",
            "description": "Full Ticketmaster event URL for mode=event (eventId derived if missing)."
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum events to emit (1-500). Free-tier capped at 200. Store Test / Console default is 1.",
            "default": 1
          },
          "maxPages": {
            "title": "Max pages",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "List pagination depth (?page=N, ~20 events per page).",
            "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 (batch event detail).",
            "items": {
              "type": "string"
            }
          },
          "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}