Loading repository data…

Public-ESPN-API GitHub Details, Stars and Alternatives | OpenRepoFinder

pseudo-r / repository

Public-ESPN-API

The Public ESPN API documentation provides a complete list of undocumented API endpoints, URL parameters, and JSON response formats across 20+ sports (NFL, NBA, MLB, NHL). Includes live curl examples, routing guides, and a Django REST API service for live scores, standings, and news. Optimized for search, developers, AI, and LLMs.

#api#django#espn#espn-api#live-scores#python

View Repository on GitHub ↗

REPOSITORY OVERVIEW

Live repository statistics

★ 634Stars

⑂ 74Forks

◯ 2Open issues

◉ 634Watchers

78/100

OPENREPOHUB HEALTH SIGNAL

Healthy signals

A transparent discovery signal based on current public GitHub metadata.

Recent activity35% weight

100

Community adoption25% weight

Maintenance state20% weight

100

License clarity10% weight

Project information10% weight

100

This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.

README preview

ESPN Public API Documentation

Disclaimer: This is documentation for ESPN's undocumented public API. I am not affiliated with ESPN. Use responsibly and follow ESPN's terms of service.

☕ Support This Project

If this documentation has saved you time, consider supporting ongoing development and maintenance:

Platform	Link
☕ Buy Me a Coffee	buymeacoffee.com/pseudo_r
💖 GitHub Sponsors	github.com/sponsors/Kloverdevs
💳 PayPal Donate	PayPal (CAD)

Every contribution helps keep this project updated as ESPN changes their API.

📱 Real-World Apps Built With This API

These apps are live examples of what you can build using this documentation and the included Django service:

🏀 Sportly: Basketball Live

Real-time NBA, college basketball, and international leagues — scores, standings, player stats, and live game tracking.

⚽ Sportly: Soccer Live

Premier League, La Liga, Bundesliga, Serie A, MLS, and more — live scores, tables, fixtures, and news.

ALGORITHMICALLY RELATED

Similar Open-Source Projects

Selected from shared topics, language and repository description—not editorial ratings.

pseudo-r /

Public-ESPN-Fantasy-API

★ 2

The ESPN Fantasy API documentation provides comprehensive API endpoints, URL parameters, authentication methods, and expected JSON response formats. Includes live Python examples, curl requests, and a Django REST API service for Fantasy Football, Baseball, Basketball, and Hockey data ingestion. Designed for developers, LLMs, and AI agents.

49/100 health

Active repositoryHas homepage

PythonNOASSERTION#api#django#espn#espn-api

⑂ 0 forks◯ 0 issuesUpdated Mar 27, 2026

Project homepage ↗

View details View on GitHub ↗

Domain	Version	Purpose
`site.api.espn.com`	v2/v3	Scores, news, teams, standings (site-facing)
`sports.core.api.espn.com`	v2	Athletes, stats, odds, play-by-play, detailed data
`sports.core.api.espn.com`	v3	Athletes, leaders (richer schema)
`site.web.api.espn.com`	v3	Search, athlete profiles
`cdn.espn.com`	—	CDN-optimized live data
`fantasy.espn.com`	v3	Fantasy sports leagues
`now.core.api.espn.com`	—	Real-time news feeds

# NFL Scoreboard
curl "https://site.api.espn.com/apis/site/v2/sports/football/nfl/scoreboard"

# NBA Teams
curl "https://site.api.espn.com/apis/site/v2/sports/basketball/nba/teams"

# MLB Scores for a Specific Date
curl "https://site.api.espn.com/apis/site/v2/sports/baseball/mlb/scoreboard?dates=20241215"

# NHL Standings — NOTE: use /apis/v2/ (not /apis/site/v2/ which returns a stub)
curl "https://site.api.espn.com/apis/v2/sports/hockey/nhl/standings"

Sport	Slug	# Leagues	Documentation
🏉 Australian Football	`australian-football`	1	docs/sports/australian_football.md
⚾ Baseball	`baseball`	13	docs/sports/baseball.md
🏀 Basketball	`basketball`	15	docs/sports/basketball.md
🏏 Cricket	`cricket`	varies	docs/sports/cricket.md
🏑 Field Hockey	`field-hockey`	1	docs/sports/field_hockey.md
🏈 Football	`football`	5	docs/sports/football.md
⛳ Golf	`golf`	9	docs/sports/golf.md
🏒 Hockey	`hockey`	6	docs/sports/hockey.md
🥍 Lacrosse	`lacrosse`	4	docs/sports/lacrosse.md
🥊 MMA	`mma`	25+	docs/sports/mma.md
🏎️ Racing	`racing`	5	docs/sports/racing.md
🏉 Rugby	`rugby`	24	docs/sports/rugby.md
🏉 Rugby League	`rugby-league`	1	docs/sports/rugby_league.md
⚽ Soccer	`soccer`	24	docs/sports/soccer.md
🎾 Tennis	`tennis`	2	docs/sports/tennis.md
🏐 Volleyball	`volleyball`	2	docs/sports/volleyball.md
🤽 Water Polo	`water-polo`	2	docs/sports/water_polo.md

