# Free Football Live Scores

> Free live football scores, fixtures, results, league tables and match events for 33 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://worldcup26.ir/): today's matches, live states and latest results across every covered competition
- [Free football API](https://worldcup26.ir/football-api): endpoints, limits and JSON examples
- [Interactive API documentation](https://worldcup26.ir/api-docs/): OpenAPI/Swagger reference
- [AI data and citation guide](https://worldcup26.ir/ai-data-guide.md): freshness, limitations and answering rules
- [OpenAPI specification](https://worldcup26.ir/openapi.json): machine-readable API contract
- [Service information](https://worldcup26.ir/service-info.json): machine-readable discovery document

## Countries

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

## Competitions

- [English Premier League](https://worldcup26.ir/football/eng.1) — 2026-27 English Premier League
- [English League Championship](https://worldcup26.ir/football/eng.2) — 2026-27 English League Championship
- [English League One](https://worldcup26.ir/football/eng.3) — 2026-27 English League One
- [English League Two](https://worldcup26.ir/football/eng.4) — 2026-27 English League Two
- [English National League](https://worldcup26.ir/football/eng.5) — 2026-27 English National League
- [English FA Cup](https://worldcup26.ir/football/eng.fa) — 2025-26 English FA Cup
- [English Carabao Cup](https://worldcup26.ir/football/eng.league_cup) — 2026-27 English Carabao Cup
- [English EFL Trophy](https://worldcup26.ir/football/eng.trophy) — 2026-27 EFL Trophy
- [English FA Community Shield](https://worldcup26.ir/football/eng.charity) — 2026 English FA Community Shield
- [English Women's Super League](https://worldcup26.ir/football/eng.w.1) — 2026-27 English Women's Super League
- [English Women's FA Cup](https://worldcup26.ir/football/eng.w.fa) — 2025-26 English Women's FA Cup
- [Spanish LALIGA](https://worldcup26.ir/football/esp.1) — 2026-27 Spanish LALIGA
- [Spanish LALIGA 2](https://worldcup26.ir/football/esp.2) — 2026-27 Spanish LALIGA 2
- [Spanish Copa del Rey](https://worldcup26.ir/football/esp.copa_del_rey) — 2026-27 Spanish Copa del Rey
- [Spanish Supercopa](https://worldcup26.ir/football/esp.super_cup) — 2026-27 Spanish Supercopa
- [Trofeo Joan Gamper](https://worldcup26.ir/football/esp.joan_gamper) — 2026 Trofeo Joan Gamper
- [Spanish Liga F](https://worldcup26.ir/football/esp.w.1) — 2026-27 Spanish Liga F
- [Spanish Copa de la Reina](https://worldcup26.ir/football/esp.copa_de_la_reina) — 2026-27 Spanish Copa de la Reina
- [German Bundesliga](https://worldcup26.ir/football/ger.1) — 2026-27 German Bundesliga
- [Italian Serie A](https://worldcup26.ir/football/ita.1) — 2026-27 Italian Serie A
- [French Ligue 1](https://worldcup26.ir/football/fra.1) — 2026-27 French Ligue 1
- [Dutch Eredivisie](https://worldcup26.ir/football/ned.1) — 2026-27 Dutch Eredivisie
- [Scottish Premiership](https://worldcup26.ir/football/sco.1) — 2026-27 Scottish Premiership
- [Portuguese Primeira Liga](https://worldcup26.ir/football/por.1) — 2026-27 Portuguese Primeira Liga
- [Belgian Pro League](https://worldcup26.ir/football/bel.1) — 2026-27 Belgian Pro League
- [Austrian Bundesliga](https://worldcup26.ir/football/aut.1) — 2026-27 Austrian Bundesliga
- [Turkish Super Lig](https://worldcup26.ir/football/tur.1) — 2026-27 Turkish Super Lig
- [MLS](https://worldcup26.ir/football/usa.1) — 2026 MLS
- [Mexican Liga BBVA MX](https://worldcup26.ir/football/mex.1) — 2026-27 Liga BBVA MX
- [Argentine Liga Profesional de Fútbol](https://worldcup26.ir/football/arg.1) — 2026 Argentine Liga Profesional de Fútbol
- [Brazilian Serie A](https://worldcup26.ir/football/bra.1) — 2026 Futebol Brasileiro
- [Saudi Pro League](https://worldcup26.ir/football/ksa.1) — 2026-27 Saudi Pro League
- [Japanese J.League](https://worldcup26.ir/football/jpn.1) — 2026 Japanese J1 League

## URL patterns

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

## API quick reference

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

- Leagues: GET https://worldcup26.ir/get/soccer/leagues
- Live scoreboard: GET https://worldcup26.ir/get/soccer/{league}/scoreboard?dates=YYYYMMDD
- Fixtures: GET https://worldcup26.ir/get/soccer/{league}/fixtures?status=all
- Standings: GET https://worldcup26.ir/get/soccer/{league}/standings?season=YYYY
- Clubs: GET https://worldcup26.ir/get/soccer/{league}/clubs
- Match summary: GET https://worldcup26.ir/get/soccer/{league}/summary?event={eventId}
- Coverage and freshness: GET https://worldcup26.ir/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://worldcup26.ir/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://worldcup26.ir.