Soccer API
Also known as Football — same sport, same API endpoints (/api/football/...)
Live scores, fixtures, odds, standings, players, teams, and match events — delivered fast and reliably. Build apps, dashboards, betting tools, and analytics with developer‑friendly, scalable sports data.
Coverage
Global leagues and tournaments: Premier League, LaLiga, Serie A, Bundesliga, Ligue 1, UCL, UEL, MLS, international cups, domestic cups, and more.
Live data
Real‑time match events: goals, assists, cards, substitutions, VAR decisions, lineups, formations, and in‑play status with quick refresh.
Odds & markets
Pre‑match and in‑play odds across popular markets. Compare, track movements, and enrich betting tools and models.
Why choose our Soccer API
Our Soccer API is designed for performance, accuracy, and developer productivity. Whether you are building fan apps, score widgets, trading tools, or internal analytics, you get predictable response formats, consistent IDs, and robust coverage.
Key data sets
- Fixtures and schedules with status, venues, and referees
- Live scores and timelines with minute‑by‑minute events
- Teams, squads, coaches, formations, and season metadata
- Player profiles and performance stats per match and season
- Standings, group tables, playoffs, and tie‑break rules
- Odds (pre‑match and in‑play) with market and bookmaker metadata
- Head‑to‑head, recent form, and aggregated insights
Typical use cases
Clients use the API for consumer apps, media portals, scoreboards, betting analytics, and BI pipelines. The API fits both real‑time UIs and batch data jobs, with pagination, filtering, and time‑window controls.
Integration in minutes
Authenticate with your API key, call the endpoint, and parse the JSON. You can start in minutes and scale to millions of requests with caching and retries.
Authentication
All API requests require authentication using an API key. You can send the API key in one of three ways:
- HTTP Header (Recommended):
X-Api-Key: your_api_key_here - Query Parameter:
?api_key=your_api_key_here - Request Body:
{ "api_key": "your_api_key_here" }
Available endpoints
The Soccer/Football API provides comprehensive endpoints for all your data needs:
- /football/leagues — Get all active leagues with pagination
- /football/countries — Get all countries with football leagues
- /football/countries/{countryId}/leagues — Get leagues by country
- /football/leagues/{leagueId}/teams — Get teams in a league
- /football/teams/{teamId}/players — Get players by team
- /football/matches — Get matches by date range (max 200/page)
- /football/live — Get all live matches with events, lineups, statistics
- /football/live-odds — Get live odds for ongoing matches
- /football/pre-match-odds — Get pre-match odds (max 5 days range)
- /football/matches/{matchId}/details — Full match details with lineups, stats, VAR, comments
- /football/leagues/{leagueId}/standings — League standings (total, home, away)
- /football/leagues/{leagueId}/top-scorers — Top scorers by league
- /players/{playerId}/statistics — Player statistics by season
Example requests
Get all leagues
GET https://api.api4sports.com/api/football/leagues
Header: X-Api-Key: your_api_key_hereGet matches by date
GET https://api.api4sports.com/api/football/matches?from=2024-01-15&to=2024-01-20
Header: X-Api-Key: your_api_key_hereGet live matches
GET https://api.api4sports.com/api/football/live
Header: X-Api-Key: your_api_key_hereGet match details
GET https://api.api4sports.com/api/football/matches/{matchId}/details
Header: X-Api-Key: your_api_key_hereGet standings
GET https://api.api4sports.com/api/football/leagues/{leagueId}/standings?type=total
Header: X-Api-Key: your_api_key_hereGet live odds
GET https://api.api4sports.com/api/football/live-odds?league_id=207
Header: X-Api-Key: your_api_key_hereGet pre-match odds
GET https://api.api4sports.com/api/football/pre-match-odds?from=2024-01-15&to=2024-01-20
Header: X-Api-Key: your_api_key_hereGet player statistics
GET https://api.api4sports.com/api/players/{playerId}/statistics?season=2024
Header: X-Api-Key: your_api_key_hereError handling
The API uses standard HTTP status codes to indicate the success or failure of requests:
- 200 OK — Request successful
- 401 Unauthorized — API key is missing or invalid
- 403 Forbidden — No active plan or no access to this sport/league
- 404 Not Found — Resource not found
- 422 Unprocessable Entity — Validation failed (check parameters)
- 429 Too Many Requests — Daily request limit exceeded
Performance and reliability
Our infrastructure is tuned for low latency and high availability across regions. We apply intelligent caching, proactive monitoring, and data validation to ensure consistent quality. Rate limits scale with your plan; enterprise plans include dedicated throughput and priority support.
Frequently asked questions
Answers about the Soccer API coverage, data freshness, and usage
Fixtures, live scores, match events, odds, standings, player stats, team info, lineups, head‑to‑head, and more.
Live match events are ingested in near real‑time with quick refresh; typical latency is seconds.
Premier League, LaLiga, Serie A, Bundesliga, Ligue 1, UCL, UEL, MLS, international competitions, and more.
Yes. Commercial use is allowed per your selected plan. Enterprise agreements are available.
Still have questions?
Our support team is ready to help you get started. Reach out and we'll respond within hours.