⚽ OpenLigaDB Football Matches Scraper

🚀 Export the German football archive in seconds. Pull Bundesliga, DFB-Pokal, UEFA Champions League, Euros, and World Cup fixtures, results, goals, and standings. No API key, no login, no manual ETL.

🕒 Last updated: 2026-05-23 · 📊 19 fields per record · ⚽ 10+ competitions · 🌍 German + international football · 🏆 Matches, leagues, tables

The OpenLigaDB Football Matches Scraper taps the community-maintained openligadb.de dataset and returns clean, structured records covering match schedules, halftime and full-time scores, goal scorers, attendance, league standings, and competition catalogs. The project has powered German football apps, fantasy leagues, and analytics dashboards since 2009.

Coverage spans Bundesliga 1, 2, and 3, DFB-Pokal, UEFA Champions League, UEFA Nations League, UEFA Euros, FIFA World Cup, and historic seasons going back to the late 2000s. This Actor exports them as CSV, Excel, JSON, or XML in under a minute, with three query modes (matches, leagues, table) running off the same scraper.

🎯 Target Audience	💡 Primary Use Cases
Football analytics teams, fantasy football platforms, sports media, betting researchers, club ops, fan apps, sports data scientists	Match data exports, league standings sync, fixture calendars, goal-scorer leaderboards, season retrospectives, ML training sets

---

📋 What the OpenLigaDB Scraper does

Three workflows in a single Actor:

• 📅 Matches mode. Full schedule and results for a league + season, including kickoff times, halftime + final scores, goal scorers, penalties, own goals, overtime, attendance, and venue.
• 🏆 Leagues mode. Catalog of every competition openligadb covers, with league ID, shortcut, season, and sport.
• 📊 Table mode. Live league standings with points, wins, draws, losses, goals for, goals against, and goal difference.

Each match record includes both teams (ID, name, short name, crest), per-minute goals, and metadata like attendance, location, and last update timestamp.

💡 Why it matters: building your own football pipeline means writing parsers, handling i18n, and refreshing schedules every gameweek. This Actor turns that into a one-click run that drops a ready-to-load dataset into your warehouse.

---

🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded match dataset.

---

⚙️ Input

Input	Type	Default	Behavior
maxItems	integer	10	Records to return. Free plan caps at 10, paid plan at 1,000,000.
mode	string	"matches"	One of matches, leagues, table.
league	string	"bl1"	Competition shortcut. bl1 = Bundesliga 1, bl2, bl3, dfb, ucl24, em, wm2022, uefanl2425, fem08, ucl1112.
season	string	"2024"	Season starting year. "2024" means the 2024/25 season.

Example: full Bundesliga 1 schedule + results for 2024/25.

{
    "maxItems": 50,
    "mode": "matches",
    "league": "bl1",
    "season": "2024"
}

Example: current Bundesliga 2 league table.

{
    "maxItems": 18,
    "mode": "table",
    "league": "bl2",
    "season": "2024"
}

⚠️ Good to Know: openligadb is community-edited, so a small number of recent fixtures may have provisional scores or pending kickoff times. For broadcast-grade data, cross-check with the official competition feed before publishing.

---

📊 Output

Each record contains up to 19 fields. Download the dataset as CSV, Excel, JSON, or XML.

🧾 Schema

Field	Type	Example
🆔 matchId	integer	64637
🏆 leagueShortcut	string	"bl1"
🏆 leagueName	string	"1. Fußball-Bundesliga 2024/2025"
📅 matchDateUtc	ISO 8601	"2024-08-23T18:30:00Z"
👥 team1	object	{ teamId, teamName, shortName, teamIconUrl }
👥 team2	object	{ teamId, teamName, shortName, teamIconUrl }
🥅 score	string | null	"3-2"
🥅 scoreHalftime	string | null	"1-1"
✅ matchFinished	boolean	true
⚽ goals	array	[{ minute, scorer, isPenalty, isOwnGoal }]
📍 location	object | null	{ locationCity, locationStadium }
👨‍👩‍👧 numberOfViewers	integer | null	75000
🏷️ groupName	string | null	"1. Spieltag"
🆔 leagueId	integer | null	4422
📅 leagueSeason	integer	2024
🕒 lastUpdate	ISO 8601 | null	"2024-08-24T07:14:00"
🏷️ recordType	string	"match"
🕒 scrapedAt	ISO 8601	"2026-05-23T00:00:00.000Z"

