FBref Soccer Stats Scraper
Pricing
from $19.00 / 1,000 results
FBref Soccer Stats Scraper
Scrapes FBref player statistics by league and season. Returns one flat row per player with goals, assists, expected goals, progressive carries, and all available advanced metrics.
Pricing
from $19.00 / 1,000 results
Rating
0.0
(0)
Developer
ParseForge
Maintained by CommunityActor stats
1
Bookmarked
62
Total users
9
Monthly active users
3 days ago
Last modified
Share
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
- Create a free Apify account with $5 in credit.
- Open the FBref Soccer Stats Scraper.
- Set your inputs and any filters, then click Start.
- 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.
