Overview
API-FOOTBALL provides comprehensive data on football (soccer) leagues, teams, fixtures, live scores, and player statistics from competitions worldwide. You authenticate with an API key in the request header, and the free tier gives you 100 requests per day, making it ideal for small projects or prototyping. It is one of the most complete football data APIs available for building sports apps and dashboards.
Beginner Tip
Sign up at dashboard.api-football.com to get your free API key (100 requests/day); always include the league ID and season (e.g., 2024) as query parameters — without them, most endpoints return empty results.
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
response Array of result objects such as fixtures, teams, or players. response[].fixture.id Unique identifier for the match fixture. response[].fixture.date ISO 8601 date and time of the match in UTC. response[].teams.home.name Name of the home team. response[].teams.away.name Name of the away team. response[].goals.home Number of goals scored by the home team; null if the match has not started. Implementation Example
Calls a real endpoint of this API. Replace any placeholder credentials with your own key.
const url = "https://v3.football.api-sports.io/fixtures?league=39&season=2024&next=5";
// 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 →Cloudbet
Cloudbet API lets you access real-time sports odds and place bets programmatically on a wide range of sports events.
CollegeFootballData.com
⭐ Beginner's PickCollegeFootballData.com API provides detailed statistics, scores, and historical records for American college football (NCAA).
JCDecaux Bike
⭐ Beginner's PickJCDecaux Bike API gives you real-time availability data for JCDecaux self-service bicycle stations across 40+ cities 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.