# Ticketmaster Artist Search API Documentation

<p><strong>Ticketmaster Artist Search API Documentation</strong> Find Ticketmaster artists, teams and shows by name. Each row has the artist id for the Artist endpoint, name, page URL, 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_artists_search](https://scrappa.co/docs/ticketmaster-api/ticketmaster_artists_search)
- **API group:** Ticketmaster API
- **Endpoint:** `GET https://scrappa.co/api/ticketmaster/artists/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, de, ie, com.au. Defaults to com. An event url sets it by itself. |
| `q` | string | Yes | Artist, team or show name, 2 to 100 characters, e.g. taylor swift. |

## Example response

```json
{
    "data": {
        "total": 3,
        "results": [
            {
                "id": "3159778",
                "url": "https://www.ticketmaster.com/taylorville-a-tribute-to-taylor-swift-tickets/artist/3159778",
                "city": null,
                "name": "Taylorville - A Tribute to Taylor Swift",
                "type": "artist",
                "image": "https://s1.ticketm.net/dam/a/609/66027099-543d-4008-9dcb-08e21cfa0609_RECOMENDATION_16_9.jpg",
                "state": null,
                "country": null,
                "category": null,
                "upcoming_events": 4
            },
            {
                "id": "3443084",
                "url": "https://www.ticketmaster.com/taylor-a-tribute-to-the-eras-tickets/artist/3443084",
                "city": null,
                "name": "TAYLOR: A Tribute to the Eras of Taylor Swift",
                "type": "artist",
                "image": "https://s1.ticketm.net/dam/c/ab4/6367448e-7474-4650-bd2d-02a8f7166ab4_106161_RECOMENDATION_16_9.jpg",
                "state": null,
                "country": null,
                "category": null,
                "upcoming_events": 1
            },
            {
                "id": "3030771",
                "url": "https://www.ticketmaster.com/lets-sing-taylor-a-live-band-tickets/artist/3030771",
                "city": null,
                "name": "Let\u2019s Sing Taylor - A Live Band Experience Celebrating Taylor Swift",
                "type": "artist",
                "image": "https://s1.ticketm.net/dam/a/560/121b08a3-5cc6-447b-9715-ce9d99f76560_RECOMENDATION_16_9.jpg",
                "state": null,
                "country": null,
                "category": null,
                "upcoming_events": 1
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "artists_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)
