Sports Scores and Fixtures
Pricing
from $1.53 / 1,000 game rows
Sports Scores and Fixtures
Scores, live status, and fixtures by date for NBA, NFL, NHL, MLB, MLS, top European soccer, college sports, and UFC, as one flat row per game with teams, score, period scores, winner, start time, and venue. No login. Refused reads are free.
Pricing
from $1.53 / 1,000 game rows
Rating
0.0
(0)
Developer
Mamba Labs
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 hours ago
Last modified
Categories
Features
Share
Give one or more leagues and a date or date range, and get one flat row per game: teams or fighters, home and away, status, score, period scores, winner, start time, venue, and broadcasts. It covers the NBA, NFL, NHL, MLB, WNBA, MLS, the top European soccer leagues and the Champions League, college football and basketball, UFC cards, and any other league ESPN lists. You pay per game row, and refused reads and summary rows are free.
Features
- Results, live scores, and fixtures. A past date returns results, today returns what is live and scheduled, and a date ahead returns the fixtures ESPN lists so far.
- Many sports in one run. Name leagues by path, such as
basketball/nbaorsoccer/ger.1, or by name, such asnfl,premier league,champions league,college football, orufc. - One row layout for every sport.
competitor_1is the home team andcompetitor_2the away team when a game has a home side; a bout lists both fighters in card order with their country and weight class. - Scores you can read.
scoreis competitor 1 then competitor 2.competitor_1_periodsandcompetitor_2_periodshold points per quarter, period, inning, half, or round where ESPN gives them.statusis one of scheduled, live, final, postponed, canceled, suspended, delayed, or other, andclockshows the game clock while live. - Filters. Team or fighter name and status. A filter never charges for the rows it removes.
- Every college game. College football reads every FBS game and college basketball every Division I game, not only ranked teams.
- One charge per game. A game listed on two days is one row.
- Restart aware. If Apify moves the run to another host, it resumes from its saved position and does not charge a game twice.
How the data is read
The actor reads ESPN's public scoreboard JSON, the same call ESPN's scoreboard pages make, one league and one day at a time, on the Apify default proxy pool. It uses no login, no key, no residential proxy, no browser, and no other developer's actor. A refused read is one free row with no retry on another address.
source_url on each row shows the address that was read. The data belongs to ESPN and its sources. ESPN's terms restrict automated access and compiling data sets, and you are responsible for how you use the rows. Tennis is not read here: use the Mamba Labs Tennis Match Data actor for ATP and WTA draws and set scores.
Input
| Field | Type | Default | What it does |
|---|---|---|---|
leagues | array | ESPN league paths such as basketball/nba or soccer/eng.1, or names such as nfl, premier league, champions league, college football, ufc. Empty means NBA, NFL, NHL, MLB, and the Premier League. Tennis is not read here. | |
date_from | string | First schedule day as YYYY-MM-DD, or today, yesterday, or tomorrow. ESPN files games by US Eastern time. | |
date_to | string | Last schedule day. Empty means the same as date from. A run reads at most 62 days and 400 league days. | |
statuses | array | scheduled, live, final, postponed, canceled, suspended, delayed, other, or the shortcuts finished and upcoming. Empty means all. | |
teams | array | Keep games where a team or fighter name or abbreviation holds one of these words, such as celtics or BOS. | |
max_games | string | 500 | Stop after this many game rows. Default 500. |
max_charge_usd | string | Optional. The run stops before a charge that would pass this amount. Summary rows are always returned. |
Output
| Field | Type | What it holds |
|---|---|---|
row_type | string | One of: game, empty_read, source_report, run_summary. run_summary is the one free row written when the input is refused. |
game_id | string | ESPN competition ID. Stable, and unique in a run. |
event_id | string | ESPN event ID when one event holds several competitions, such as a fight card. Empty for a single game. |
sport | string | The sport part of the league path. |
league | string | ESPN league path read, such as basketball/nba. |
league_name | string | League name as ESPN gives it. |
schedule_day | string | The ESPN schedule day read, YYYY-MM-DD. ESPN files games by US Eastern time. |
start_time_utc | string | Scheduled or actual start in UTC. |
start_time_confirmed | string | false when ESPN marks the time as not yet set, as text. |
season | integer | Season year as ESPN numbers it. |
season_type | string | regular-season, post-season, preseason, or the name ESPN gives. |
event_name | string | Event title, such as Orlando Magic at Boston Celtics or a fight card name. |
short_name | string | Short title, such as ORL @ BOS. For a bout, the two fighters. |
competition_type | string | For a bout on a card, the weight class. Empty for a game. |
status | string | scheduled, live, final, postponed, canceled, suspended, delayed, or other. |
status_detail | string | ESPN's own status text, such as Final/OT, Halftime, or a start time. |
period | integer | Current or last period, quarter, half, inning, or round. |
clock | string | Game clock while live. Empty otherwise. |
competitor_1 | string | Home team when the game has one, else the first listed team or fighter. |
competitor_1_id | string | ESPN team or athlete ID. |
competitor_1_abbr | string | Team abbreviation or short athlete name. |
competitor_1_side | string | home, away, or empty when the game has no home side. |
competitor_1_score | string | Score as text. Empty before the start. |
competitor_1_record | string | Season record as ESPN gives it, such as 11-3. |
competitor_1_country | string | Country of an individual athlete. Empty for teams. |
competitor_1_periods | array | Points per period, quarter, half, inning, or round, as text. |
competitor_2 | string | Away team when the game has one, else the second listed team or fighter. |
competitor_2_id | string | ESPN team or athlete ID. |
competitor_2_abbr | string | Team abbreviation or short athlete name. |
competitor_2_side | string | home, away, or empty when the game has no home side. |
competitor_2_score | string | Score as text. Empty before the start. |
competitor_2_record | string | Season record as ESPN gives it. |
competitor_2_country | string | Country of an individual athlete. Empty for teams. |
competitor_2_periods | array | Points per period, as text. |
score | string | Competitor 1 score, then competitor 2 score. Empty before the start. |
winner | string | Winner's name once ESPN marks one. |
venue | string | Venue name. |
city | string | Venue city and state or country. |
neutral_site | string | true when played at a neutral site, as text. |
attendance | integer | Attendance once ESPN reports it. |
broadcasts | string | TV or stream names ESPN lists. |
source_url | string | The ESPN scoreboard call that returned the row. |
reads_total | integer | Summary row: league days planned. |
reads_refused | integer | Summary row: reads the source refused. |
rows_returned | integer | Summary row: game rows returned. |
empty_reads | integer | Summary row: league days that held no fitting game. |
row_status | string | ok, or why this row carries no data: no_results, no_change, partial, blocked, or error. |
error_reason | string | Why the row is not ok. A refused input reads input_invalid: followed by what to fix. |
billable_events_json | string | What this row was billed as, for example {"game-row":1}. {} means free. |
scraped_at | string | When the row was written, UTC. |
Pricing
Pay per event. Mamba Labs pays the platform costs of the run. Summary rows, refused reads, and a refused input are free.
Each league is read once per day. A league day with no game that fits your filters is free for the first 2 in a run, then charged as empty-read, because a long range in the off season costs money to read. Narrow your dates and leagues to pay less, and set max_charge_usd to cap a run.
| Event | Free plan | Bronze | Silver | Gold |
|---|---|---|---|---|
game-row, one game | $0.0018 | $0.00171 | $0.00162 | $0.00153 |
empty-read, one league and day with no fitting game, after the first 2 free | $0.001 | $0.00095 | $0.0009 | $0.00085 |
apify-actor-start, once per run (one per GB of memory; the default 256 MB is one) | $0.002 | $0.002 | $0.002 | $0.002 |
Per 1,000 rows of game-row: $1.80 on the free plan, $1.53 on Gold.
Free plan cap: 1.50 USD of evaluation a month, about 833 rows. Any paid Apify plan removes the cap, and it resets on the 1st. The run stops before a charge that passes your maximum charge per run in Apify or your max_charge_usd input.
Mamba Labs pays the platform costs of your run, Apify proxy traffic included.
Usage examples
Last night's NBA and NHL results.
{"leagues": ["nba", "nhl"],"date_from": "yesterday","statuses": ["finished"]}
Today's live and upcoming Premier League and Champions League games.
{"leagues": ["premier league", "champions league"],"date_from": "today","statuses": ["live", "upcoming"]}
Every Celtics game in November 2026.
{"leagues": ["nba"],"date_from": "2026-11-01","date_to": "2026-11-30","teams": ["celtics"]}
A full NFL week.
{"leagues": ["nfl"],"date_from": "2026-11-12","date_to": "2026-11-16"}
Clay. Number inputs are text fields, which is what Clay sends. A list input takes a JSON list, so wrap a column in a one item list, such as ["nba"].
MCP. The Mamba Labs MCP server @mambalabsdev/mcp-sports-scores-fixtures exposes this actor to Claude and other MCP clients.
Error handling
| Case | What you get |
|---|---|
| Missing or unreadable input | One free row, row_type run_summary, error_reason starting input_invalid: with what to fix |
| A league path ESPN does not serve | One free source_report row for that league, read once, and the run goes on with the other leagues |
| ESPN refuses a read | One free source_report row with row_status blocked, and the run goes on. After 4 refusals in a row the run stops |
| No game fits your input | One free summary row with row_status no_results |
max_games or max_charge_usd is reached | The rows so far, and a free summary row with row_status partial |
| The run is close to its timeout | The actor stops starting new work 90 seconds before the timeout and delivers what it has, with a partial summary row |
Limitations
- This reads ESPN, an unofficial source with no published contract for these addresses. ESPN can change or close them without notice, and then reads return free
source_reportrows until the actor is updated. - No play by play, box score statistics, player stats, standings, or odds. Rows are the scoreboard view of each game.
schedule_dayis ESPN's schedule day, which follows US Eastern time. A late game in Europe or Asia is filed under ESPN's day, andstart_time_utcholds the exact start.- Fixtures are what ESPN lists on the day you read. A fixture far ahead can have no time yet;
start_time_confirmedis false then. - Soccer rows carry the final score but no per half scores. Period scores appear where ESPN gives line scores, such as the NBA, NFL, NHL, and MLB.
- A run reads at most 62 days and 400 league days. Each league day is one read of about 1 second in testing, plus a short pause.
Mamba Labs actor suite
Built by Mamba Labs.