# Event search (all platforms)

Best for: One route and one schema for all 13 event platforms below. Category: Events and tickets.

One call to POST /v1/events/search with `source` and a plain city (plus dates, category and `source_params` when the provider needs them) returns concerts, sports, tradeshows, races and university events from Eventbrite, Luma, Resident Advisor, EventsEye, Songkick, RunSignup, sports schedules, Eventim, Bandsintown, Live Nation, DICE, AllEvents or university calendars, in a shared schema. The 14 per-provider routes stay available, including Eventbrite event detail.

- Look up by: source (the provider) plus a plain city; dates, category, and source_params for league, metro, institution or site
- Coverage: Worldwide events; coverage varies by provider
- Cost: 2 credits a call; failed and empty calls are free
- Answers: Search, Details

## Endpoints

- `POST /v1/events/search`: Events search, 2 credits. https://scrapercompany.com/docs/reference/events-search

## Example

Events search (`POST /v1/events/search`):

```bash
curl -X POST "https://api.scrapercompany.com/v1/events/search" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "city": "Toronto",
    "limit": 20,
    "source": "eventbrite",
    "start_date": "2027-01-15"
  }'
```

## Good to know

- There is no multi-source fan-out: one call queries one provider.
- Sports schedules and Live Nation cost 1 credit; the other sources cost 2. An empty page is free.
- The per-provider routes are unchanged, including sports/schedule, university/calendar and Eventbrite event detail.

- [All data sources](https://scrapercompany.com/docs/data-sources)
