NBA Scores, Standings, Teams & Rosters Scraper

Here is one real result, with every field the actor returns (a completed game with the box score and AI matchup add-ons switched on):

{
  "recordType": "game",
  "gameId": "401810987",
  "season": "2025-26",
  "seasonYear": 2026,
  "seasonType": "Regular Season",
  "date": "2026-04-05T19:30Z",
  "name": "Toronto Raptors at Boston Celtics",
  "shortName": "TOR @ BOS",
  "state": "post",
  "status": "Final",
  "statusDetail": "Final",
  "completed": true,
  "period": 4,
  "clock": "12:00",
  "homeTeam": "Boston Celtics",
  "homeAbbrev": "BOS",
  "homeTeamId": "2",
  "homeScore": 115,
  "homeWinner": true,
  "homeRecord": "53-25",
  "homeLogo": "https://a.espncdn.com/i/teamlogos/nba/500/scoreboard/bos.png",
  "homeTopPerformer": "Jayson Tatum",
  "homeTopPerformerLine": "23 PTS, 13 REB, 7 AST, 3 STL",
  "homePointsLeader": "Jaylen Brown",
  "homePointsLeaderValue": 26,
  "homeReboundsLeader": "Jayson Tatum",
  "homeReboundsLeaderValue": 13,
  "homeAssistsLeader": "Jayson Tatum",
  "homeAssistsLeaderValue": 7,
  "awayTeam": "Toronto Raptors",
  "awayAbbrev": "TOR",
  "awayTeamId": "28",
  "awayScore": 101,
  "awayWinner": false,
  "awayRecord": "43-35",
  "awayTopPerformer": "Collin Murray-Boyles",
  "awayTopPerformerLine": "12 PTS",
  "venue": "TD Garden",
  "venueCity": "Boston",
  "venueState": "MA",
  "attendance": 19156,
  "broadcast": "NBC Sports BO, Sportsnet, NBA TV",
  "url": "https://www.espn.com/nba/game/_/gameId/401810987/raptors-celtics",
  "homeFieldGoals": "47-88",
  "homeFieldGoalPct": 53,
  "homeThreePointers": "8-28",
  "homeRebounds": 44,
  "homeAssists": 25,
  "homePointsInPaint": 76,
  "awayFieldGoals": "40-84",
  "awayRebounds": 31,
  "awayAssists": 31,
  "aiStoryline": "The Boston Celtics secured a solid victory over the Toronto Raptors, showcasing their depth and defensive prowess. Jayson Tatum led the charge with a near triple-double performance.",
  "aiKeyPlayers": "Jayson Tatum, Collin Murray-Boyles",
  "aiPrediction": "The Celtics' strong performance indicates they are poised for a deep playoff run, while the Raptors will need to regroup to secure their postseason spot.",
  "observedAt": "2026-08-21T03:30:32.425Z",
  "error": null
}

The most complete NBA scraper available. It returns every field the public NBA data feed exposes for scores, standings, teams and rosters, plus derived fields such as per-competitor points, rebounds and assists leaders, home and away box score splits, and an optional AI matchup summary, and gives you four modes with team and date filters to target exactly the records you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting
• More scrapers at scrapers.lat

What it does

This actor pulls live and historical NBA data in four modes:

• Scores: one record per game for any date. Matchup, scores, live status and clock, home and away season records, venue and attendance, broadcast networks, betting line when posted, and the points, rebounds and assists leaders for each team. Optional per-game team box score and an optional AI matchup summary.
• Standings: one record per team with conference, division, playoff seed, wins, losses, win percentage, games behind, current streak, points for and against per game, point differential, and home, away, last ten, division and conference splits.
• Teams: one record per team (all 30) with location, nickname, colors, logo, home arena, and current standing summary.
• Roster: one record per player for a chosen team with jersey number, position, height, weight, age, birthplace, college, years of experience, salary when available, and headshot.

It is built for NBA fans, sports betting and fantasy tools, media sites, and app developers who need clean, structured NBA data without maintaining a scraper.

Quickstart

Get today's games, or set a date. Free Apify plans return up to 10 records per run.

{
  "mode": "scores",
  "date": "2026-04-05",
  "maxResults": 20
}

Standings for the current season:

{
  "mode": "standings",
  "maxResults": 30
}

A team roster:

{
  "mode": "roster",
  "teamAbbrev": "LAL",
  "maxResults": 20
}

Input reference

Name	Type	Required	Description	Example
mode	string	no	What to scrape: scores, standings, teams or roster. Default scores.	"standings"
date	string	no	Scores mode only. Single day in YYYY-MM-DD. Empty returns today's games and nearby fixtures.	"2026-04-05"
season	integer	no	Season year (for example 2026 for the 2025-26 season).	2026
teamAbbrev	string	no	Roster mode. Team abbreviation such as LAL, BOS, GSW.	"LAL"
teamId	string	no	Roster mode. Numeric team id (alternative to teamAbbrev; wins if both set).	"13"
includeBoxScore	boolean	no	Scores mode, paid plans. Add the full team box score per game. Billed only when a real box score is returned.	true
aiMatchupSummary	boolean	no	Scores mode, paid plans. Add an AI storyline, key players and prediction per game. Billed only on usable AI output.	true
maxResults	integer	no	Maximum records to return. Free plans are capped at 10.	20

Output reference

Field set depends on mode. Common and per-mode fields:

