# RunSignup races: `POST /v1/events/races/search`

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

Upcoming runs, marathons and triathlons from RunSignup.

By US state (optionally city) or ZIP code and radius; races from
start_date (default today). Each race has name, next date, city, state,
event types and RunSignup URL.

Request body (JSON):

- `state` (string | null; optional): US state code (e.g., 'NY', 'CA')
- `city` (string | null; optional): City name (with state)
- `zipcode` (string | null; optional; pattern ^\d{5}$): US ZIP code for a radius search
- `radius` (integer | null; optional; min 1, max 500): Miles around zipcode
- `start_date` (string | null; optional): Races on or after (YYYY-MM-DD); default today
- `end_date` (string | null; optional): Races on or before (YYYY-MM-DD)
- `event_type` (string | null; optional): RunSignup event type, e.g. running_race, triathlon
- `page` (integer; optional; default 1; min 1): Page number
- `per_page` (integer; optional; default 20; min 1, max 100): Results per 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)
