Skip to content
Scrappa Get API key
Ticketmaster API 1 credit / request

Ticketmaster Venue Search API Documentation

GET https://scrappa.co/api/ticketmaster/venues/search

Ticketmaster Venue Search API Documentation Find Ticketmaster venues by name. Not available on ticketmaster.de (answers 422: the site shares one venue id between many venues). Only venues of the country of the chosen site are listed. Each row has the venue id for the Venue endpoint, name, page URL, city, state, country, number of upcoming events and image. The site returns up to about ten rows and no further pages. Costs 1 credit per request. A response without data and every error cost nothing.

Ticketmaster Venue Search API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/ticketmaster/venues/search
Auth header
x-api-key
Cost
1 credit / request
q = coffee shops
Response preview
200 OK
{
    "data": {
        "total": 3,
        "results": [
            {
                "id": "32882",
                "url": "https://www.ticketmaster.com/united-center-tickets-chicago/venue/32882",
                "city": "Chicago",
                "name": "United Center",
                "type": "venue",
                "image": "https://s1.ticketm.net/dbimages/22961v.jpg",
                "state": "IL",
                "country": "United States",
                "category": null,
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

1 optional filter available.

q string Required

Venue name, 2 to 100 characters, e.g. united center.

Example value coffee shops
domain string Optional

One of com, co.uk, ie, com.au. Defaults to com. Not de: the site shares one venue id between many venues.

Example value example.com

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "data": {
        "total": 3,
        "results": [
            {
                "id": "32882",
                "url": "https://www.ticketmaster.com/united-center-tickets-chicago/venue/32882",
                "city": "Chicago",
                "name": "United Center",
                "type": "venue",
                "image": "https://s1.ticketm.net/dbimages/22961v.jpg",
                "state": "IL",
                "country": "United States",
                "category": null,
                "upcoming_events": 114
            },
            {
                "id": "180631",
                "url": "https://www.ticketmaster.com/heritage-bank-center-tickets-cincinnati/venue/180631",
                "city": "Cincinnati",
                "name": "Heritage Bank Center",
                "type": "venue",
                "image": "https://s1.ticketm.net/dbimages/23100v.jpg",
                "state": "OH",
                "country": "United States",
                "category": null,
                "upcoming_events": 68
            },
            {
                "id": "368913",
                "url": "https://www.ticketmaster.com/harrahs-cherokee-center-asheville-tickets-asheville/venue/368913",
                "city": "Asheville",
                "name": "Harrah's Cherokee Center - Asheville",
                "type": "venue",
                "image": "https://s1.ticketm.net/dbimages/21881v.jpg",
                "state": "NC",
                "country": "United States",
                "category": null,
                "upcoming_events": 41
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "venues_search"
    },
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A query parameter is missing, invalid, not supported by this endpoint or cannot be combined with another one. This response is not billable.

{
    "errors": {
        "q": [
            "Send q, city, or lat and lng."
        ]
    },
    "message": "The request validation failed"
}
404

Not Found

Ticketmaster has no such record, or it has ended. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": false,
        "endpoint_family": "venues_search"
    },
    "error": {
        "code": "NOT_FOUND",
        "message": "The requested Ticketmaster resource was not found."
    },
    "success": false
}
503

Upstream Unavailable

Ticketmaster did not answer after several attempts. This response is not billable.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "venues_search"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Ticketmaster API is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.