espn.com APIespn.com ↗
Access ESPN scores, standings, rosters, player stats, game logs, and news across 21+ leagues including NFL, NBA, MLB, NHL, and more via a single API.
curl -X POST 'https://api.parse.bot/scraper/1ed7c95b-0348-41fb-baa1-f5f0096b7da5/get_scoreboard' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"dates": "20260424",
"league": "nba"
}'Get live scores, final results, and upcoming fixtures for any supported league. Returns match details including scores, venues, broadcasts, leaders, odds, and recaps.
| Param | Type | Description |
|---|---|---|
| dates | string | Date filter in YYYYMMDD format (e.g., 20260424). When omitted, returns current day's events. |
| limit | integer | Maximum number of events to return. |
| leaguerequired | string | League identifier. Accepted values: nba, nfl, mlb, nhl, wnba, college-football, mens-college-basketball, womens-college-basketball, college-baseball, college-softball, eng.1, esp.1, ger.1, ita.1, fra.1, usa.1, uefa.champions, ufc, f1, nascar, nll |
{
"type": "object",
"fields": {
"date": "string or null, date of events",
"events": "array of event objects with id, name, date, status, venue, competitors, broadcasts, odds, headline, recap",
"league": "string, league display name",
"season": "object containing year, startDate, endDate, displayName, type",
"event_count": "integer, number of events returned"
},
"sample": {
"data": {
"date": null,
"events": [
{
"id": "401869404",
"date": "2026-04-24T23:00Z",
"name": "Boston Celtics at Philadelphia 76ers",
"venue": {
"city": "Philadelphia",
"name": "Xfinity Mobile Arena",
"state": "PA"
},
"status": {
"clock": "12:00",
"state": "post",
"detail": "Final",
"period": 4,
"description": "Final"
},
"broadcasts": [
{
"names": [
"Prime Video"
],
"market": "national"
}
],
"short_name": "BOS @ PHI",
"competitors": [
{
"score": "100",
"winner": false,
"team_id": "20",
"home_away": "home",
"team_name": "Philadelphia 76ers",
"abbreviation": "PHI"
}
]
}
],
"league": "National Basketball Association",
"season": {
"year": 2026,
"displayName": "2025-26"
},
"event_count": 3
},
"status": "success"
}
}About the espn.com API
The ESPN API covers 9 endpoints that return live scores, standings, team rosters, athlete profiles, game logs, and league news across 21+ sports leagues. The get_scoreboard endpoint returns live and final event data including venue, broadcasts, betting odds, and game recaps, while get_athlete_gamelog delivers per-game stat breakdowns with monthly splits and season totals. League identifiers span NFL, NBA, MLB, NHL, WNBA, college football, college basketball, and European soccer.
Coverage and Endpoints
Nine endpoints cover the full breadth of ESPN's data across major North American and international leagues. get_scoreboard accepts a league identifier and an optional dates parameter in YYYYMMDD format, returning an events array where each entry includes competitors, status, venue, broadcasts, odds, and a headline or recap when available. get_standings adds an optional season year and a season_type filter (2 for regular season, 3 for postseason) to return conference/division groups with per-team stats. get_teams returns every franchise in a league with id, color, logo, and navigation links.
Athlete Data
Three endpoints focus on individual athletes. get_athlete_profile returns biographical fields—age, height, weight, jersey, position, status, and an injuries array—given a league and athlete_id. get_athlete_overview layers on statistics (split by season and career), awards, a fantasy object with draft_rank, percent_owned, and projection, plus a rotowire block with expert analysis text. get_athlete_gamelog returns a season_types array where each category includes per-game rows keyed to labels (e.g., MIN, FG, PTS) alongside running totals and averages.
Roster and News
get_team_roster returns the full squad for a given team_id, including each athlete's date_of_birth, birth_place, college, experience_years, and an injury status field, as well as a coaches array with experience. get_news returns an articles array with headline, description, byline, published, categories, and associated images for a given league. The limit parameter controls article count.
Search and ID Resolution
The search endpoint is the entry point for resolving IDs. Submit a query string—player or team name—and optionally set type to 'player' or 'team' to narrow results. Each result includes id, name, type, sport, league, and link, which feed directly into the athlete and roster endpoints. Mixing type filters with mismatched queries (e.g., a player name with type: 'team') returns empty results.
- Display live NFL or NBA scoreboards with venue and broadcast info in a sports companion app
- Build a fantasy sports dashboard using draft rank, percent owned, and projections from get_athlete_overview
- Track player injury status and roster changes across teams using get_team_roster and get_athlete_profile
- Generate automated game recap summaries by pulling the headline and recap fields from get_scoreboard events
- Populate historical season standings tables using get_standings with season and season_type parameters
- Aggregate athlete career statistics across leagues by combining get_athlete_overview and get_athlete_gamelog
- Drive a news feed widget with league-filtered articles, bylines, and images from get_news
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ESPN have an official developer API?+
What does get_scoreboard return beyond just the score?+
venue, broadcasts (network names), odds (betting lines when available), a headline, and a recap field populated after a game ends. The status field indicates whether the event is pre-game, in-progress, or final. You can filter by date using the dates parameter in YYYYMMDD format.Does the API return historical game logs for past seasons?+
get_athlete_gamelog accepts an optional season parameter (e.g., 2024) so you can request prior seasons rather than only the current one. The response includes per-game rows, monthly breakdowns, and season totals keyed to sport-specific stat labels.Are play-by-play or in-game drive/pitch-level data available?+
Does the fantasy object appear for every league?+
fantasy field within get_athlete_overview may be absent for leagues where ESPN does not surface fantasy data, such as certain international soccer competitions or F1. It is consistently populated for NFL, NBA, MLB, and NHL athletes where ESPN runs active fantasy products.