Overview
Football-Data API offers structured football data including match schedules, live scores, team rosters, and competition tables for major European leagues. A free tier is available with limited endpoints, making it easy to prototype without a paid plan. Authentication uses an API token sent as a request header.
Beginner Tip
The free tier restricts access to a subset of competitions - check the documentation Tier column to see which leagues are available before building your app.
Available Data
The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.
Example Response
Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.
{
"match_id": 4521,
"home_team": "Team A",
"away_team": "Team B",
"score": {
"home": 2,
"away": 1
},
"status": "Full Time",
"date": "2025-01-15",
"league": "Premier League"
} Field Reference
competition.name Name of the football competition (e.g., Premier League) utcDate Match date and time in UTC ISO 8601 format status Match status: SCHEDULED, IN_PLAY, PAUSED, FINISHED, or CANCELLED homeTeam.name Name of the home team awayTeam.name Name of the away team score.fullTime Final score with home and away goals after 90 minutes Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://api.football-data.org/v4/competitions/PL/matches?status=SCHEDULED";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
headers: {
"X-API-Key": "YOUR_API_KEY"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.
Metadata Score Breakdown
Estimated from metadata — endpoint not independently tested
Metadata estimate · endpoint not independently tested
Technical Specifications
Related Tags
Similar APIs
View All →Football
Football API on RapidAPI provides squad statistics, top scorers, and match data for football (soccer) leagues around the world.
API-FOOTBALL
⭐ Beginner's PickAPI-FOOTBALL provides comprehensive data on football (soccer) leagues, teams, fixtures, live scores, and player statistics from competitions worldwide.
balldontlie
⭐ Beginner's Pickballdontlie is a completely free, no-auth-required API that provides NBA basketball statistics including player data, team information, game scores, and season averages.
Football Standings
⭐ Beginner's PickFootball Standings API provides current league standings for popular football competitions like the EPL, La Liga, and Serie A, sourced from ESPN.
Oddsmagnet
Oddsmagnet provides historical betting odds data from multiple UK bookmakers, letting you track how odds have changed over time for various sports events.