# NBA Scores — Live Stats & Game Data (`nexgendata/nba-scoreboard`) Actor

Get live and historical NBA scores, box scores, player stats & standings. Build sports dashboards, fantasy tools & basketball analytics. Real-time data during games. Pay per query.

- **URL**: https://apify.com/nexgendata/nba-scoreboard.md
- **Developed by:** [NexGenData](https://apify.com/nexgendata) (community)
- **Categories:** Sports, AI, News
- **Features:** Limited permissions
- **Stats:** 19 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 game records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## NBA Scoreboard Scraper by nexgendata

NBA Scores is a NexGenData tool on Apify that returns live and historical scores, box scores, player stats and standings from public NBA scoreboards.

Extract NBA game data including live and final scores, team standings, season schedules, box scores, and player statistics for every game at scale. Built for sports betting apps consuming live score data and anyone who needs structured sports data without the overhead of building a custom scraper.

> **Proxy:** this actor uses Apify residential proxy because the NBA's data CDN refuses Apify's datacenter proxy (Akamai 403, tested Nov 3, 2026). Residential proxy costs more: Apify bills residential traffic to you per GB.

### 📊 Sample Output

![6 real rows delivered by NBA Scores — Live Stats & Game Data — run fQKNFJOogjLTiq38X on build 0.0.20](https://api.apify.com/v2/key-value-stores/8gLgXMBveEI1tTz1z/records/nba-scoreboard-sample)

| `gameId` | `gameDate` | `gameStatus` | `awayTeam` | `arena` | `arenaCity` |
|---|---|---|---|---|---|
| 0022600004 | 2026-10-21 | 7:30 pm ET | Timberwolves | Kaseya Center | Miami |
| 0022600005 | 2026-10-21 | 10:00 pm ET | Warriors | Crypto.com Arena | Los Angeles |
| 0022600085 | 2026-10-21 | 7:00 pm ET | Hawks | Kia Center | Orlando |
| 0022600086 | 2026-10-21 | 7:00 pm ET | Bucks | Capital One Arena | Washington |
| 0022600087 | 2026-10-21 | 7:30 pm ET | Hornets | Barclays Center | Brooklyn |
| 0022600088 | 2026-10-21 | 7:30 pm ET | Bulls | Scotiabank Arena | Toronto |

Real rows from run `fQKNFJOogjLTiq38X` on build 0.0.20 (2026-09-25), unedited apart from masked emails/phones and shortened long text; fields the source does not publish are empty.

### 🔧 Input reference

| Field | Type | Default | What it does |
|---|---|---|---|
| `date` | string | `"2026-10-21"` | Date in YYYY-MM-DD format (leave empty for today) |

### 🧾 JSON sample record

One real record from run `fQKNFJOogjLTiq38X` (emails/phones masked, long text shortened):

```json
{
  "gameId": "0022600004",
  "gameDate": "2026-10-21",
  "gameStatus": "7:30 pm ET",
  "gameStatusId": 1,
  "homeTeam": "Heat",
  "homeTricode": "MIA",
  "homeScore": 0,
  "awayTeam": "Timberwolves",
  "awayTricode": "MIN",
  "awayScore": 0,
  "arena": "Kaseya Center",
  "arenaCity": "Miami",
  "period": 0,
  "gameClock": "",
  "gameLabel": "",
  "gameTimeUTC": "2026-10-21T23:30:00Z",
  "source": "staticData/scheduleLeagueV2",
  "scrapedAt": "2026-09-25T04:03:21.592015"
}
```

### 💰 Pricing

| Event | Price (USD) | When it is charged |
|---|---|---|
| Actor Start (`apify-actor-start`) | $5e-05 | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). |
| Game record (`apify-default-dataset-item`) | $0.005 | Single result in the default dataset. |

Pay-per-event: you pay only for what the run delivers. A run that delivers nothing bills no result events (only the actor-start event, when the actor defines one). Example: a run that delivers 100 results costs 100 × $0.005 = $0.50 plus the start fee.

### 🔗 Related Actors

More from the NexGenData **Data APIs** family:

- [Google Shopping Scraper — Product Prices & Sellers API](https://apify.com/nexgendata/google-shopping-scraper?fpr=2ayu9b)
- [Kuaishou Trending Tracker — 快手热榜 Hot Board API](https://apify.com/nexgendata/kuaishou-trending-tracker?fpr=2ayu9b)
- [Landing Page Change Monitor — Track Competitor Pages](https://apify.com/nexgendata/landing-page-change-monitor?fpr=2ayu9b)
- [OpenFEMA NFIP Flood Insurance Claims API](https://apify.com/nexgendata/openfema-nfip-flood-claims?fpr=2ayu9b)
- [RECAP PACER Federal Docket Search API](https://apify.com/nexgendata/recap-pacer-docket-search?fpr=2ayu9b)
- [Regulatory Enforcement to Markdown — RAG Data API](https://apify.com/nexgendata/regulatory-enforcement-rag?fpr=2ayu9b)

27 more in this family on the [NexGenData Store page](https://apify.com/nexgendata?fpr=2ayu9b).

### What This Actor Does

The NBA Scoreboard Scraper connects to NBA and extracts NBA game data including live and final scores, team standings, season schedules, box scores, and player statistics for every game. It handles pagination, rate limiting, and data normalization automatically so you get clean, structured JSON output ready for your database, dashboard, or analytics pipeline. No API keys to manage, no infrastructure to maintain.

### Who Uses This

Sports betting apps consuming live score data, fantasy basketball platforms tracking real-time performance, sports journalists building data-driven stories, and analytics teams modeling game outcomes. If you need sports data at scale without building and maintaining your own extraction pipeline, this actor handles the heavy lifting.

### What You Get Back

Each run produces a structured dataset in JSON format. Every record includes all available fields from the source, normalized into a consistent schema. The data is immediately available for export in JSON, CSV, or Excel format, or you can push it directly to your data warehouse via Apify integrations with Google Sheets, Slack, Webhooks, and 50+ other platforms.

### How It Compares

NBA Stats API is unofficial and frequently changes. SportsRadar NBA feed costs $500+/month minimum. Free alternatives are unreliable and lack structured output. This actor delivers the same data at $3 per 1,000 results with zero monthly commitment, no API key management, and results available in seconds. Pay only for what you use.

### Sample Output

```json
{
  "source": "nba-scoreboard",
  "data": "Structured sports data fields",
  "timestamp": "2024-03-29T12:00:00Z",
  "url": "https://example.com/source"
}
```

### Use Cases

Teams use the NBA Scoreboard Scraper across a range of workflows. Analysts feed the output into business intelligence dashboards for real-time monitoring. Developers integrate it into automated data pipelines that run on daily or weekly schedules. Researchers use bulk exports for large-scale analysis projects. Marketing teams track competitive movements and industry trends. The structured output format means the data slots into virtually any downstream system with minimal transformation.

### Pricing: $5 per 1,000 Results

At $3/1K, processing 5,000 results costs $15.00 total. A daily pipeline pulling 500 results runs $1.50/day ($45/month). Compare that to building and maintaining your own scraping infrastructure, which typically costs $500-2,000/month in proxy fees, compute, and engineering time alone.

### FAQ

**How often can I run this?**
As often as you need. Schedule runs hourly, daily, or weekly through Apify's built-in scheduler, or trigger runs via API from your own systems.

**What format is the output?**
JSON by default, with one-click export to CSV or Excel. You can also push results directly to Google Sheets, webhooks, or any HTTP endpoint via Apify integrations.

**Do I need any API keys?**
No. The actor handles all authentication and access internally. Just configure your search parameters and run.

**Can I integrate this with my existing tools?**
Yes. Apify supports integrations with Zapier, Make, Google Sheets, Slack, and direct webhook delivery. You can also use the Apify API to pull results programmatically into any system.

### Related tools

- [NHL Scores — Live Stats & Game Data](https://apify.com/nexgendata/nhl-scoreboard?fpr=2ayu9b)
- [NFL Scores — Live Stats & Game Data](https://apify.com/nexgendata/nfl-scoreboard?fpr=2ayu9b)

# Actor input Schema

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

Date in YYYY-MM-DD format (leave empty for today) The schedule source only carries the CURRENT season (2026-27 runs from 2026-10-03); dates in past seasons return 0 games. Leave empty for today.

## Actor input object example

```json
{
  "date": "2026-10-21"
}
```

# Actor output Schema

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

Default dataset of NBA Scores — Live Stats & Game Data records (18 fields per row: gameId, gameDate, gameStatus, gameStatusId, homeTeam, homeTricode, homeScore, awayTeam, awayTricode, awayScore, arena, arenaCity…).

# 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 = {
    "date": "2026-10-21"
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexgendata/nba-scoreboard").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 = { "date": "2026-10-21" }

# Run the Actor and wait for it to finish
run = client.actor("nexgendata/nba-scoreboard").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 '{
  "date": "2026-10-21"
}' |
apify call nexgendata/nba-scoreboard --silent --output-dataset

```

## MCP server setup

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

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/4pps3GTo9lyppELx0/builds/7CMwARuI4pTAEvikW/openapi.json