🏀 NBA Team Box Score Scraper

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

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

---

🎯 What does this scraper do?

This actor extracts team-level box score 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

• ✅ 35+ fields per game - 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 team game returns 35+ 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
🎯 Scoring	Points for/against, margin, largest lead
🏹 Shooting	Field goals, 3-pointers, free throws (made/attempted/pct)
📦 Rebounds	Total, offensive, defensive
🤝 Playmaking	Assists, turnovers, assist-to-turnover ratio
🛡️ Defense	Steals, blocks
🚨 Fouls	Personal, technical, flagrant
👥 Opponent	Full opponent info and score

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

---

🚀 How to scrape NBA team box score data

Quick Start Guide

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

1. Create account — Sign up for a free Apify account
2. Open scraper — Go to NBA Team 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 Team 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": "Mavericks"
}

⚠️ 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 team game returns a clean, flat JSON object with 35+ fields. Field names are descriptive and grouped by prefix (game_, team_, score_, field_goals_, etc.) so you can quickly find what you need.

---

📖 Data Dictionary

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

Field	Type	Category	Description
game_id	string	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., "Dallas Mavericks")
team_abbreviation	string	Team	Team abbreviation (e.g., "DAL")
team_city	string	Team	Team city (e.g., "Dallas")
team_mascot	string	Team	Team mascot (e.g., "Mavericks")
team_id	string	Team	Unique team identifier
team_logo	string	Team	URL to team logo
team_venue	string	Team	Home or away
team_outcome	string	Team	Win or Loss
score_points_for	integer	Scoring	Points scored by team
score_points_against	integer	Scoring	Points scored by opponent
score_margin	integer	Scoring	Point differential (positive = win)
score_largest_lead	integer	Scoring	Largest lead during the game
field_goals_made	integer	Shooting	Field goals made
field_goals_attempted	integer	Shooting	Field goals attempted
field_goals_pct	number	Shooting	Field goal percentage (0-1 scale)
three_pointers_made	integer	Shooting	Three-pointers made
three_pointers_attempted	integer	Shooting	Three-pointers attempted
three_pointers_pct	number	Shooting	Three-point percentage (0-1 scale)
free_throws_made	integer	Shooting	Free throws made
free_throws_attempted	integer	Shooting	Free throws attempted
free_throws_pct	number	Shooting	Free throw percentage (0-1 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
turnovers_non_player	integer	Playmaking	Team turnovers (not attributed to players)
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	Fouls	Personal fouls
fouls_technical	integer	Fouls	Technical fouls
fouls_flagrant	integer	Fouls	Flagrant fouls
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_id	string	Opponent	Opponent team ID
opponent_logo	string	Opponent	URL to opponent logo
opponent_score	integer	Opponent	Opponent's final score

💡 Note: Shooting percentages are on a 0-1 scale. Multiply by 100 for traditional percentages. 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 (this actor)	✅ Available
🏀 NBA Player Box Scores	Player statistics per game	✅ 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