📦 Sample records

---

✨ Why choose this Actor

	Capability
⚽	Real match data. Goals, scorers, kickoff times, attendance, halftime scores, and venue per match.
🏆	10+ competitions. Bundesliga 1/2/3, DFB-Pokal, Champions League, Euros, World Cup, Nations League, plus historic seasons.
📊	Three modes. Matches, league catalog, and live standings from a single Actor.
⚡	Fast. 100 matches in under 10 seconds.
🌐	Community-trusted source. openligadb has powered German football apps for over 15 years.
🔁	Always fresh. Every run pulls the latest community-edited data.
🚫	No authentication. Public dataset, no API key, no login.

📊 Football operations, fantasy platforms, and sports media all depend on accurate match metadata. This Actor delivers it in seconds.

---

📈 How it compares to alternatives

Approach	Cost	Coverage	Refresh	Filters	Setup
⭐ OpenLigaDB Scraper (this Actor)	$5 free credit, then pay-per-use	10+ competitions, multi-season	Live per run	league, season, mode	⚡ 2 min
Commercial sports data feeds	$500+/month	Global, live	Streaming	Many	🐢 Days
Manual scraping of league sites	Free	Per-site	Manual	Per-site	🐌 Weeks
Legacy CSV exports	Free	Limited	Stale	None	🕒 Variable

Pick this Actor when you want German + UEFA football coverage with goal-level detail and zero auth overhead.

---

🚀 How to use

1. 📝 Sign up. Create a free account with $5 credit (takes 2 minutes).
2. 🌐 Open the Actor. Go to the OpenLigaDB Football Matches Scraper page on the Apify Store.
3. 🎯 Set input. Pick a mode (matches / table / leagues), pick a league shortcut, and set maxItems.
4. 🚀 Run it. Click Start and let the Actor collect your data.
5. 📥 Download. Grab your results in the Dataset tab as CSV, Excel, JSON, or XML.

⏱️ Total time from signup to downloaded dataset: 3-5 minutes. No coding required.

---

💼 Business use cases

⚽ Football Analytics & Scouting Goal-scorer leaderboards across seasons Halftime vs full-time score deltas for tactical reports Attendance trend analysis per club Custom xG model inputs from per-minute goal data	🎮 Fantasy Football & Apps Auto-sync fixtures and results into mobile apps Real-time goal updates for fantasy point engines League table widgets for fan sites Player and team logos via team icon URLs
📰 Sports Media & Editorial Auto-publish match recap data into CMS Season-long stats for end-of-year features Historic season comparison stories Multi-competition coverage for German + UEFA beats	📊 Betting Research & Modeling Backtest models against historic Bundesliga seasons Calibrate odds with halftime + full-time markets Track form trends from goal differential Compare league tables across seasons

---

🔌 Automating OpenLigaDB Scraper

Control the scraper programmatically for scheduled runs and pipeline integrations:

• 🟢 Node.js. Install the apify-client NPM package.
• 🐍 Python. Use the apify-client PyPI package.
• 📚 See the Apify API documentation for full details.

The Apify Schedules feature lets you trigger this Actor on any cron interval. Refresh the league table every Monday morning, or pull matchday results every Saturday evening.

---

🌟 Beyond business use cases

Structured football data feeds research, classrooms, civic projects, and fan creativity.

