FBref Scraper

Extract detailed football (soccer) statistics, player performance data, and league tables from FBref. Built on spider-browser .

Get started Docs

target
fbref.com: success rate
99.9%: latency
~4ms

POST /fetch/fbref.com/

return_format

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

200 OK · cache hit · response shape

{
  "url": "https://fbref.com/",
  "status": 200,
  "data": {
    "player_name": "string",
    "goals": "string",
    "assists": "string",
    "xg": "string",
    "team": "string",
    "minutes_played": "string",
    "league": "string"
  }
}

# FBref Scraper

**Player name**: string
**Goals**: string
**Assists**: string
**xG**: string
**Team**: string
**Minutes played**: string
**League**: string

Quick start

Extract data in minutes.

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

fbref-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://fbref.com/en/comps/9/stats/Premier-League-Stats");
await page.content();

const data = await page.evaluate(`(() => {
  const players = [];
  document.querySelectorAll("#stats_standard 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'] a")?.textContent?.trim();
    const goals = el.querySelector("td[data-stat='goals']")?.textContent?.trim();
    const assists = el.querySelector("td[data-stat='assists']")?.textContent?.trim();
    const xg = el.querySelector("td[data-stat='xg']")?.textContent?.trim();
    const minutes = el.querySelector("td[data-stat='minutes']")?.textContent?.trim();
    if (name) players.push({ name, team, goals, assists, xg, minutes });
  });
  return JSON.stringify({ total: players.length, players: players.slice(0, 15) });
})()`);

console.log(JSON.parse(data));
await spider.close();

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

import requests

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

const resp = await fetch("https://api.spider.cloud/fetch/fbref.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);