GET https://site.api.espn.com/apis/site/v2/sports/{sport}/{league}/{resource}

Resource	Description
`scoreboard`	Live & scheduled events with scores
`teams`	All teams in the league
`teams/{id}`	Single team detail
`teams/{id}/roster`	Team roster
`teams/{id}/schedule`	Team schedule
`teams/{id}/depthcharts`	Depth chart by position
`teams/{id}/injuries`	Current injury report
`teams/{id}/transactions`	Recent transactions/moves
`teams/{id}/history`	Franchise historical record
`athletes/{id}`	Individual athlete profile
`athletes/{id}/gamelog`	Game-by-game log
`athletes/{id}/splits`	Statistical splits
`athletes/{id}/news`	Athlete news
`athletes/{id}/bio`	Athlete bio
`standings`	League standings ⚠️ use `/apis/v2/` — `/apis/site/v2/` returns a stub
`injuries`	League-wide injury report
`transactions`	Recent signings/trades/waivers
`groups`	Conferences/divisions
`news`	Latest news articles
`rankings`	Rankings (college sports)
`calendar`	Season calendar (all weeks/dates)
`calendar/offseason`	Offseason date range
`calendar/regular-season`	Regular season weeks
`calendar/postseason`	Postseason date ranges
`summary?event={id}`	Full game summary

GET https://site.api.espn.com/apis/site/v3/sports/{sport}/{league}/{resource}

Resource	Description
`scoreboard`	Scoreboard with enriched v3 schema
`summary?event={id}`	Enriched game summary (v3 schema)

GET https://sports.core.api.espn.com/v2/sports/{sport}/leagues/{league}/{resource}

Resource	Description
`athletes`	Full athlete list with pagination
`athletes/{id}`	Single athlete
`athletes/{id}/statistics`	Career stats
`athletes/{id}/statisticslog`	Game-by-game log
`athletes/{id}/eventlog`	Event history
`athletes/{id}/contracts`	Contract info
`athletes/{id}/awards`	Awards
`athletes/{id}/seasons`	Seasons played
`athletes/{id}/records`	Career records
`athletes/{id}/hotzones`	Hot zones (baseball)
`athletes/{id}/injuries`	Athlete injury history
`athletes/{id}/vsathlete/{opponentId}`	Head-to-head stats
`events`	Events with full detail
`events/{id}/competitions/{id}/odds`	Betting odds
`events/{id}/competitions/{id}/probabilities`	Win probabilities
`events/{id}/competitions/{id}/plays`	Play-by-play
`events/{id}/competitions/{id}/situation`	Current game situation (down/distance/ball)
`events/{id}/competitions/{id}/broadcasts`	Broadcast network info
`events/{id}/competitions/{id}/predictor`	ESPN game predictor
`events/{id}/competitions/{id}/powerindex`	ESPN Power Index for game
`events/{id}/competitions/{id}/competitors/{id}/linescores`	Period-by-period scores
`events/{id}/competitions/{id}/competitors/{id}/statistics`	Competitor stats
`seasons`	Season list
`seasons/{year}/teams`	Teams in a season
`seasons/{year}/coaches`	Coaching staff
`seasons/{year}/draft`	Draft data
`seasons/{year}/futures`	Futures odds
`seasons/{year}/powerindex`	Season-

Public-ESPN-API

Live repository statistics

Healthy signals

README preview

ESPN Public API Documentation

☕ Support This Project

📱 Real-World Apps Built With This API

🏀 Sportly: Basketball Live

⚽ Sportly: Soccer Live

Similar Open-Source Projects

Public-ESPN-Fantasy-API

🏒 Sportly: NHL & Hockey Live

🏈 Sportly: American Football Live

⚾ Sportly: Baseball Live

Table of Contents

Overview

Important Notes

Base URLs

Quick Start

Sports Coverage

API Endpoint Patterns

Site API v2 (Scores, Teams, Standings)

Site API v3 (Richer Game Data)

Core API v2 (Athletes, Stats, Events, Odds)