# Football API (by FORCESCRIPTS LTD)

> Real-time and historical football/soccer data API providing live scores, standings, lineups, head-to-head records, and match statistics via a simple JSON REST API. Covers 1400+ leagues worldwide, with historical match data going back to the 1950s.

Football API is built for developers who need reliable, low-latency football data to power live-score apps, fantasy platforms, betting dashboards, sports media products, and historical/archival research tools. Three pricing models are supported: pay-as-you-go credits (never expire), a fully unmetered "Unlimited" subscription (3/6/12-month plans are cross-sport — one subscription includes Football, Basketball, Tennis, and Volleyball API data under one account; the 1-month plan covers football only), and a lower-cost recurring monthly subscription capped at a daily request limit.

## Standout features
- **Historical Match Archive** — full match data (results, lineups, and stats where available) going back to the 1950s, not just live/current-season data. Useful for stats sites, betting model backtesting, and sports history/media products.
- **Flexible billing** — choose pay-as-you-go credits or a monthly subscription; the 3/6/12-month Unlimited plans unlock unified access across football, basketball, tennis, and volleyball data with no separate accounts or keys needed.
- **Per-plan rate limits** — every plan gets both a sustained requests/second rate and a short burst allowance (see Rate Limits below), scaling up with plan tier.

## Documentation
- [API Documentation](https://live-football-api.com/docs): Full endpoint reference, authentication, and code examples in cURL, JavaScript, PHP, and Python
- [Pricing](https://live-football-api.com/pricing): Pay-as-you-go credit pricing and subscription plans (see Subscription Plans below)
- [API Status](https://live-football-api.com/status): Live uptime and latency monitoring (99.9% uptime SLA)

## Key Endpoints
- `GET /api/v1/matches` — Today's or a specific date's matches (1 credit)
- `GET /api/v1/live_match_details` — Live play-by-play and in-match event data (1 credit)
- `GET /api/v1/lineups` — Match lineups (1 credit)
- `GET /api/v1/h2h` — Head-to-head match history between two teams (1 credit)
- `GET /api/v1/injuries` — Player injury data (1 credit)
- `GET /api/v1/officials` — Match officials/referee data (1 credit)
- `GET /api/v1/leagues` — List of covered leagues and competitions (1 credit)
- `GET /api/v1/league` — Single league details (1 credit)
- `GET /api/v1/league_standings` — League tables and standings (1 credit)
- `GET /api/v1/league_fixtures` — Full league match schedule, grouped week by week (1 credit)
- `GET /api/v1/team_matches` — A team's fixtures and results (1 credit)
- `GET /api/v1/team_squad` — Full team roster data (1 credit)
- `GET /api/v1/team_standings` — A team's league standing (1 credit)
- `POST /api/v1/webhook/register` / `GET` (list) / `PATCH` (change events, pause/resume) / `DELETE` — Manage webhooks for real-time push notifications of live-match events: `goal`, `yellow_card`, `red_card`, `substitution`, plus live team statistics `corner`, `shot_on_target`, `shot_off_target`, `blocked_shot`, `hit_woodwork`, `big_chance_missed`, `offside`, `foul` (one notification per counter increase; managing is free; 1 credit per delivered notification)
- Historical match archive (results and available stats from the 1950s onward) — see docs for date-range parameters
- Embeddable JS widget (matches list, single match, league, team, or player) — no coding or design work required, see [Widget docs](https://live-football-api.com/docs#widget-embed)

## Subscription Plans
Three independent billing models, each works standalone:

**Pay-as-you-go credits** (never expire):
- **Starter** — $9.99 — 50,000 credits — 2 req/s sustained (burst 5)
- **Professional** — $39.99 — 300,000 credits — 5 req/s sustained (burst 15)
- **Enterprise** — $99.99 — 1,250,000 credits — 15 req/s sustained (burst 40)
- **Ultimate** — $249.99 — 5,000,000 credits — 40 req/s sustained (burst 100)

**Unlimited subscription** (unmetered requests, tax exclusive):
- **Unlimited Monthly** — $99 / 1 month — Football only — 50 req/s sustained (burst 150)
- **Unlimited 3-Month** — $349 / 3 months — Football, Basketball, Tennis, Volleyball — 75 req/s sustained (burst 200)
- **Unlimited 6-Month** — $599 / 6 months — Football, Basketball, Tennis, Volleyball — 100 req/s sustained (burst 300)
- **Unlimited Annual** — $999 / 1 year — Football, Basketball, Tennis, Volleyball — 150 req/s sustained (burst 450)

**Monthly subscription** (recurring, auto-renews monthly, capped at a daily request limit rather than fully unmetered):
- **Starter Monthly** — $9.99/mo — 5,000 requests/day — 2 req/s sustained (burst 5)
- **Plus Monthly** — $19.99/mo — 25,000 requests/day — 5 req/s sustained (burst 15)
- **Growth Monthly** — $29.99/mo — 100,000 requests/day — 10 req/s sustained (burst 30)
- **Elite Monthly** — $39.99/mo — 200,000 requests/day — 20 req/s sustained (burst 60)
- **Business Monthly** — $69.99/mo — 500,000 requests/day — 40 req/s sustained (burst 120)

New accounts get 500 free credits, no card required.

## Rate Limits
Every plan has two limits: a **sustained** rate (steady-state requests/second you can run indefinitely) and a **burst** allowance (a token-bucket capacity — unused capacity accumulates while idle, up to the burst cap, and can be spent as a short back-to-back spike). Higher-tier plans get proportionally higher limits on both. See the per-plan numbers above, or the [Pricing page](https://live-football-api.com/pricing) for the full table.

## Company
Football API is a product of FORCESCRIPTS LTD, a UK-registered software company (Company No. 17110478), registered with the UK Information Commissioner's Office (ICO Ref. ZC110857) for data protection compliance. Registered address: Suite 10647, 5 Brayford Square, London, E1 0SG, United Kingdom.

## Related products (included with 3/6/12-month Unlimited subscriptions)
- [Basketball API](https://live-basketball-api.com): Real-time and historical basketball data — NBA, EuroLeague, FIBA, and more
- [Tennis API](https://live-tennis-api.com): Real-time and historical tennis data — ATP, WTA, Grand Slams, and more
- [Volleyball API](https://live-volleyball-api.com): Real-time and historical volleyball data

## Contact
- [Contact form](https://live-football-api.com/contact)
- WhatsApp: +44 7541 438660

## Optional
- [Terms of Service](https://live-football-api.com/terms)
- [Privacy Policy](https://live-football-api.com/privacy)