# NBA Scores, Standings, Teams & Rosters Scraper (`scrapers_lat/nba-scores-standings-scraper`) Actor

Scrape NBA game scores by date, conference and division standings, all 30 teams and full rosters. Get matchups, scores, records, streaks, top performers, odds, box scores and player bios. Export to JSON, CSV or Excel.

- **URL**: https://apify.com/scrapers\_lat/nba-scores-standings-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.56 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

[![NBA Scores, Standings, Teams & Rosters Scraper](https://scrapers.lat/banners/nba-scores-standings-scraper.png)](https://console.apify.com/actors/n3AV0yVGlSfkhTHpv/input)

## 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):

```json
{
  "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](https://apify.com/scrapers_lat/nba-scores-standings-scraper/input-schema) · 📤 [Output](https://apify.com/scrapers_lat/nba-scores-standings-scraper/output-schema) · 💰 [Pricing](https://apify.com/scrapers_lat/nba-scores-standings-scraper/pricing) · ▶️ [Examples](https://apify.com/scrapers_lat/nba-scores-standings-scraper/examples)**

![Platform](https://img.shields.io/badge/platform-Apify-blue) ![Coverage](https://img.shields.io/badge/coverage-NBA%2030%20teams-orange) ![Output](https://img.shields.io/badge/output-JSON%20%7C%20CSV%20%7C%20Excel-green) ![Billing](https://img.shields.io/badge/billing-pay%20per%20result-purple)

### Table of contents

- [What it does](#what-it-does)
- [Quickstart](#quickstart)
- [Input reference](#input-reference)
- [Output reference](#output-reference)
- [Example output record](#example-output-record)
- [Run via API and CLI](#run-via-api-and-cli)
- [Fetch results](#fetch-results)
- [Billing and limits](#billing-and-limits)
- [FAQ and troubleshooting](#faq-and-troubleshooting)
- [More scrapers at scrapers.lat](#more-scrapers-at-scraperslat)

### 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.

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

Standings for the current season:

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

A team roster:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

```bash
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:

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

### Fetch results

Download the dataset items in JSON, CSV or Excel:

```bash
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.

# Actor input Schema

## `mode` (type: `string`):

Choose the kind of NBA data to collect: game scores for a date, the league standings, the list of teams, or a team's roster.

## `date` (type: `string`):

Scores mode only. A single day in YYYY-MM-DD format (for example 2026-04-05). Leave empty to return today's games and nearby fixtures.

## `season` (type: `integer`):

Optional NBA season year (for example 2026 for the 2025-26 season). Applied where the source supports it; standings and scores reflect the current season by default.

## `teamAbbrev` (type: `string`):

Roster mode only. Team abbreviation such as LAL, BOS, GSW, DEN. Used to select which team's players to return.

## `teamId` (type: `string`):

Roster mode only. Numeric team ID (alternative to Team abbreviation). If both are set, Team ID wins.

## `includeBoxScore` (type: `boolean`):

Scores mode only, paid plans only. Fetch the full team box score for each game (shooting splits, rebounds, assists, turnovers, paint and fast-break points). Billed per game only when a real box score is returned.

## `aiMatchupSummary` (type: `boolean`):

Scores mode only, paid plans only. Add an AI-written storyline, key players and prediction for each game. Billed per game only when usable AI output is produced.

## `maxResults` (type: `integer`):

Maximum number of records to collect (games, standings rows, teams or players). Free Apify plans are capped at 10 per run.

## Actor input object example

```json
{
  "mode": "scores",
  "teamAbbrev": "LAL",
  "includeBoxScore": false,
  "aiMatchupSummary": false,
  "maxResults": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "scores",
    "teamAbbrev": "LAL",
    "maxResults": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/nba-scores-standings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "scores",
    "teamAbbrev": "LAL",
    "maxResults": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/nba-scores-standings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "scores",
  "teamAbbrev": "LAL",
  "maxResults": 10
}' |
apify call scrapers_lat/nba-scores-standings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapers_lat/nba-scores-standings-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/n3AV0yVGlSfkhTHpv/builds/SFx3iWfwQ9mJXEK7U/openapi.json