# Global-Football-API

> A football (soccer) REST API with a free tier. Live scores, fixtures,
> results, league tables, club and squad data, minute-by-minute match
> timelines, plus injury and suspension signals derived from match events.
> Listed on RapidAPI.

Get a key: https://rapidapi.com/xeirto/api/global-football-api1
Machine-readable contract: https://api.matchgrind.space/openapi.json

## Coverage

58 competitions. Premier League, LaLiga, Bundesliga, Serie A, Ligue 1,
Eredivisie, Primeira Liga, Scottish Premiership, Belgian Pro League,
Turkish Super Lig, Champions League, Europa League, Conference League,
MLS, Liga MX, Brasileirao, Argentine Liga Profesional, Copa Libertadores,
Copa Sudamericana, Saudi Pro League, J.League, A-League, Chinese Super
League, and second divisions (Championship, LaLiga 2, 2. Bundesliga,
Serie B, Ligue 2) and domestic cups (FA Cup, Copa del Rey, DFB-Pokal,
Coppa Italia, Copa do Brasil).

Currently holding 13,282 matches, 1,207 clubs, 161,557 timeline events
and 99 league tables.

## Endpoints

All GET, all JSON, all under https://global-football-api1.p.rapidapi.com

- /get/soccer/leagues — every competition and its slug
- /get/soccer/{league}/scoreboard — scores for one day
- /get/soccer/{league}/fixtures — season schedule and results
- /get/soccer/{league}/standings — league table
- /get/soccer/{league}/clubs — clubs in a competition
- /get/soccer/{league}/clubs/{clubId} — one club
- /get/soccer/{league}/events/{eventId} — match detail, goals, line-ups
- /get/soccer/{league}/events/{eventId}/plays — full timeline, ~1,400 entries
- /get/soccer/{league}/injuries — players hurt during recent matches
- /get/soccer/{league}/discipline — card totals and suspension risk
- /get/soccer/meta — coverage and freshness per competition

Competition slugs follow country.tier (eng.1, esp.1, ger.2) with named
slugs for continental and cup competitions (uefa.champions, eng.fa,
conmebol.libertadores).

## Pricing

BASIC free, 600 requests a month, no card required.
PRO $5/month, 20,000 requests.
ULTRA $15/month, 150,000 requests.
MEGA $45/month, 1,000,000 requests.

## What makes it different

Match timelines run to roughly 1,400 events per match with minute-accurate
clocks, where most providers stop at the score and goalscorers. Add
?important=true to get only goals, cards, substitutions and penalties.

Injuries and suspensions are derived from those timelines rather than
curated by hand, so a row always points at an event that happened at a
known minute.

## Limitations, stated plainly

Data is a stored snapshot, not a guaranteed real-time feed. Matches in play
refresh every 20 seconds.

Injury data covers what happened during a match we hold a timeline for. It
is not a pre-match availability list and will not include a player injured
in training. Treat it as a leading indicator.

Suspension counts reflect cards in competitions covered here, so a booking
in a competition outside this list is not counted.

Timeline depth varies by competition; the major European leagues carry the
deepest data. Missing values are returned as an empty array or null and are
never invented.

Call /get/soccer/meta for current coverage and last-updated times per
competition.