Sports & Fitness

Basketball Reference Scraper

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

Get Started Documentation

basketball-reference.com target

99.5% success rate

~4ms latency

Quick Start

Extract data in minutes

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

Fetch API

Structured data endpoint

Extract structured JSON from basketball-reference.com with a single POST request. AI-configured selectors, cached for fast repeat calls.

POST /fetch/basketball-reference.com/

Player namePoints per gameReboundsAssistsTeamSeason

Try it Fetch API Docs

curl

curl -X POST https://api.spider.cloud/fetch/basketball-reference.com/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"return_format": "json"}'

Python

import requests

resp = requests.post(
    "https://api.spider.cloud/fetch/basketball-reference.com/",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"return_format": "json"},
)
print(resp.json())

Node.js

const resp = await fetch("https://api.spider.cloud/fetch/basketball-reference.com/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ return_format: "json" }),
});
const data = await resp.json();
console.log(data);

Extraction