🏀 NBA Player Box Score Scraper

The best NBA player box score scraper on Apify — clean and analysis-ready data from 2002 onward

Stop cleaning messy basketball data. Get every NBA player box score since 2002 - 50+ fields, proper types, zero cleanup required.

---

🎯 What does this scraper do?

This actor extracts detailed player-level statistics from every NBA game played since 2002. It delivers clean, structured data ready for analysis or integration into your applications. No manual cleanup, no parsing nightmares, no messy nested data.

Key Benefits

• ✅ 50+ fields per player - scoring, shooting, rebounds, assists, and more
• ✅ 2002–present - 20+ seasons of historical coverage
• ✅ Clean structure - proper types and descriptive field names
• ✅ Fast & reliable - built-in validation and error handling
• ✅ Export anywhere - JSON, CSV, Excel, XML, and more

💡 No manual cleanup. No parsing nightmares. Just clean data.

---

📦 What data can you extract?

Every player game returns 50+ structured data points including:

Category	What's Included
🎮 Game Info	Game ID, season info, game date, season type
🏀 Team	Team name, city, mascot, abbreviation, logo
👤 Player	Name, jersey number, position, headshot URL
🎯 Game Status	Starter, active, did not play reason, ejected
⏱️ Playing Time	Minutes played
🔥 Scoring	Points, field goals, 3-pointers, free throws (made/attempted/pct)
📦 Rebounds	Total, offensive, defensive
🤝 Playmaking	Assists, turnovers, assist-to-turnover ratio
🛡️ Defense	Steals, blocks, personal fouls
📊 Efficiency	Plus/minus
👥 Opponent	Full opponent info and score
🏆 Outcome	Team score, opponent score, win/loss

💡 See the full data dictionary for all 50+ fields below.

---

🚀 How to scrape NBA player box score data

Quick Start Guide

Extracting NBA player box score data is simple - no coding required.

1. Create account — Sign up for a free Apify account
2. Open scraper — Go to NBA Player Box Score Scraper
3. Select inputs — Choose a team and season year
4. Run — Click Start in the Apify Console
5. Export — Download as JSON, CSV, Excel, XML, or HTML

✨ Try it FREE - No credit card required

---

📥 Inputs

The scraper requires two simple inputs:

Input	Required	Description	Example
Season	✅	4-digit year (2002–present)	2026 → 2025-26 season
Team	✅	NBA team mascot name	Raptors, Lakers, Celtics

Option A: Use Apify Console (No Code)

The easiest way to get started — just point and click.

1. Open the NBA Player Box Score Scraper
2. Enter a season year (defaults to latest)
3. Select a team from the dropdown
4. Click Start
5. Download results

Option B: Use the API (Programmatic)

For automation, scheduling, or integration into your pipeline:

{
  "season": 2026,
  "team": "Raptors"
}

⚠️ Note: both season and team are required fields.

---

📤 Output

Results are stored in the Storage tab as a structured dataset. View directly on the platform or download in multiple formats.

Results Preview

Once scraping completes, preview your data immediately in the Output tab.

Organized Views

We've pre-configured logical dataset views to help you explore the data more easily.

Sample JSON Output

Each player game returns a clean, flat JSON object with 50+ fields. Field names are descriptive and grouped by prefix (game_, team_, player_, score_, etc.) so you can quickly find what you need.

---

📖 Data Dictionary

Complete reference for all 50+ fields returned by this scraper. Fields are grouped by prefix for easy navigation.

