FBref Soccer Stats Scraper

FBref Soccer Stats Scraper

Scrape FBref soccer stats for any player in a league and season, up to a million records per run. Get goals, assists, expected goals, progressive carries, and advanced metrics in one flat table. Export to CSV, JSON, Excel, or XML.

FBref is the deepest free source for soccer statistics, but copying tables by hand is slow and error-prone. This Actor reads the player stats table for a league and season you choose, from Premier League to Europa League, and returns every row in a consistent schema. No manual downloads, no formatting, the numbers you need.

Who uses it	What they scrape FBref for
Fantasy soccer players	Compare expected assists and shot-creating actions to find undervalued midfielders before a gameweek.
Data journalists	Pull a full season of player stats to build a transfer-market value story or a team-of-the-year interactive.
Scouts and analysts	Filter progressive passes and tackles in the attacking third to shortlist fullbacks for a recruitment report.
Academics and students	Gather a clean dataset for a sports analytics thesis or a machine learning model that predicts match outcomes.

What it does

This Actor collects FBref player statistics for a selected league and season and returns each player as a flat row with all available standard and advanced metrics.

• ⚽ League selector: Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, and Europa League.
• 📅 Season picker: any season FBref covers, entered as YYYY-YY (e.g. 2024-25).
• 📊 Full stat row: standard stats like goals and assists plus advanced metrics like xG, npxG, progressive carries, and pressures.
• 📦 Flat output: one row per player, ready for CSV, JSON, Excel, or XML export.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with FBref data

📈 Build a fantasy football model.

A fantasy player pulls expected goals and shot-creating actions for the 2024-25 Premier League to weight a draft algorithm.

📰 Power a data-driven article.

A journalist scrapes La Liga player stats to rank the most progressive passers and publish a mid-season analysis.

🔍 Scout undervalued talent.

An analyst collects Bundesliga defensive stats to identify centre-backs with high pressures and successful dribbles faced.

🎓 Feed academic research.

A student gathers five seasons of Serie A data to train a model that predicts player market value from on-ball actions.

Why choose this scraper

	What you get
No API key needed	Reads the public FBref pages directly, so you never register an app or manage tokens.
One fixed schema	Every run returns the same columns, even when FBref adds or renames stats mid-season.
Up to a million rows	Collect a single team or every player in a league without hitting rate limits.
CSV, JSON, Excel, XML	Download in the format your stack expects, no conversion scripts required.

How it compares

No other Store actor targets FBref the same way, so the honest comparison is with the alternatives teams actually weigh.

	FBref Soccer Stats Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When FBref changes	Maintained for you	You fix it	You re-learn the page
Proxies, retries, anti-bot	Built in	Your problem	Browser only
Output	Fixed JSON schema, CSV/Excel export	Whatever you build	Copy-paste
Cost	Pay per result	Engineering time	Analyst hours

Configure the run

Drive the Actor by picking a league and a season, and set a maximum record count to cap the run. The Input tab lists every parameter.

A first run with the defaults:

{
 "season": "2024-25",
 "maxItems": 20
}

A larger pull:

{
 "season": "2024-25",
 "maxItems": 200
}

Pricing

Pay-per-result: $0.021 per result collected. You pay only for the results written to your dataset.

Results collected	Approximate cost
100 results	$2.10
1,000 results	$21.00
10,000 results	$210.00

New Apify accounts start with $5 in free credit.

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the FBref Soccer Stats Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to FBref through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/fbref-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check that the season format is exactly YYYY-YY (e.g. 2024-25) and that FBref has data for that league and season. A typo or a future season will return an empty dataset.

The run failed with an error.

First, verify your league and season inputs. If they look correct, the FBref page structure may have changed. Check the Actor log for the failed URL and try again later, or report the issue.

Some columns are missing or empty.

FBref sometimes adds or removes stat columns between seasons. The Actor returns whatever columns are present on the page for that league and season. Missing columns mean FBref did not publish that stat for those players.

The dataset has fewer rows than I expected.

The Actor returns the players listed in the main stats table. Some leagues have multiple tables (e.g. standard stats vs. goalkeeping). The Actor targets the primary player stats table. If you need a different table, check the page URL and adjust your input.

FAQ

Question	Answer
Which leagues can I scrape?	The Actor supports Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, and Europa League. Pick one per run from the league dropdown.
How do I enter the season?	Type the season in YYYY-YY format, like 2024-25. The Actor uses that string to build the correct FBref URL for the season you want.
What stats are included?	You get every column from the standard player stats table on FBref: goals, assists, minutes, xG, npxG, progressive carries, pressures, and more. The exact columns depend on what FBref publishes for that league and season.
Can I scrape multiple leagues at once?	One run scrapes one league and one season. To collect multiple leagues, run the Actor once per league, either manually or by scheduling parallel runs.
Does this include goalkeeper stats?	Yes. The Actor returns all players in the table, including goalkeepers, with their specific stats like saves, clean sheets, and PSxG.
Is there a rate limit?	The Actor reads FBref politely and respects the site. You can collect up to a million records per run, which covers every player in a league many times over.
What output formats do I get?	Your dataset is available in CSV, JSON, Excel, and XML. Choose the format when you export from the Apify dataset tab.
Do I need an FBref account?	No. The Actor reads the public pages, so no login, API key, or account is required.
Can I get data from older seasons?	Yes. Enter any season FBref has in its archive, like 2017-18. The Actor will fetch the table for that season if it exists on the site.

Related actors

• transfermarkt-scraper: Use this when you need player market values and transfer rumors instead of on-pitch performance stats.

Browse the full ParseForge collection for more scrapers.

🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Sports Reference LLC. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.