⚽ World Football Results Scraper

🚀 Export historical football match results for 50+ competitions in seconds. No login, no API key, just instant access to match data worldwide.

🕒 Last updated: 2026-05-22 · 📊 11 fields per record · 380+ matches per season · Global coverage

This actor scrapes historical football match results from worldfootball.net - one of the most comprehensive football statistics databases on the internet. Get structured match data including scores, dates, teams, and direct links to match reports for any major league or competition.

The data comes directly from worldfootball.net's public database, covering decades of football history across all major competitions.

Coverage

• 8 major competitions including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, Europa League, and FIFA World Cup
• 380+ matches per top-flight league season
• Full season history - scrape any season by changing the season parameter
• 11 structured fields per match record including scores, dates, team names, and match report URLs

Target Audience / Use Cases

Audience	Use Case
Sports analysts	Build performance databases and trend analysis
Betting researchers	Historical results for model training and verification
Journalists / bloggers	Quick access to verified historical match data
Data scientists	Football datasets for ML/AI research
Fantasy football managers	Historical team and match context
Developers	Populate apps with real football data

📋 What the World Football Scraper does

• Fetches all match results for a selected competition and season in one run
• Extracts home team, away team, final score, and match date
• Provides direct links to full match report pages on worldfootball.net
• Supports 8 major competitions across Europe and the world
• Handles redirects and modern HTML structure automatically
• Respects free/paid user limits with clear messaging

💡 Why it matters: worldfootball.net is one of the few sites with consistent historical coverage across all major leagues. This actor makes that data available in clean, structured JSON, CSV, or Excel format in seconds.

🎬 Full Demo

🚧 Coming soon

⚙️ Input

Field	Type	Required	Description
competition	Select	Yes	The competition to scrape (see options below)
season	String	No	Season in YYYY-YYYY format, default: 2023-2024
maxItems	Integer	No	Maximum number of matches to return

Competition options:

• eng-premier-league - Premier League (England)
• esp-primera-division - La Liga (Spain)
• bundesliga - Bundesliga (Germany)
• ita-serie-a - Serie A (Italy)
• fra-ligue-1 - Ligue 1 (France)
• champions-league - UEFA Champions League
• europa-league - UEFA Europa League
• world-cup - FIFA World Cup

Example - Premier League 2023-24:

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

Example - Champions League 2022-23:

{
    "competition": "champions-league",
    "season": "2022-2023"
}

⚠️ Good to Know: Season format must match the worldfootball.net convention (e.g. 2023-2024 not 23/24). Free users are limited to 10 results per run. Create a free account w/ $5 credit to unlock full datasets.

📊 Output

Field	Type	Description
📅 date	String	Match date in YYYY-MM-DD format
🏠 homeTeam	String	Full name of the home team
✈️ awayTeam	String	Full name of the away team
🔢 homeScore	Integer	Goals scored by the home team (null if not played)
🔢 awayScore	Integer	Goals scored by the away team (null if not played)
📊 result	String	Final score in "H-A" format, e.g. "3-0" (null if not played)
🏆 competition	String	Competition slug (e.g. eng-premier-league)
📆 season	String	Season string (e.g. 2023-2024)
🔗 url	String	Link to the full match report on worldfootball.net
🕒 scrapedAt	String	ISO 8601 timestamp of when the record was collected
❌ error	String	Error message if this record failed (always last)

Sample record:

{
    "date": "2023-08-11",
    "homeTeam": "Burnley FC",
    "awayTeam": "Manchester City",
    "homeScore": 0,
    "awayScore": 3,
    "result": "0-3",
    "competition": "eng-premier-league",
    "season": "2023-2024",
    "url": "https://www.worldfootball.net/match-report/co91/premier-league/ma9625838/burnley-fc_manchester-city/lineup/",
    "scrapedAt": "2026-05-22T10:00:00.000Z",
    "error": null
}

✨ Why choose this Actor

Feature	Benefit
🌍 Multi-competition support	8 major competitions including Champions League and World Cup
📅 Full season history	Scrape any season, not just the current one
⚡ Fast execution	Entire Premier League season (380 matches) in under 10 seconds
🔗 Match report links	Direct URLs to full match reports for deeper research
📦 Clean structured output	Ready for CSV, Excel, JSON, or direct API integration
🆓 Free tier available	10 matches free, no credit card required

📈 How it compares to alternatives

