# SeatGeek events: `POST /v1/seatgeek/search`

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

One page of SeatGeek events.

Each event carries local/UTC dates, venue and performers, plus the live
secondary-market price stats: lowest, median, average, highest, listing
and ticket counts.

Request body (JSON):

- `q` (string; required; min length 1): Artist, team, event or venue keyword.
- `city` (string | null; optional): Venue city filter.
- `state` (string | null; optional): Venue state filter.
- `country` (string | null; optional): Venue country code, e.g. US.
- `page` (integer; optional; default 1; min 1, max 100): One-based result page.
- `per_page` (integer; optional; default 20; min 1, max 100): Maximum events to return.
- `sort` (string; optional; default relevance): relevance, date_asc or date_desc.

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)
