NBA Data Scraper

Scrape comprehensive NBA (National Basketball Association) data including teams, players, game schedules, and standings. Powered by TheSportsDB — a free, open sports data API requiring no registration or API key.

What This Actor Does

NBA Data Scraper gives you structured NBA data in seconds:

• All 30 NBA teams with arena info, founding year, colors, logos, and team descriptions
• Player rosters for any team — position, height, weight, college, nationality
• Game schedules for any season — home/away teams, scores, dates, venues
• League standings (when available) — wins, losses, points
• Player search — find any player by name across the league

Output Data

Each record contains fields depending on the mode:

Teams

Field	Description
teamId	TheSportsDB unique team identifier
teamName	Full team name (e.g. "Los Angeles Lakers")
shortName	Abbreviated team name (e.g. "LAL")
conference	NBA conference/division info
arena	Home arena name
arenaCapacity	Arena seating capacity
arenaLocation	Arena city and state
foundedYear	Year the team was established
description	Team history and overview
badgeUrl	Team badge/crest image URL
logoUrl	Team logo image URL
website	Official team website
primaryColor	Primary team color

Players

Field	Description
playerId	Unique player identifier
playerName	Full player name
team	Current team
position	Playing position (PG, SG, SF, PF, C)
nationality	Player nationality
height	Player height
weight	Player weight
birthDate	Date of birth
college	College attended
status	Active/Retired status
thumbUrl	Player thumbnail image

Events / Schedule

Field	Description
eventId	Unique game identifier
homeTeam	Home team name
awayTeam	Away team name
homeScore	Home team score
awayScore	Away team score
date	Game date (YYYY-MM-DD)
time	Game time
venue	Arena/venue name
season	Season identifier
status	Game status

Input Configuration

Parameter	Type	Description
mode	select	Data type to fetch (teams/players/schedule/standings/teamDetails/searchPlayers)
teamId	string	TheSportsDB team ID (e.g. "134880")
teamName	string	Team name for lookup (e.g. "Los Angeles Lakers")
season	string	Season year (e.g. "2023-2024" or "2024-25")
playerName	string	Player name for search
maxItems	integer	Maximum records to return (1–1000, default 50)

Example Uses

Get all NBA teams

{
  "mode": "teams",
  "maxItems": 30
}

Get Los Angeles Lakers roster

{
  "mode": "players",
  "teamName": "Los Angeles Lakers",
  "maxItems": 20
}

Get 2023-2024 season schedule

{
  "mode": "schedule",
  "season": "2023-2024",
  "maxItems": 200
}

Search for a player

{
  "mode": "searchPlayers",
  "playerName": "LeBron James"
}

Use Cases

• Fantasy basketball research — Get player stats, rosters, and team info
• Sports analytics — Build datasets for NBA statistics analysis
• Game prediction models — Historical game results and schedules
• Team comparison — Arena data, founding history, conference info
• Sports media — Automate NBA content with accurate team and player data
• Betting analysis — Historical scores and game outcomes

FAQ

Q: Is an API key required? A: No. This scraper uses TheSportsDB's free public API which requires no registration.

Q: How current is the data? A: TheSportsDB is updated regularly by community contributors. Player rosters may lag by a few weeks during active roster moves.

Q: How many teams are in the NBA? A: There are 30 NBA teams — 15 in the Eastern Conference and 15 in the Western Conference.

Q: What season format should I use? A: Use "2023-2024" for the 2023-24 season. The TheSportsDB API accepts both "2023-2024" and "2024-25" formats.

Q: Are standings available? A: Standings access depends on TheSportsDB API tier. If unavailable, the actor returns team records instead.

Q: Can I get historical game data? A: Yes, use mode=schedule with any past season (e.g. "2020-2021", "2021-2022", "2022-2023", "2023-2024").

Q: Can I filter games for a specific team? A: Yes, use mode=schedule with a teamId or teamName to filter results to a single team's games.