{
  "openapi": "3.0.1",
  "info": {
    "title": "Ticketmaster Event Scraper",
    "description": "Search concerts, sports, theater, and live events from Ticketmaster by keyword, location, date, or genre. Returns ticket prices, venue details, presale dates, seat maps, and direct purchase links as clean JSON. Works as an MCP tool for AI agents.",
    "version": "0.0",
    "x-build-id": "RqJS7b8iwNf9hKDJY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/labrat011~event-ticket-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-labrat011-event-ticket-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/labrat011~event-ticket-scraper/runs": {
      "post": {
        "operationId": "runs-sync-labrat011-event-ticket-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/labrat011~event-ticket-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-labrat011-event-ticket-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": {
          "apiKey": {
            "title": "Ticketmaster API Key",
            "type": "string",
            "description": "Your Ticketmaster Discovery API key. Register for free at developer.ticketmaster.com to get one."
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "get_event",
              "venues"
            ],
            "type": "string",
            "description": "Operation mode: 'search' for keyword/filter search, 'get_event' for lookup by event ID, 'venues' for venue search.",
            "default": "search"
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Search term -- artist name, event name, team, or genre (e.g. 'Taylor Swift', 'NBA', 'comedy')."
          },
          "eventId": {
            "title": "Event ID",
            "type": "string",
            "description": "Ticketmaster event ID for 'get_event' mode (e.g. 'vvG1iZ4JFSmpkV')."
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Filter by city name (e.g. 'New York', 'Los Angeles')."
          },
          "stateCode": {
            "title": "State/Province Code",
            "type": "string",
            "description": "Filter by state or province code (e.g. 'NY', 'CA', 'ON')."
          },
          "countryCode": {
            "title": "Country Code",
            "type": "string",
            "description": "Filter by ISO Alpha-2 country code (e.g. 'US', 'CA', 'GB')."
          },
          "postalCode": {
            "title": "Postal Code",
            "type": "string",
            "description": "Filter by postal/zip code (e.g. '10001')."
          },
          "latlong": {
            "title": "Latitude,Longitude",
            "type": "string",
            "description": "Geographic center point as 'lat,long' (e.g. '40.7128,-74.0060'). Use with radius."
          },
          "radius": {
            "title": "Radius",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Search radius from latlong or postal code center point, in miles (default) or km."
          },
          "unit": {
            "title": "Radius Unit",
            "enum": [
              "miles",
              "km"
            ],
            "type": "string",
            "description": "Unit for the radius parameter.",
            "default": "miles"
          },
          "classificationName": {
            "title": "Classification",
            "type": "string",
            "description": "Filter by event type/genre. Examples: 'Music', 'Sports', 'Arts & Theatre', 'Film', 'Comedy', 'Rock', 'Pop', 'Hip-Hop/Rap', 'NBA', 'NFL', 'MLB'."
          },
          "startDateTime": {
            "title": "Start Date",
            "type": "string",
            "description": "Filter events starting on or after this date/time. ISO 8601 format with timezone: 'YYYY-MM-DDTHH:mm:ssZ' (e.g. '2025-06-01T00:00:00Z')."
          },
          "endDateTime": {
            "title": "End Date",
            "type": "string",
            "description": "Filter events starting on or before this date/time. ISO 8601 format with timezone: 'YYYY-MM-DDTHH:mm:ssZ' (e.g. '2025-12-31T23:59:59Z')."
          },
          "sort": {
            "title": "Sort By",
            "enum": [
              "relevance,desc",
              "date,asc",
              "date,desc",
              "name,asc",
              "name,desc",
              "distance,asc"
            ],
            "type": "string",
            "description": "Sort results by the given field and order.",
            "default": "relevance,desc"
          },
          "source": {
            "title": "Source",
            "enum": [
              "",
              "ticketmaster",
              "universe",
              "frontgate",
              "tmr"
            ],
            "type": "string",
            "description": "Filter by ticket source platform.",
            "default": ""
          },
          "includeFamily": {
            "title": "Family-friendly only",
            "enum": [
              "",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Filter for family-friendly events.",
            "default": ""
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum number of events to return (1-1000). Free users are limited to 25 per run. Note: Ticketmaster API limits deep paging to ~1000 results per search.",
            "default": 100
          },
          "requestIntervalSecs": {
            "title": "Request Interval (seconds)",
            "minimum": 0.2,
            "maximum": 5,
            "type": "number",
            "description": "Minimum seconds between API requests. Ticketmaster allows 5 requests/second. Default is conservative to avoid hitting rate limits.",
            "default": 0.5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}