Feature	This Actor	Manual scraping	Football-data.org API
Setup time	Seconds	Hours	Minutes (needs API key)
Historical data	Yes	Depends	Limited in free tier
Competition variety	8 major competitions	Any (manual)	Limited
Output format	JSON/CSV/Excel/XML	Raw HTML	JSON only
Cost	Free tier + PPE	Free	Subscription

🚀 How to use

1. Create a free Apify account
2. Go to the actor page and click Try for free
3. Select your competition (e.g. Premier League)
4. Enter the season (e.g. 2023-2024)
5. Set maxItems if you want a partial dataset
6. Click Start and wait for results
7. Download as CSV, Excel, JSON, or XML

💼 Business use cases

Sports Analytics

Build historical databases to analyze team performance over seasons. Compare home vs away records, track goal-scoring trends, or identify patterns before upcoming fixtures.

Betting Research

Use historical match results as ground truth for building and validating predictive models. Cross-reference with odds data to find edges.

Media and Publishing

Journalists and bloggers can quickly pull verified historical results without manual research. Useful for "this day in football history" content or season reviews.

Application Development

Developers building football apps, dashboards, or fan tools can use this actor to seed databases with real historical match data across multiple competitions.

🔌 Automating World Football Scraper

Connect this actor to your favorite automation platform:

• Make (Integromat) - Schedule weekly runs to keep your football database current
• Zapier - Trigger downstream workflows when new results are collected
• Slack - Post match results summaries directly to your team channel
• Google Sheets - Auto-populate a spreadsheet with the latest results

🌟 Beyond business use cases

Research

Academic researchers studying sports economics, competitive balance, or home-field advantage can use this data as a clean baseline dataset across multiple leagues and seasons.

Personal Projects

Build your own football stats site, power a Discord bot with historical facts, or create visualizations of your favorite team's season trajectory.

Non-profit

Football coaching organizations can use historical data to prepare tactical analysis and scouting reports without manual data entry.

Experimentation

Data scientists can use multi-season, multi-league data to experiment with sports forecasting models, Elo rating systems, or machine learning classifiers.

🤖 Ask an AI assistant about this scraper

You can ask any AI assistant (ChatGPT, Claude, Gemini) questions like:

• "What does the worldfootball-net-scraper return?"
• "How do I get Bundesliga results for 2022-2023?"
• "What fields are available in the match output?"

❓ Frequently Asked Questions

❓ Which competitions are supported? Premier League, La Liga, Bundesliga, Serie A, Ligue 1, UEFA Champions League, UEFA Europa League, and FIFA World Cup.

❓ How many seasons can I scrape? Any season available on worldfootball.net. Simply change the season input parameter (e.g. 2020-2021).

❓ Does it include upcoming fixtures? Yes - matches not yet played will have null for scores and result.

❓ How fast is it? A full Premier League season (380 matches) typically completes in under 15 seconds.

❓ Is login required? No. This actor only accesses publicly available data.

❓ Can I scrape multiple competitions at once? Run one actor instance per competition, or use Apify's scheduling to run them sequentially.

❓ What format can I export the data in? JSON, CSV, Excel (XLSX), and XML are all available from the Apify dataset view.

❓ How do I get World Cup data? Set competition to world-cup. For the 2022 World Cup use season: 2022-2023.

❓ What if a competition isn't listed? The 8 listed competitions are the most popular. Additional competition support may be added in future versions.

❓ Are historical seasons available? Yes. worldfootball.net has data going back many decades for most major competitions.

❓ What does the url field link to? Each match URL links to the full match report on worldfootball.net, including lineups and match stats.

❓ Is the data real-time? The data reflects what worldfootball.net has at the time of the run. For in-progress matches, scores may be incomplete.

🔌 Integrate with any app

Export your dataset and connect it to:

• Google Sheets via Apify's Google Sheets integration
• Airtable via CSV import
• PostgreSQL / MySQL via JSON import
• Power BI via JSON connector
• Tableau via CSV
• Custom REST APIs via Apify webhooks

🔗 Recommended Actors

Actor	Description
Transfermarkt Scraper	Player valuations and transfer history
Sofascore Scraper	Live scores and statistics
FlashScore Scraper	Live match data and odds

💡 Pro Tip: browse the complete ParseForge collection for more sports and data scrapers built with the same quality standard.

---

🆘 Need Help? Open our contact form

⚠️ Disclaimer: This actor is an independent tool, not affiliated with, endorsed by, or sponsored by worldfootball.net. It accesses only publicly available data for informational and research purposes. Users are responsible for complying with worldfootball.net's terms of service and applicable laws.