# Ticketmaster Venue Search API Documentation

<p><strong>Ticketmaster Venue Search API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/ticketmaster-api/ticketmaster_venues_search](https://scrappa.co/docs/ticketmaster-api/ticketmaster_venues_search)
- **API group:** Ticketmaster API
- **Endpoint:** `GET https://scrappa.co/api/ticketmaster/venues/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `domain` | string | No | One of com, co.uk, ie, com.au. Defaults to com. Not de: the site shares one venue id between many venues. |
| `q` | string | Yes | Venue name, 2 to 100 characters, e.g. united center. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 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. |
| 404 | Not Found | Ticketmaster has no such record, or it has ended. This response is not billable. |
| 503 | Upstream Unavailable | Ticketmaster did not answer after several attempts. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)