# Events search: `POST /v1/events/search`

Cost: 2 credits (2, or 1 for sports and Live Nation (an empty page and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/events-search

One page of events from a single provider, in a shared schema.

Pass `source` (eventbrite, luma, residentadvisor, tradeshows,
songkick, runsignup, sports, eventim, bandsintown, livenation, dice,
allevents, university or 10times) plus a plain `city` where the source
is city-based. Common dates, category, limit and page are translated into
that provider's native input; `source_params` carries fields the
source requires (league, area_id, metro_area, institution_id, site,
state, industry, event_type, month). The per-provider routes stay
available unchanged. There is no multi-source fan-out.

Request body (JSON):

- `source` (string; required; one of eventbrite, luma, residentadvisor, tradeshows, songkick, runsignup, sports, eventim, bandsintown, livenation, dice, allevents, university, 10times): Event provider to query
- `city` (string | null; optional; max length 80): Plain city name (e.g. Toronto). Translated per source; a native slug is also accepted
- `country` (string | null; optional; max length 40): Country name or code when the source needs one (tradeshows, Eventim, 10times)
- `start_date` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Events on or after this date, YYYY-MM-DD
- `end_date` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Events on or before this date, YYYY-MM-DD
- `category` (string | null; optional; max length 80): Category, genre or query text
- `query` (string | null; optional; max length 80): Optional free-text query
- `limit` (integer | null; optional; min 1, max 100): Maximum events to return
- `page` (integer; optional; default 1; min 1): Page number where the source paginates
- `source_params` (object | null; optional): Provider-specific fields (area_id, metro_area, league, institution_id, site, state, zipcode, ...)

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)
