Skip to main content
POST /v1/data/espn/scores/run Pricing: $0.0035 per score ($3.50 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
Leagues to get scores for, e.g. nba, nfl or epl (Premier League). One request reads them all. Defaults to NFL, NBA, MLB, NHL and Premier League.41 allowed values, for example nfl (NFL), college-football (College Football (NCAAF)), ufl (UFL), nba (NBA), wnba (WNBA), mens-college-basketball (Men’s College Basketball (NCAAM)), womens-college-basketball (Women’s College Basketball (NCAAW)), mlb (MLB), college-baseball (College Baseball), nhl (NHL). Fetch the full list with GET /v1/data/espn/scores?expand=options.
date
default:"today"
Day to get scores for, e.g. 2026-10-31 (20261031 also works). Defaults to today.
integer
default:"100"
How many scores to return in total. Defaults to 100; use 0 for all.

Example

Response fields

Each row in data is one score, keyed by these fields.

Example response

Abridged: long text and lists are shortened.