# Bandsintown search: `POST /v1/events/bandsintown/search`

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

Upcoming concerts on a Bandsintown city page with public RSVP totals.

Only the aggregate RSVP count per concert; never who RSVP'd.
2 credits; no results is free.

Request body (JSON):

- `city` (string; required; pattern ^[A-Za-z0-9][A-Za-z0-9 -]{0,80}$): City slug as in the site's URL (e.g. 'nashville-tn', 'new-york-ny')
- `date` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): Optional date YYYY-MM-DD

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)