Field	Type	Category	Description
game_id	integer	Game	Unique identifier for the game
game_date	string	Game	Game date (YYYY-MM-DD)
game_datetime	string	Game	Game date and time (ISO 8601)
game_season	integer	Game	Season year (e.g., 2026 for 2025-26 season)
game_season_type	integer	Game	Season type code (1=preseason, 2=regular, 3=playoffs)
game_season_type_name	string	Game	Season type name (Preseason, Regular Season, Playoffs)
team_name_full	string	Team	Full team name (e.g., "Milwaukee Bucks")
team_abbreviation	string	Team	Team abbreviation (e.g., "MIL")
team_city	string	Team	Team city (e.g., "Milwaukee")
team_mascot	string	Team	Team mascot (e.g., "Bucks")
team_id	integer	Team	Unique team identifier
team_logo	string	Team	URL to team logo
team_venue	string	Team	Home or away
player_id	integer	Player	Unique player identifier
player_display_name	string	Player	Full player name
player_short_name	string	Player	Abbreviated name (e.g., "G. Antetokounmpo")
player_jersey	string	Player	Jersey number
player_position	string	Player	Full position name (e.g., "Forward")
player_position_abbr	string	Player	Position abbreviation (e.g., "F")
player_headshot	string	Player	URL to player headshot image
player_starter	boolean	Status	Whether player started the game
player_active	boolean	Status	Whether player was active
player_did_not_play	boolean	Status	Whether player did not play
player_did_not_play_reason	string	Status	Reason for not playing (if applicable)
player_ejected	boolean	Status	Whether player was ejected
minutes_played	integer	Time	Minutes played
points_total	integer	Scoring	Total points scored
field_goals_made	integer	Scoring	Field goals made
field_goals_attempted	integer	Scoring	Field goals attempted
field_goals_pct	number	Scoring	Field goal percentage (0-100 scale)
three_pointers_made	integer	Scoring	Three-pointers made
three_pointers_attempted	integer	Scoring	Three-pointers attempted
three_pointers_pct	number	Scoring	Three-point percentage (0-100 scale)
free_throws_made	integer	Scoring	Free throws made
free_throws_attempted	integer	Scoring	Free throws attempted
free_throws_pct	number	Scoring	Free throw percentage (0-100 scale)
rebounds_total	integer	Rebounds	Total rebounds
rebounds_offensive	integer	Rebounds	Offensive rebounds
rebounds_defensive	integer	Rebounds	Defensive rebounds
assists_total	integer	Playmaking	Total assists
turnovers_total	integer	Playmaking	Total turnovers
assists_to_turnovers_ratio	number	Playmaking	Assists divided by turnovers
steals_total	integer	Defense	Total steals
blocks_total	integer	Defense	Total blocks
fouls_personal	integer	Defense	Personal fouls
plus_minus	string	Efficiency	Plus/minus as string (e.g., "+3")
plus_minus_numeric	integer	Efficiency	Plus/minus as number
opponent_id	integer	Opponent	Opponent team ID
opponent_name_full	string	Opponent	Opponent full name
opponent_abbreviation	string	Opponent	Opponent abbreviation
opponent_city	string	Opponent	Opponent city
opponent_mascot	string	Opponent	Opponent mascot
opponent_logo	string	Opponent	URL to opponent logo
opponent_score	integer	Opponent	Opponent's final score
score_points_for	integer	Outcome	Team's final score
score_points_against	integer	Outcome	Opponent's final score
score_margin	integer	Outcome	Point differential (positive = win)
game_outcome	string	Outcome	Win or Loss

💡 Note: Shooting percentages are on a 0-100 scale. Some fields may be null depending on player status — for example, stats are null for players who did not play. All missing values are explicit null, not empty strings.

---

🔗 Sportsverse Data Suite

Building something bigger? Our ecosystem covers comprehensive sports data. Check out our other sports scrapers:

Actor	Description	Status
🏀 NBA Play-by-Play	Every play from every game	✅ Available
🏀 NBA Team Box Scores	Team statistics per game	✅ Available
🏀 NBA Player Box Scores	Player statistics per game (this actor)	✅ Available
🏀 NBA Schedule	Game schedules and matchups	🚧 Coming Soon
🏀 NCAA Play-by-Play	College basketball play-by-play	🚧 Coming Soon
🏀 NCAA Team Box Scores	College team statistics	🚧 Coming Soon
🏀 NCAA Player Box Scores	College player statistics	🚧 Coming Soon
🏒 NHL Play-by-Play	Hockey game events	🚧 Coming Soon
🏒 NHL Box Scores	Player & team statistics	🚧 Coming Soon
🏈 NFL Play-by-Play	Football play tracking	🚧 Coming Soon
🏈 NFL Box Scores	Player & team statistics	🚧 Coming Soon
⚾ MLB Play-by-Play	Baseball game events	🚧 Coming Soon
⚾ MLB Box Scores	Player & team statistics	🚧 Coming Soon

---

🤝 Support & Feedback

Found a bug? Want a new field? Have an idea?

• 🐛 Report issues in the actor comments
• 💡 Suggest features or enhancements
• 📊 Request additional fields or output tweaks

We read every message and aim to respond quickly.

---

Built with ❤️ and lots of ☕ for the sports analytics community