FBref Football Statistics Scraper avatar

FBref Football Statistics Scraper

Pricing

from $3.00 / 1,000 results

Go to Apify Store
FBref Football Statistics Scraper

FBref Football Statistics Scraper

Scrape FBref (fbref.com) - the Football Reference site. Get league stats, match results, and player statistics for Premier League, La Liga, Bundesliga, Serie A, and Ligue 1.

Pricing

from $3.00 / 1,000 results

Rating

0.0

(0)

Developer

Crawler Bros

Crawler Bros

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

Share

Scrape player statistics, match results, and league tables from FBref (fbref.com) — the most comprehensive football statistics database, covering all major European leagues.

What This Actor Does

Fetches football data from FBref including:

  • League Stats: All player stats for a full season (goals, assists, xG, minutes played, pass completion, cards)
  • Match Results: Fixture results with scores, xG, venues, attendance, and referees
  • Player Stats: Career statistics by season for any FBref player

Supported Leagues

LeagueCountry
Premier LeagueEngland
La LigaSpain
BundesligaGermany
Serie AItaly
Ligue 1France

Input

FieldTypeDescription
modestringleagueStats, matchResults, or playerStats
leaguestringLeague slug (e.g. premier-league, bundesliga)
seasonstringSeason in FBref format, e.g. 2024-2025
playerNamestringPlayer name for playerStats mode (e.g. Erling Haaland)
maxItemsintegerMax records to return (default: 10)

Example Input

{
"mode": "leagueStats",
"league": "premier-league",
"season": "2024-2025",
"maxItems": 10
}

Output

Each record contains:

FieldDescription
playerIdFBref player ID
playerNamePlayer's full name
teamCurrent club
positionPlaying position
leagueLeague name
seasonSeason string
appearancesMatches played
goalsGoals scored
assistsAssists
yellowCardsYellow cards
redCardsRed cards
minutesPlayedTotal minutes on pitch
passCompletionPass completion percentage
xgExpected goals
xgaExpected goal assists
playerUrlLink to player's FBref page

Example Output

{
"playerName": "Erling Haaland",
"team": "Manchester City",
"position": "FW",
"league": "Premier League",
"season": "2024-2025",
"appearances": 28,
"goals": 22,
"assists": 5,
"xg": 19.8,
"minutesPlayed": 2340,
"playerUrl": "https://fbref.com/en/players/..."
}

FAQs

Is this free to use? Yes. FBref is a publicly accessible website and this actor uses standard HTTP requests without any paid proxies or API keys.

How fresh is the data? Data is scraped live from FBref on each run. FBref typically updates stats within 24-48 hours of matches.

Why might some stats be missing? FBref only shows xG/xGA for the Big 5 leagues. Some older seasons may have fewer advanced stats.

Can I get historical seasons? Yes — set the season field to any past season like 2020-2021.

What is the daily test prefill? The actor's default test runs leagueStats for Premier League 2024-2025 with maxItems=10, which should always return data during an active season.