# Ticketmaster events: `POST /v1/ticketmaster/search`

Cost: 2 credits (2 per page (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/ticketmaster-search

One Ticketmaster search page (20 events).

Each event carries local and UTC dates, venue, artists, category, its
status flags and canonical URL. Ticket prices are not in the search
payload.

Request body (JSON):

- `q` (string | null; optional): Artist, team, event or venue keyword. Needed unless url is given.
- `url` (string (uri) | null; optional; min length 1, max length 2083): A ticketmaster.com search URL; overrides q.
- `page` (integer; optional; default 0; min 0, max 100): Zero-based result page.
- `limit` (integer; optional; default 20; min 1, max 20): Maximum events to return (one page).

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)