Skip to main content
AI Studio  add-on for Spider.
Sports & Fitness
basketball-reference.com Verified

Basketball Reference Scraper

Extract NBA player stats, team records, game logs, and historical basketball data from Basketball Reference. Built on spider-browser .

Get started Docs
target
basketball-reference.com
success rate
99.9%
latency
~4ms
POST /fetch/basketball-reference.com/
return_format
curl -X POST https://api.spider.cloud/fetch/basketball-reference.com/ \
  -H "Authorization: Bearer $SPIDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'
200 OK · cache hit · response shape
{
  "url": "https://basketball-reference.com/",
  "status": 200,
  "data": {
    "player_name": "string",
    "points_per_game": "string",
    "rebounds": "string",
    "assists": "string",
    "team": "string",
    "season": "string",
    "shooting": "string"
  }
}
Quick start

Extract data in minutes.

Structured JSON from basketball-reference.com with a single POST. AI-resolved selectors, cached on the first call.

basketball-reference-scraper.ts
import { SpiderBrowser } from "spider-browser";

const spider = new SpiderBrowser({
  apiKey: process.env.SPIDER_API_KEY!,
});

await spider.connect();
const page = spider.page!;
await page.goto("https://www.basketball-reference.com/leagues/NBA_2025_per_game.html");
await page.content();

const data = await page.evaluate(`(() => {
  const players = [];
  document.querySelectorAll("#per_game_stats tbody tr:not(.thead)").forEach(el => {
    const name = el.querySelector("td[data-stat='player'] a")?.textContent?.trim();
    const team = el.querySelector("td[data-stat='team_id'] a")?.textContent?.trim();
    const ppg = el.querySelector("td[data-stat='pts_per_g']")?.textContent?.trim();
    const rpg = el.querySelector("td[data-stat='trb_per_g']")?.textContent?.trim();
    const apg = el.querySelector("td[data-stat='ast_per_g']")?.textContent?.trim();
    if (name) players.push({ name, team, ppg, rpg, apg });
  });
  return JSON.stringify({ total: players.length, players: players.slice(0, 15) });
})()`);

console.log(JSON.parse(data));
await spider.close();
ready to run · spider-browser · TypeScript
Extraction

Fields you can pull.

Player namePoints per gameReboundsAssistsTeamSeasonShooting %
Data

Live scores & stats

Extract real-time scores, player stats, and standings from basketball-reference.com.

Rendering

Dynamic scoreboards

Full browser rendering for live-updating scoreboards and stat tables.

Scale

League coverage

Scrape across multiple leagues, seasons, and teams concurrently.

Related

More Sports & Fitness scrapers.

Start

Start scraping basketball-reference.com.

Grab an API key and call the endpoint above. The first request resolves the config; every request after hits cache.