API-FOOTBALL API

Beginner's Pick Sports & Fitness / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)

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

match scores and results
team standings
player statistics
schedule and fixtures

Example Response

JSON 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

Request
const url = "https://www.api-football.com/documentation-v3";
// 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

403 Forbidden The API key is missing from the x-apisports-key header or is invalid.
Add the header x-apisports-key: YOUR_API_KEY to every request; do not put the key in the URL.
Empty results array The league ID or season year does not match any available data.
Use the /leagues endpoint first to find valid league IDs and available seasons for your target competition.
429 Too Many Requests You have exceeded your daily request quota (100/day on the free plan).
Cache API responses locally and upgrade your plan if you need more than 100 requests per day.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Sports & Fitness
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →