ESPN Sports Data API: Scores, Odds, Standings, Rosters
Pricing
from $1.36 / 1,000 row returneds
ESPN Sports Data API: Scores, Odds, Standings, Rosters
ESPN scores API and sports data scraper: live and final scores, schedules with betting odds, standings, rosters, injuries and news for NFL, NBA, MLB, NHL, NCAA and soccer. Flat rows, one per game or player, no API key.
Pricing
from $1.36 / 1,000 row returneds
Rating
0.0
(0)
Developer
Detroit Web Agent - Open Data
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
3 days ago
Last modified
Categories
Features
Share
ESPN Sports Data API: Scores, Odds, Standings, Rosters, Injuries & News
ESPN API scraper that turns the public ESPN JSON feeds into flat, typed rows. Pull live and final scores, upcoming schedules with spread and over/under, standings, team rosters, injury reports and news for the NFL, NBA, WNBA, MLB, NHL, NCAA football and basketball, MLS and the big European soccer leagues, in one run, with one output format, and no API key.
Every row is one game, one team, one player, one injury, one standing or one article. Rows carry the league code, so you can mix leagues in a single run and filter later in a sheet, a database or an n8n workflow.
Run in 30 seconds
- Open the Input tab. The prefilled input reads the last 7 days of scores for the NFL, NBA and NHL and stops at 25 rows.
- Click Start. The default run finishes in a few seconds.
- Open the Output tab and look at the Games and scores table, or export JSON, CSV or Excel.
- Switch What to get to schedule, standings, rosters, injuries or news, change the leagues, and run again.
What does this Actor do?
It reads the same public data feeds that power the ESPN website and app, and flattens them. You choose a data type, a list of leagues and, for games, a date window. The Actor fetches one request per league and day for games, and one request per league for standings, teams, injuries and news. Rosters take one extra request per team.
| Mode | One row is | Main fields |
|---|---|---|
scores | a game, final or live | teams, scores, records, status, period, clock, winner, venue, broadcast, leaders, line scores |
schedule | an upcoming game | kickoff time, teams, records, venue, broadcast, spread, over/under, moneylines |
standings | a team in a table | group, placement, wins, losses, ties, win percentage, points for and against, streak, soccer points |
teams | a team | id, name, abbreviation, colors, logo, links |
rosters | a player | name, jersey, position, age, birth date, height, weight, experience, college, status |
injuries | a reported injury | player, team, status, injury type and detail, return date, short and long comment |
news | an article | headline, description, published time, byline, link, image, categories |
Leagues covered
NFL (nfl), college football (ncaaf), CFL (cfl), NBA (nba), WNBA (wnba), men's and women's college basketball (ncaam, ncaaw), MLB (mlb), college baseball (ncaabaseball), NHL (nhl), college hockey (ncaahockey), MLS (mls), NWSL (nwsl), English Premier League (epl), Championship (championship), La Liga (laliga), Bundesliga (bundesliga), Serie A (seriea), Ligue 1 (ligue1), Eredivisie (eredivisie), Liga MX (ligamx), Champions League (ucl) and Europa League (uel). Write all to read every league at once. Common names such as "premier league" or "college football" are understood too.
Game fields
Games share one shape, so scores and schedules load into the same table.
| Group | Fields |
|---|---|
| Identity | eventId, league, sport, season, seasonType, week, name, shortName, date |
| State | status (pre, in, post), statusName, statusDetail, completed, period, clock |
| Home team | homeTeam, homeTeamId, homeAbbr, homeScore, homeRecord, homeRank, homeWinner, homeLogo, homeLinescores |
| Away team | awayTeam, awayTeamId, awayAbbr, awayScore, awayRecord, awayRank, awayWinner, awayLogo, awayLinescores |
| Result | winner |
| Place | venue, venueCity, venueState, venueCountry, indoor, neutralSite, attendance, broadcast |
| Odds | oddsProvider, oddsDetails, spread, overUnder, homeMoneyline, awayMoneyline, homeFavorite |
| Context | headline, note, leaders (top performer per category), eventUrl, boxscoreUrl |
| Run | recordType, scrapedAt |
Odds appear on upcoming games once a sportsbook has posted a line. Finished games usually have no odds, so those fields are null on final scores.
Input
| Field | What it does |
|---|---|
mode | scores, schedule, standings, teams, rosters, injuries or news. |
leagues | League codes, one per line. Default nfl, nba, nhl. |
dateFrom, dateTo | Date window for scores and schedule, for example 2026-11-09 and 2026-11-15. Up to 120 days per run. |
daysBack | Scores without dates cover this many days up to today. Default 7. |
daysAhead | Schedule without dates covers today plus this many days. Default 7. |
gameStatus | Keep only scheduled, live or final games. |
teams | Team names or abbreviations to keep, for example Lions, DET, Manchester City. |
season | Standings for a past season, for example 2025. |
newsPerLeague | Headlines per league in news mode. Default 25. |
includeOdds | Spread, over/under and moneylines. On by default. |
includeLeaders | Top performers per game. On by default. |
maxItems | Hard cap on rows for the whole run. |
If a window has no games, for example in an off-season, and you gave no explicit dates, the Actor widens the search backwards (scores) or forwards (schedule) in steps of 30 and 90 days until it finds games. Your scheduled runs do not come back empty by accident, and the run says so in its status message.
Example inputs
Last week of NBA scores for one team:
{"mode": "scores","leagues": ["nba"],"dateFrom": "2026-11-09","dateTo": "2026-11-15","teams": ["Pistons"],"gameStatus": "final"}
Next two weeks of Premier League and MLS fixtures:
{"mode": "schedule","leagues": ["epl", "mls"],"daysAhead": 14}
Every NBA roster:
{"mode": "rosters","leagues": ["nba"],"maxItems": 1000}
Output sample
{"recordType": "score","eventId": "401873053","league": "nfl","sport": "football","season": 2026,"week": 10,"date": "2026-11-15T14:30Z","name": "New England Patriots at Detroit Lions","status": "post","statusDetail": "Final","completed": true,"homeTeam": "Detroit Lions","homeAbbr": "DET","homeScore": 35,"homeRecord": "7-2","homeWinner": true,"awayTeam": "New England Patriots","awayAbbr": "NE","awayScore": 10,"awayRecord": "5-5","winner": "Detroit Lions","homeLinescores": [7, 14, 7, 7],"awayLinescores": [3, 0, 0, 7],"venue": "FC Bayern Munich Stadium","venueCity": "Munich","broadcast": "Fox","spread": null,"overUnder": null,"leaders": [{ "team": "DET", "category": "Passing Leader", "stat": "20/31, 303 YDS, 3 TD, 2 INT", "athlete": "Jared Goff", "position": "QB" }],"eventUrl": "https://www.espn.com/nfl/game/_/gameId/401873053/patriots-lions","scrapedAt": "2026-11-16T09:00:00.000Z"}
The values above are an illustration. Your own run returns the live data.
Use cases
- Sports apps and dashboards: feed a scoreboard, a fixtures page or a Discord and Slack bot with fresh scores and schedules on a schedule.
- Betting research and models: collect spreads, over/under lines and moneylines for upcoming games, then join them with final scores to test models.
- Fantasy and injury tracking: pull every NFL, NBA, MLB and NHL injury report each morning and alert on status changes.
- Content and newsletters: build a weekly recap from final scores, standings and team news without copying anything by hand.
- Analytics and data science: load seasons of results and standings into a warehouse for historical analysis, with one consistent column set across sports.
- AI agents: give an agent through the Apify MCP server a single tool that answers "who plays tonight" or "who is injured on the Lions".
Pricing and cost control
Pay per row: $0.0022 per row on the free plan, $0.00136 on the Gold plan (Bronze $0.00205, Silver $0.00175), plus a $0.00005 start fee per run. That is $2.20 per 1,000 rows on the free plan. One row is one game, standing, team, player, injury or article. Nothing is charged for rows that are not returned, and a run with no results costs only the start fee.
Use Max rows in the input and Maximum cost per run in the run options to cap spend. The prefilled run returns 25 rows, which is under a cent.
| Plan | Price per row | Price per 1,000 rows |
|---|---|---|
| Free | $0.0022 | $2.20 |
| Bronze | $0.00205 | $2.05 |
| Silver | $0.00175 | $1.75 |
| Gold | $0.00136 | $1.36 |
Integrations and scheduling
Run it on a schedule, for example every morning for yesterday's finals and today's lines, then send the rows to Google Sheets, Slack, email, Make, Zapier or n8n with the Apify integrations. Use a webhook to start your own pipeline when a run finishes, or call the Actor through the REST API.
Use with the API, n8n, Make, Zapier or AI agents
API (one call, returns the rows as JSON):
$curl -X POST "https://api.apify.com/v2/acts/transparent_meteorite~espn-sports-data-api/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" -H "Content-Type: application/json" -d '{"mode":"scores","leagues":["nba","nhl"],"daysBack":3}'
Python
from apify_client import ApifyClientclient = ApifyClient("YOUR_APIFY_TOKEN")run = client.actor("transparent_meteorite/espn-sports-data-api").call(run_input={"mode": "schedule", "leagues": ["nfl"], "daysAhead": 7})for row in client.dataset(run["defaultDatasetId"]).iterate_items():print(row["name"], row["spread"], row["overUnder"])
- n8n, Make, Zapier: use the Apify app's "Run Actor" step with actor
transparent_meteorite/espn-sports-data-api, paste the input JSON, then map the dataset items to your sheet or database. - AI agents (MCP): connect the Apify MCP server at
https://mcp.apify.com?tools=transparent_meteorite/espn-sports-data-apito Claude, Cursor or any MCP client, and your agent can run this Actor as a tool.
Limits
- The Actor reads public ESPN feeds. It does not read paywalled ESPN+ content, play-by-play, or full box scores.
boxscoreUrlandeventUrlpoint at the ESPN pages for those. - Odds are whatever ESPN shows for a game. Not every game has a line, and lines are usually removed after a game ends.
- Injury feeds exist for the NFL, NBA, MLB, NHL and some college leagues. Soccer leagues have no injury feed on ESPN, and the run reports that in
OUTPUTinstead of failing. - Dates are grouped by US Eastern calendar day, the way ESPN groups them. A late West Coast game belongs to the day it started in the Eastern time zone.
- Rosters in the off-season show the current offseason roster. Injury lists are as fresh as ESPN's own.
- If a run reaches its time limit it stops cleanly and lists unread leagues in
notChecked.
Fair use and legal
The Actor reads only information that ESPN already shows publicly on the web. It does not log in or bypass any access control. Respect ESPN's terms and any rights on logos, photographs and written articles; headlines and links are returned so you can send readers back to the source. This is an independent tool, not affiliated with ESPN or any league.
FAQ
Do I need an ESPN account or API key? No.
Can I get live scores? Yes. Games in progress have status set to in, with period and clock. Run the Actor on a short schedule for a near-live feed.
How do I get one team's games? Put the team name or abbreviation in Only these teams, set a date window, and run scores or schedule.
Why are spread and overUnder empty? Final games have no line. Use schedule mode for upcoming games.
Can I mix sports in one run? Yes. Use all or list several leagues. The column set is the same, and league and sport tell the rows apart.
Why did I get fewer rows than my limit? The window had fewer games, or your filters narrowed it. Widen the dates or remove the team filter.
How far back can scores go? As far as ESPN keeps scoreboards, which is many seasons. Each run covers up to 120 days, so split long histories into several runs.
Support
Found a league or field that reads badly? Open an issue on the Issues tab with the run URL and the league code.
Related actors
Related actors
More tools from the same publisher that fit this workflow:
- Company News Monitor: brand and keyword news alerts for teams, leagues and sponsors.
- Google Trends Scraper: search interest by city, to see where a team or event is trending.
- YouTube Channel Scraper: subscribers and videos for team and league channels.
Use from AI agents: every actor here is callable through the Apify MCP server (mcp.apify.com).
Changelog
- 0.1: First private build. Scores, schedule with odds, standings, teams, rosters, injuries and news for 23 leagues.