Football-Data.org Competitions Scraper

Football-Data.org Competitions Scraper

Scrape football competitions, standings, matches, and team data from Football-Data.org. Get league tables, season fixtures, and team profiles in clean JSON, CSV, Excel, or XML. No login required for the free tier.

Football-Data.org's official API needs an API key and rate limits you. This Actor reads the public competition catalog, league tables, season fixtures, team profiles, and single match records directly, and returns each one in a fixed schema. Filter by competition code, season, team ID, or match ID.

Who uses it	What they scrape Football-Data.org for
Sports analysts	Which competitions are available and their current standings
Betting researchers	Season fixtures and match results for a league
Fantasy football players	Team profiles and player data for a specific team
Data journalists	Historical match data for a competition
App developers	Live standings and fixtures for a football app

What it does

This Actor collects football competitions, standings, matches, team profiles, and single match records from Football-Data.org and returns each one as a flat row.

• 📋 Competitions catalog: list all competitions with area, name, and season info.
• 🏆 Standings: league table for a competition and season, with position, points, and goal difference.
• 📅 Matches: all fixtures for a competition and season, with scores, status, and matchday.
• 👥 Team profile: details for a single team, including squad, coach, and venue.
• ⚽ Single match: full record for one match, including lineups, goals, and bookings.

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

What you can do with Football-Data.org data

📊 Track league standings.

A sports analyst runs the Actor in standings mode for the Premier League, season 2024, to get the current table and feed it into a weekly report.

📅 Build a fixture calendar.

A betting researcher collects all matches for the Champions League, season 2024, to analyze upcoming odds and past results.

👥 Monitor team changes.

A fantasy football player pulls the team profile for Manchester City to see the current squad and coach before making transfers.

⚽ Analyze a single match.

A data journalist retrieves a specific match record to verify lineups and goal scorers for an article.

🌍 Compare competitions.

An app developer lists all competitions to populate a dropdown menu in a football app.

Why choose this scraper

	What you get
No API key needed	Runs on the free tier without registration
Five data modes	Competitions, standings, matches, team, and match
Fixed schema	Every record returns the same flat structure
Export anywhere	JSON, CSV, Excel, or XML
Rate limit friendly	Optional auth token for higher limits

How it compares

This Actor offers five data modes and optional auth, while the competitors focus on narrower use cases.

Feature	ParseForge	Football Fixtures Api	Football Data Competitions Scraper
Competitions catalog	Yes	Not listed	Yes
Standings (league table)	Yes	Not listed	Not listed
Matches (season fixtures)	Yes	Yes	Not listed
Team profile	Yes	Not listed	Not listed
Single match record	Yes	Not listed	Not listed
Optional auth token	Yes	Not listed	Not listed

Configure the run

Drive the Actor from competition codes, seasons, team IDs, match IDs, and area filters, alone or together, and filters run as each record is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

{
  "maxItems": 10,
  "mode": "competitions",
  "competitionCode": "PL"
}

A larger pull:

{
  "maxItems": 200,
  "mode": "competitions",
  "competitionCode": "PL"
}

Pricing

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

Results collected	Approximate cost
100 results	$2.00
1,000 results	$20.00
10,000 results	$200.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 Football-Data.org Competitions 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 Football-Data.org 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/football-data-org-competitions-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 you have selected the correct mode and provided the required inputs. For standings and matches, you need a competition code. For team and match modes, you need the respective ID.

Why do I get a 403 error?

You may have hit the rate limit. Wait a minute and try again, or provide your own auth token for higher limits.

Why is the season parameter not working?

The season parameter expects the starting year as a string, e.g. '2024' for the 2024/25 season. Make sure you are using the correct format.

How do I find a team ID?

You can use the competitions mode to list competitions, then use the standings or matches mode to find team IDs in the response. Alternatively, check the Football-Data.org documentation.

Why is my auth token not accepted?

Make sure you have copied the token correctly and that it is active. The token is optional and only needed for higher rate limits or restricted competitions.

FAQ

Question	Answer
Do I need an API key?	No, the Actor runs on the free tier without an auth token. You can optionally provide your own token for higher rate limits and access to restricted competitions.
What competitions are supported?	The Actor supports all competitions available on Football-Data.org, including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, Europa League, World Cup, and more.
How do I get standings for a league?	Set mode to 'Standings', choose a competition code like PL for Premier League, and optionally specify a season. The Actor returns the league table.
Can I get fixtures for a whole season?	Yes, set mode to 'Matches', choose a competition code and season, and the Actor returns all fixtures for that season.
How do I get data for a specific team?	Set mode to 'Team' and provide the numeric team ID. Example: 65 for Manchester City, 81 for Barcelona.
Can I get a single match record?	Yes, set mode to 'Match' and provide the numeric match ID.
What output formats are supported?	The Actor exports data as JSON, CSV, Excel, or XML, depending on your Apify dataset settings.
Is there a rate limit?	The free tier has a rate limit of 10 requests per minute. With your own auth token, the limit is higher.
Can I filter competitions by area?	Yes, in competitions mode you can provide comma-separated area IDs to filter results.
What is the maximum number of items I can collect?	You can set maxItems up to 1,000,000 per run.

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 Football-Data.org. 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.