ParseForge
NBA Stats Official Scraper
parseforge/nba-stats-scraper
OtherNews & media
Scrapes official NBA stats from stats.nba.com: standings, league leaders, player stats, and team stats for any season. Returns flat JSON rows.
- Total users
- 5
- Monthly active
- 1
- Total runs
- 118
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 9 days ago
Overview
NBA Stats Official Scraper
Scrape official NBA stats from stats.nba.com: standings, leaders, player stats, and team stats for any season. Get clean JSON rows with no API key or login. Export to CSV, JSON, Excel, or XML.
The NBA's official stats site has no public API and blocks normal scrapers. This Actor queries stats.nba.com endpoints directly and returns the data as flat rows. Pick an endpoint, a season, and a season type, and get the numbers you need.
| Who uses it | What they scrape NBA Stats for |
|---|---|
| Sports analysts | Pull current standings or player stats for a season to feed a model or report. |
| Fantasy basketball players | Get league leaders or player stats to make waiver wire decisions. |
| Sports bettors | Download team stats for a season to inform betting models. |
| Journalists | Grab official NBA stats for a story without manual copying. |
| Data engineers | Load NBA stats into a warehouse on a schedule. |
What it does
This Actor collects NBA standings, league leaders, player stats, or team stats from stats.nba.com and returns each record as a flat row.
- 🏀 League Standings: current standings for any season and season type.
- 📊 League Leaders: top players by points, rebounds, assists, and more.
- 👤 Player Stats: per-game or totals for every player in a season.
- 📈 Team Stats: team-level stats for a season, regular or playoffs.
- 🗓️ Season and type filters: pick any season from 1996-97 onward and Regular Season, Playoffs, Pre Season, or All Star.
- 🔢 Max items control: limit rows from 10 up to 1,000,000 per run.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with NBA Stats data
📊 Build a season dashboard.
A data analyst runs the Actor for Player Stats, Regular Season, 2024-25, and loads the CSV into a BI tool to track player performance.
🏆 Track the playoff race.
A sports writer runs League Standings for the current season every morning and publishes the latest conference rankings.
🎯 Scout fantasy pickups.
A fantasy basketball player pulls League Leaders for the last week and sorts by points to find a hot free agent.
📈 Feed a betting model.
A bettor downloads Team Stats for the last three seasons and uses the CSV to train a model that predicts point spreads.
🗄️ Archive NBA history.
A data engineer schedules the Actor to fetch Player Stats for every season since 1996-97 and stores the JSON in a warehouse.
Why choose this scraper
| What you get | |
|---|---|
| Official source | Data comes straight from stats.nba.com, the NBA's own stats site. |
| No API key | No registration, no OAuth, no rate-limit headaches. |
| Flat rows | Every record is a flat object, ready for CSV, JSON, Excel, or XML. |
| Any season | Go back to 1996-97 or pull the current season. |
| Flexible output | Export to CSV, JSON, Excel, or XML, or push to a dataset. |
How it compares
No other Store actor targets NBA Stats the same way, so the honest comparison is with the alternatives teams actually weigh.
| NBA Stats Official Scraper | Build it in-house | By hand | |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When NBA Stats changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |
Configure the run
Drive the Actor from one of four endpoints, then set the season and season type. Max items caps the rows returned. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10
}
A larger pull:
{
"maxItems": 200
}
Pricing
Pay-per-result: $0.021 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the NBA Stats Official Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to NBA Stats through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/nba-stats-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Check the season format. It must be YYYY-YY, like 2024-25. Also make sure the season type matches the endpoint. For example, All Star may not have standings.
Why did I get only 10 rows?
Free runs are limited to 10 rows. Upgrade to a paid plan and set maxItems higher, up to 1,000,000.
Why does the run fail with a timeout?
stats.nba.com can be slow. Increase the Actor's timeout in the run settings, or reduce maxItems.
Why are some fields empty?
Not every stat is tracked for every season or season type. For example, advanced stats may be missing for older seasons.
Can I get data for a custom date range?
No. The Actor returns full season data. Filter by date in your own code after export.
FAQ
| Question | Answer |
|---|---|
| Do I need an API key or login? | No. The Actor queries stats.nba.com directly and handles the required headers for you. |
| Which endpoints can I scrape? | League Standings, League Leaders, Player Stats, and Team Stats. Pick one per run. |
| What seasons are available? | Any season from 1996-97 to the current one. Enter the season in YYYY-YY format, like 2024-25. |
| Can I get playoff stats? | Yes. Set seasonType to Playoffs, Pre Season, All Star, or Regular Season. |
| How many rows can I get? | Free runs return up to 10 rows. Paid runs can return up to 1,000,000 rows. |
| What format is the output? | Each record is a flat JSON object. You can export the dataset to CSV, JSON, Excel, or XML. |
| Does this work for WNBA or G League? | No. This Actor only queries stats.nba.com, which covers the NBA. |
| Can I schedule this to run daily? | Yes. Use Apify's scheduler to run the Actor on a cron and push results to a dataset or storage. |
| Is this legal? | You are responsible for how you use the data. The Actor only accesses publicly available stats pages. |
| What if I need a different endpoint? | The Actor supports four endpoints. If you need another stats.nba.com endpoint, contact support and we can add it. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by NBA Media Ventures, LLC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| endpoint | string (4 options) | stats.nba.com endpoint to query. | leaguestandingsv3 |
| season | string | NBA season in YYYY-YY format. | 2024-25 |
| seasonType | string (4 options) | Type of NBA season to fetch. | Regular Season |
| maxItems | integer | Free: 10. Paid: up to 1,000,000. | 10 |
Pricing
from $19.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.019 to $0.021 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~nba-stats-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.