# Sports schedule: `POST /v1/events/sports/schedule`

Cost: 1 credit (1 per league-day (an empty schedule and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/sports-schedule

One league-day of games from ESPN's public scoreboard (facts only).

Teams, start time (UTC), venue name/city/country, indoor flag, status and
attendance on completed games. MLB adds stadium capacity and coordinates
from MLB statsapi. 1 credit; a day with no games is free.

Request body (JSON):

- `league` (string; required): League code: nfl, nba, mlb, nhl, epl, mls, laliga, bundesliga, seriea, ligue1
- `team` (string | null; optional; max length 60): Optional team name filter (substring, e.g. 'Lions')
- `venue` (string | null; optional; max length 80): Optional venue name filter (substring)
- `date_start` (string | null; optional; pattern ^\d{4}-\d{2}-\d{2}$): The day, YYYY-MM-DD (default: today)

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)
