# StubHub events: `POST /v1/stubhub/search`

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

One page (20) of StubHub events.

Each event carries local date/time, venue, URL and whether it has active
listings. The search payload does not carry prices; see the event page.
Can take several seconds.

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 stubhub.com search URL; overrides q.
- `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)