WorldFootball Results Scraper

WorldFootball Results Scraper

Scrape historical football match results from WorldFootball.net for major leagues. Get every fixture with scores, dates, and competition details for any season. No login or API key. Export to CSV, JSON, Excel, or XML.

WorldFootball.net holds decades of football results, but copying them by hand is slow and error-prone. This Actor reads the public match pages for the league and season you choose, and returns each fixture as one clean row. You get the data you need for analysis, betting models, or historical research without writing a single scraper.

Who uses it	What they scrape WorldFootball.net for
Sports data analysts	Build historical datasets of match outcomes for statistical modeling.
Football journalists	Gather season results quickly for match reports and league roundups.
Betting model developers	Collect past scores and dates to train predictive algorithms.
Fantasy football enthusiasts	Compile player and team performance data from past seasons.

What it does

This Actor collects football match results from WorldFootball.net for a selected competition and season, and returns each fixture as a flat row.

• ⚽ Competition selector: Choose from Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, Europa League, or World Cup.
• 📅 Season input: Specify any season using four-digit years, like 2023-2024 or 1998-1999.
• 🔢 Record limit: Set a maximum number of matches to collect per run, from 1 to 1,000,000.
• 📤 Flexible export: Download results as CSV, JSON, Excel, or XML for further processing.

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

What you can do with WorldFootball.net data

📊 Build a historical results database.

A data analyst scrapes every Premier League season from 2000 to 2024 to create a local database for trend analysis and reporting.

📈 Train a betting model.

A model developer collects past Bundesliga scores and dates to train a machine learning model that predicts match outcomes.

📝 Research a league's history.

A football journalist scrapes all World Cup results from 1998 to write a retrospective on tournament scoring patterns.

🏆 Compare team performance across seasons.

A fantasy football enthusiast gathers La Liga results for multiple seasons to compare team consistency and player impact.

Why choose this scraper

	What you get
No API key required	Access public match data without registration or authentication.
Historical depth	Scrape results from seasons as far back as WorldFootball.net provides.
Structured output	Each match is returned as a flat row with consistent fields for easy analysis.
Scalable collection	Collect up to a million records per run for large league datasets.

How it compares

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

	WorldFootball Results Scraper	Build it in-house	By hand
Setup	Run it now, zero config	Days of engineering	None, but hours per pull
When WorldFootball.net 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 selecting a competition and entering a season, and set a maximum record count to control the size of your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "competition": "eng-premier-league",
  "season": "2023-2024",
  "maxItems": 10
}

A larger pull:

{
  "competition": "eng-premier-league",
  "season": "2023-2024",
  "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 WorldFootball Results 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 WorldFootball.net 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/worldfootball-net-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 competition and season are correct. The season must be in the format YYYY-YYYY, like 2023-2024. Also ensure the season exists on WorldFootball.net for that competition.

The Actor returns fewer records than expected.

You may have set a maximum records limit that is lower than the total matches. Increase the maxItems value or remove the limit by setting it to a high number.

I get an error about invalid competition.

Select a competition from the provided list. The input must match one of the enum values exactly, such as 'eng-premier-league'.

The run takes too long.

Reduce the maximum records limit or choose a season with fewer matches. The Actor processes each match page, so large seasons can take time.

FAQ

Question	Answer
Which competitions can I scrape?	You can select from Premier League, La Liga, Bundesliga, Serie A, Ligue 1, UEFA Champions League, UEFA Europa League, and FIFA World Cup.
How do I specify the season?	Enter the season as four-digit years separated by a hyphen, for example 2023-2024 or 1998-1999. The Actor will scrape all matches for that season.
What data does each match record include?	Each record includes the match date, home team, away team, and final score, along with other details available on WorldFootball.net.
Is there a limit on how many matches I can scrape?	You can set a maximum number of records per run, from 1 to 1,000,000. The Actor will stop after collecting that many matches.
Do I need an API key or login?	No, the Actor reads public pages from WorldFootball.net directly, so no registration or authentication is required.
Can I export the data to Excel?	Yes, you can export the scraped results to CSV, JSON, Excel, or XML formats.
How far back can I scrape results?	You can scrape any season that is available on WorldFootball.net, which includes many decades of historical data.
What if a season has no matches?	If the season you entered is not available or has no results, the Actor will return an empty dataset. Check the season format and competition selection.
Can I scrape multiple competitions in one run?	No, each run scrapes one competition and one season. You can run the Actor multiple times with different inputs.
Is the data updated in real time?	The Actor scrapes the current data on WorldFootball.net at the time of the run. For live updates, schedule regular runs.

Related actors

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 Worldfootball.net. 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.