Skip to main content
TheStatsAPI is a REST API for football data: fixtures, results, live scores, league tables, team and player stats, xG shot maps and betting odds.

Fastest way: build with AI

Give Claude Code, Codex, Cursor or Lovable our full API reference and a starter prompt, and let it write the code.
Already using an AI coding tool? Give it https://api.thestatsapi.com/llms.txt. It’s every endpoint, parameter and response field in one file.

​
Start here

Quickstart

Get a key and make your first useful requests in about five minutes.

Guides

Step-by-step recipes for fixtures, live scores, tables, stats and odds.

API reference

Every endpoint, with its parameters and response fields.

Coverage

Check which competitions and seasons have stats, xG and odds.

​
What you can build

Fixtures and results

A team’s next match, last result, or every match on a date.

Live scores

Live scores, minute, stats and events, by polling during a match.

League tables

Current and past standings for leagues and group stages.

Player and team stats

Season and match stats, xG, shot maps and heatmaps.

Odds comparison

Pre-match and in-play odds from several bookmakers, where available.

Find any ID

Look up competition, season, team, player and match IDs.

​
How it works

  1. Get an API key from your dashboard.
  2. Send it in the Authorization: Bearer YOUR_API_KEY header.
  3. Call endpoints under https://api.thestatsapi.com/api and get JSON back.
That request returns Arsenal’s next fixture. See the Quickstart for more.