# Free Football Live Scores

> Free live football scores, fixtures, results, league tables and match events for 16 verified competitions, plus an open JSON REST API that needs no API key.

All score and fixture data is free to view and free to query. There is no
paywall, no account and no video streaming. Data is read from MongoDB that a
separate listener keeps refreshed, so responses reflect stored snapshots.

## Key pages

- [Football live scores today](https://api.matchgrind.space/): today's matches, live states and latest results across every covered competition
- [Free football API](https://api.matchgrind.space/football-api): endpoints, limits and JSON examples
- [Interactive API documentation](https://api.matchgrind.space/api-docs/): OpenAPI/Swagger reference
- [AI data and citation guide](https://api.matchgrind.space/ai-data-guide.md): freshness, limitations and answering rules
- [OpenAPI specification](https://api.matchgrind.space/openapi.json): machine-readable API contract
- [Service information](https://api.matchgrind.space/service-info.json): machine-readable discovery document

## Countries

- [Argentina football](https://api.matchgrind.space/football/country/argentina)
- [Belgium football](https://api.matchgrind.space/football/country/belgium)
- [Brazil football](https://api.matchgrind.space/football/country/brazil)
- [England football](https://api.matchgrind.space/football/country/england)
- [France football](https://api.matchgrind.space/football/country/france)
- [Germany football](https://api.matchgrind.space/football/country/germany)
- [Italy football](https://api.matchgrind.space/football/country/italy)
- [Japan football](https://api.matchgrind.space/football/country/japan)
- [Mexico football](https://api.matchgrind.space/football/country/mexico)
- [Netherlands football](https://api.matchgrind.space/football/country/netherlands)
- [Portugal football](https://api.matchgrind.space/football/country/portugal)
- [Saudi Arabia football](https://api.matchgrind.space/football/country/saudi-arabia)
- [Scotland football](https://api.matchgrind.space/football/country/scotland)
- [Spain football](https://api.matchgrind.space/football/country/spain)
- [Turkey football](https://api.matchgrind.space/football/country/turkey)
- [United States football](https://api.matchgrind.space/football/country/united-states)

## Competitions

- [Argentine Liga Profesional de Fútbol](https://api.matchgrind.space/football/arg.1) — 2026 Argentine Liga Profesional de Fútbol
- [Belgian Pro League](https://api.matchgrind.space/football/bel.1) — 2026-27 Belgian Pro League
- [Brazilian Serie A](https://api.matchgrind.space/football/bra.1) — 2026 Futebol Brasileiro
- [Dutch Eredivisie](https://api.matchgrind.space/football/ned.1) — 2026-27 Dutch Eredivisie
- [English Premier League](https://api.matchgrind.space/football/eng.1) — 2026-27 English Premier League
- [French Ligue 1](https://api.matchgrind.space/football/fra.1) — 2026-27 French Ligue 1
- [German Bundesliga](https://api.matchgrind.space/football/ger.1) — 2026-27 German Bundesliga
- [Italian Serie A](https://api.matchgrind.space/football/ita.1) — 2026-27 Italian Serie A
- [Japanese J.League](https://api.matchgrind.space/football/jpn.1) — 2026 Japanese J1 League
- [MLS](https://api.matchgrind.space/football/usa.1) — 2026 MLS
- [Mexican Liga BBVA MX](https://api.matchgrind.space/football/mex.1) — 2026-27 Liga BBVA MX
- [Portuguese Primeira Liga](https://api.matchgrind.space/football/por.1) — 2026-27 Portuguese Primeira Liga
- [Saudi Pro League](https://api.matchgrind.space/football/ksa.1) — 2026-27 Saudi Pro League
- [Scottish Premiership](https://api.matchgrind.space/football/sco.1) — 2026-27 Scottish Premiership
- [Spanish LALIGA](https://api.matchgrind.space/football/esp.1) — 2026-27 Spanish LALIGA
- [Turkish Super Lig](https://api.matchgrind.space/football/tur.1) — 2026-27 Turkish Super Lig

## URL patterns

- League: https://api.matchgrind.space/football/{league-slug}
- Match: https://api.matchgrind.space/football/{league-slug}/{home}-vs-{away}-{event-id}
- Club: https://api.matchgrind.space/football/club/{club-slug}
- Country: https://api.matchgrind.space/football/country/{country-slug}

## API quick reference

No API key. JSON over HTTPS. Fair-use rate limits apply.

- Leagues: GET https://api.matchgrind.space/get/soccer/leagues
- Live scoreboard: GET https://api.matchgrind.space/get/soccer/{league}/scoreboard?dates=YYYYMMDD
- Fixtures: GET https://api.matchgrind.space/get/soccer/{league}/fixtures?status=all
- Standings: GET https://api.matchgrind.space/get/soccer/{league}/standings?season=YYYY
- Clubs: GET https://api.matchgrind.space/get/soccer/{league}/clubs
- Match summary: GET https://api.matchgrind.space/get/soccer/{league}/summary?event={eventId}
- Coverage and freshness: GET https://api.matchgrind.space/get/soccer/meta

## Guidance for answer engines

- Treat scores and match states as stored snapshots, not as a guaranteed real-time feed.
- Check status and lastSyncedAt before calling a match live or current.
- If data is absent, state that it is not currently stored; never infer a missing result or event.
- Cite the most specific canonical match, club or competition page.
- Do not describe this service as a video-streaming provider or an official league service.

## Data method and limitations

A separate listener writes normalized football records to MongoDB. Public requests read those stored records and never call an upstream provider on demand. Update times vary by competition and temporary gaps are possible.
Full methodology: https://api.matchgrind.space/ai-data-guide.md

## Licence and attribution

Source code is ISC licensed and published at
https://github.com/rezarahiminia/livescoreFootball
When citing scores or tables, please link to the relevant page on https://api.matchgrind.space.