Name	Type	Description
recordType	string	game, standing, team or player
gameId	string	Game id (scores)
date	string	Game date and time, ISO 8601 (scores)
shortName	string	Short matchup, e.g. TOR @ BOS (scores)
statusDetail	string	Game status, e.g. Final or 4th 2:31 (scores)
homeTeam / awayTeam	string	Team names (scores)
homeScore / awayScore	number	Team scores (scores)
homeRecord / awayRecord	string	Season record at game time (scores)
homeTopPerformer / awayTopPerformer	string	Standout player per team (scores)
homeTopPerformerLine	string	Standout stat line, e.g. 23 PTS, 13 REB, 7 AST (scores)
homePointsLeader / homeReboundsLeader / homeAssistsLeader	string	Category leaders per team (scores)
venue / venueCity / venueState	string	Arena and location (scores, teams)
broadcast	string	Broadcast networks (scores)
spread / overUnder / homeMoneyLine / awayMoneyLine	number	Betting line when posted (scores)
homeFieldGoals / homeThreePointers / homeRebounds / homeAssists	string, number	Team box score, box score add-on (scores)
aiStoryline / aiKeyPlayers / aiPrediction	string	AI matchup summary, AI add-on (scores)
team / teamAbbrev / teamId	string	Team identity (standings, teams, roster)
conference / division	string	Conference and division (standings, teams)
playoffSeed / wins / losses / winPct	number	Standing (standings)
gamesBehind / streak / record	string	Games behind, streak, overall record (standings)
homeRecord / awayRecord / lastTenRecord / divisionRecord / conferenceRecord	string	Split records (standings)
pointsForPerGame / pointsAgainstPerGame / pointDifferential	number	Scoring splits (standings)
location / nickname / color / alternateColor / teamLogo	string	Team identity and branding (teams)
standingSummary	string	e.g. 1st in Pacific Division (teams)
player / jersey / position	string	Player identity (roster)
height / weight / age / college / experienceYears / salary	string, number	Player bio (roster)
birthCity / birthState / birthCountry / headshot	string	Player origin and photo (roster)
observedAt	string	When the record was captured, ISO 8601
error	string	Error message when a record could not be built, otherwise null

Example output record

A standings record:

{
  "recordType": "standing",
  "team": "Oklahoma City Thunder",
  "teamAbbrev": "OKC",
  "teamId": "25",
  "conference": "Western Conference",
  "division": "Northwest",
  "playoffSeed": 1,
  "wins": 64,
  "losses": 18,
  "winPct": 0.78,
  "gamesBehind": "-",
  "streak": "W5",
  "record": "64-18",
  "homeRecord": "34-7",
  "awayRecord": "30-11",
  "lastTenRecord": "8-2",
  "pointsForPerGame": 118.2,
  "pointsAgainstPerGame": 107.6,
  "pointDifferential": 10.6,
  "observedAt": "2026-08-21T03:30:00.000Z",
  "error": null
}

A roster record:

{
  "recordType": "player",
  "player": "Luka Doncic",
  "team": "Los Angeles Lakers",
  "teamAbbrev": "LAL",
  "jersey": "77",
  "position": "Guard",
  "height": "6' 8\"",
  "weight": "230 lbs",
  "age": 27,
  "birthCity": "Ljubljana",
  "birthCountry": "Slovenia",
  "experienceYears": 8,
  "salary": 49500000,
  "headshot": "https://a.espncdn.com/i/headshots/nba/players/full/3945274.png",
  "observedAt": "2026-08-21T03:30:00.000Z",
  "error": null
}

Run via API and CLI

Start a run with the Apify API:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~nba-scores-standings-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"scores","date":"2026-04-05","maxResults":20}'

Run with the Apify CLI:

apify call scrapers_lat/nba-scores-standings-scraper \
  --input '{"mode":"standings","maxResults":30}'

Fetch results

Download the dataset items in JSON, CSV or Excel:

$curl "https://api.apify.com/v2/datasets/DATASET_ID/items?format=csv" -o nba.csv

The run response includes defaultDatasetId. Add &format=json, &format=csv or &format=xlsx.

Billing and limits

• Pay per result. You are charged per record returned. Empty runs (for example a date with no games) return nothing and are not charged for results.
• Events. result (one game, standing, team or player), plus optional game_boxscore (per-game team box score) and ai_matchup_summary (per-game AI summary). Add-ons are opt-in, off by default, and available on paid plans only.
• No charge on failure. A record is only billed when real data is produced. Box score and AI events are billed only when they actually return content.
• Free plan cap. Free Apify accounts return up to 10 records per run. Paid accounts can raise maxResults.
• Spend cap. The actor respects your run maxTotalChargeUsd and stops emitting billable records once the limit is reached.

FAQ and troubleshooting

No records came back for my date. That date had no scheduled games. Try a date during the season, for example a regular season or playoff day.

Which team abbreviations work? Standard NBA abbreviations such as LAL, BOS, GSW, DEN, OKC. You can also pass a numeric teamId.

Are salaries always present? Salary is included when the source exposes it; otherwise it is null.

Is betting data always included? The spread, over/under and moneyline are included when a sportsbook line is posted for a game, otherwise they are null.

How fresh is the data? Scores reflect live game state including the current period and clock. Standings and rosters reflect the current season.

More scrapers at scrapers.lat

Building sports and data products? Explore more actors from scrapers_lat on Apify for scores, standings, odds and structured public data across sports, finance and business.

---

This actor is an independent tool that collects publicly available information. It is not affiliated with, endorsed by, or sponsored by the NBA or any team or data provider.