🎓 Research and academia Match data for sports analytics coursework Historical season studies for journalism school Reproducible datasets for ML class projects Open-data exercises on European football	🎨 Personal and creative Fantasy league spreadsheets and trackers Personal Bundesliga dashboards Goal-of-the-month video research Fan blog data tables and infographics
🤝 Non-profit and civic Youth football outreach programs with regional clubs Community fan club newsletters Open historical archives of German football Cultural studies of regional football traditions	🧪 Experimentation Train goal-prediction or upset-detection ML models Prototype agent pipelines that summarize gameweeks Build a personal "did Leverkusen win?" Slack bot Test data warehouse loaders on football schemas

---

🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

---

❓ Frequently Asked Questions

🧩 How does it work?

Pick a competition (Bundesliga 1, DFB-Pokal, Champions League, etc.) and a season, choose a mode (matches, leagues, or table), and the Actor returns one record per match, league, or standings row. No browser automation, no captchas.

📏 How accurate is the data?

Match results, kickoff times, and league standings are typically accurate within minutes of the official scoreboard. Goal scorer attributions are community-edited, so a small number of recent fixtures may include provisional values until reviewers confirm.

🔁 How often is the dataset refreshed?

Live during gameweeks. Every run pulls the latest data, so refreshing every 10 minutes during a matchday gives you near-live scores.

🏆 Which competitions are covered?

Bundesliga 1, 2, and 3, DFB-Pokal, UEFA Champions League, UEFA Euros, FIFA World Cup, UEFA Nations League, and historic seasons. Use Leagues mode to pull the full catalog.

⏰ Can I schedule regular runs?

Yes. Use Apify Schedules to trigger this Actor on any cron interval. Pull the league table after every gameweek and pipe it straight into your dashboard.

⚖️ Is this data legal to use?

The openligadb dataset is publicly available and community-maintained. Review the downstream terms of your specific use case, but raw match metadata is generally public domain.

💼 Can I use this data commercially?

Yes for analytical and editorial use. Team crests and logos belong to their respective clubs, so check brand usage rules before redistributing them.

💳 Do I need a paid Apify plan?

No. The free plan handles testing and small runs (10 records). Paid plans lift the cap and unlock scheduling and higher concurrency.

🔁 What happens if a run fails?

Apify retries transient errors automatically. Failed runs preserve partial datasets so no progress is lost. Re-run after fixing input.

🛬 What if I need player stats or rosters?

This Actor returns match-level, league-level, and standings data. For player-level rosters, request a companion scraper via the contact form below.

🆘 What if I need help?

Reach our support team through the Apify platform or the Tally form linked below.

---

🔌 Integrate with any app

OpenLigaDB Football Matches Scraper connects to any cloud service via Apify integrations:

• Make - Automate multi-step workflows
• Zapier - Connect with 5,000+ apps
• Slack - Get matchday alerts in your channels
• Airbyte - Pipe match data into your warehouse
• GitHub - Trigger runs from commits and releases
• Google Drive - Export datasets straight to Sheets

You can also use webhooks to trigger downstream actions when a run finishes. Push fresh fixtures into your product backend, or alert your fan club Slack on the final whistle.

---

🔗 Recommended Actors

• 🏆 Football-Data.org Competitions Scraper - Premier League, La Liga, Serie A, and more
• 🎮 Liquipedia Esports Wiki Scraper - Tournament + team data across 10 esports
• 📺 IMDb Scraper - Movie, TV, and entertainment metadata
• 📈 Indexmundi Scraper - Global demographic and economic indicators
• 🗺️ Nominatim OSM Scraper - Geocode stadium addresses via OpenStreetMap

💡 Pro Tip: browse the complete ParseForge collection for more reference-data scrapers.

---

🆘 Need Help? Open our contact form to request a new scraper, propose a custom data project, or report an issue.

---

⚠️ Disclaimer: this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by OpenLigaDB, the Deutsche Fußball Liga, UEFA, FIFA, or any football competition. All trademarks mentioned are the property of their respective owners. Only publicly available open football data is collected.