The Football Stats API Built for Speed

Q: What data format does the API return?

All responses are in JSON format via a standard REST API. No SDK needed. Just make HTTP requests from any language or framework. We provide code snippets you can copy straight into your project or AI code editor.

Get instant access to football match data, player stats, and fixtures across 150 competitions, with up to 1,196 available on request. Start building in minutes with a fast, easy to use, and reliable API.

Start Your Free Trial See How It Works

150

Competitions

up to 1,196 on request

See full coverage

84,000+

Players

Years of Data

100+

Countries

Fast & Reliable

Worldwide Coverage

Verified Data

Whats_Live

All the Football Data
You Need

Production-ready endpoints powering apps right now. Every feature is live on all plans.

Player Statistics

Season and career stats for 84,000+ players including goals, assists, appearances, minutes, cards, shots & more.

Match Statistics & Events

Live and finalized match stats: shots, xG, possession, passes, cards, goals, and minute-by-minute events.

Match Schedules & Results

Complete fixture lists and historical match results from all covered competitions.

Competition Data

150 competitions across 100+ countries — up to 1,196 available on request.

Complete Team Squads

Full squad information with player details, positions, and contract information.

Live Match Stats

Realtime scores, status, and match stats for supported live fixtures.

Advanced Analytics

Expected goals (xG), non-penalty xG (npxG), xA, and deep underlying metrics for every covered match.

Lineups

Confirmed pre-match and actual starting lineups with formations, substitutions, and team news.

Player Heatmaps

Positional heatmap data showing player movement and touch density across the pitch.

1,196competitions on request

100+countries

10years of history

/coverageView full coverage

Odds_API

Live & pre-match odds from 5 bookmakers

View Odds API

Bet365 Pinnacle Paddy Power Betfair Sportsbook Kambi Live Odds Historical Odds Odds Comparison Closing Line Value

On_The_Roadmap

We Ship Fast

Here's what's next. We're building in public. These endpoints are actively in development.

Soon

Extended Live Feeds

Broader live coverage, deeper in-play event feeds, and richer live match context.

Interactive_Demo

See It In Action

Try our API live. Watch how easy it is to fetch comprehensive match data.

api-request.js

GET /football/matches/mt_010249745/stats

fetch('https://api.thestatsapi.com/api/football/matches/mt_010249745/stats', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
})
.then(res => res.json())
.then(data => console.log(data));

Click to try it!

response.json

Waiting for request...

Hit "Run API Call" to see the response

API_Reference

Explore Our Endpoints

34 endpoints across 6 categories. All returning clean, paginated JSON.

🏆Competitions

5 endpoints available

Base: /api/football/*

GET/api/football/competitions

Returns football competitions (leagues, cups and international tournaments), 20 per page. Use it to find a `competition_id` by name or country. With `search`, the best match comes first. **Examples** - Find the Premier League: `GET /football/competitions?search=Premier` - English leagues: `GET /football/competitions?country_code=GB-ENG&type=league`

pageper_pagecountry+4 more

GET/api/football/competitions/{competition_id}

Returns one competition with its `current_season_id` and flags for which data it has (team stats, player stats, odds, xG). Use `current_season_id` to fetch this season's matches, standings and stats. **Example:** `GET /football/competitions/comp_3039`

competition_id*

GET/api/football/competitions/{competition_id}/seasons

Returns every season of a competition, newest first, with its `season_id`. The season with `is_current: true` is the same as `current_season_id` on the competition. **Example:** `GET /football/competitions/comp_3039/seasons`

competition_id*

GET/api/football/competitions/{competition_id}/seasons/{season_id}/groups

Returns the groups (A to L) of a tournament season with a group stage, such as the FIFA World Cup, EURO, AFCON or the pre-2024 UEFA Champions League. Returns an empty list for competitions without groups, such as the Premier League. Pass a `group_label` to `/football/matches?group=` or to the standings `group` filter. Returns 400 if `season_id` belongs to a different competition. **Example:** `GET /football/competitions/comp_6107/seasons/sn_326766/groups` (World Cup 2022, groups A to H)

competition_id*season_id*

GET/api/football/competitions/{competition_id}/seasons/{season_id}/standings

Returns the league table for one competition season, one row per team, sorted by `position`. Group-stage tournaments return every group's table, sorted by `group_label` and then `position`; add `group` to get one group. Knockout-only cups (such as the FA Cup) return an empty list. Returns 400 if `season_id` belongs to a different competition. **Examples** - Premier League 2026/27: `GET /football/competitions/comp_3039/seasons/sn_8406098/standings` - World Cup 2022, Group A: `GET /football/competitions/comp_6107/seasons/sn_326766/standings?group=A`

competition_id*season_id*group

Try it live

Start a free trial to test endpoints interactively

Get API Key

Endpoints

JSON

Paginated

Pricing_Plans

Simple, Transparent Pricing

All stats data — fixtures, results, match & player stats, xG, and history.

Starter

$50/month

For prototypes, side projects, and early products

Included in every plan:

All football data endpoints included
Pre-match & live odds endpoints
Bet365, Pinnacle, Paddy Power, Betfair Sportsbook & Kambi odds
1X2, Asian handicap, totals, BTTS, DNB & corners
Fixtures, results, match stats, teams & players
xG, player season stats & team stats
10 years of historical match data
Build with AI
150 competitions by default, up to 1,196 on request
100,000 requests/month
120 requests/min
Email & chat support

Growth

$129/month

For production apps with steady traffic

Everything in Starter, plus:

500,000 requests/month
300 requests/min
Priority support for production teams

Scale

$379/month

For high-volume, production-grade usage

Everything in Growth, upgraded to:

5,000,000 requests/month
1,000 requests/min
Dedicated support & SLA

Cancel anytime

7-day free trial on all plans

Use_Cases

What You Can Build

From hobby projects to production apps. Here's what developers are building with TheStatsAPI.

Fantasy Football Apps

Build dynamic leagues powered by real player stats, season averages, and match-by-match scoring data.

GET/football/playersGET/football/matches

Match Day Dashboards

Power scoreboards with realtime odds, live match stats, possession, goal events, and form tables.

GET/football/matchesGET/football/teams

Betting Analytics Tools

Run prediction models on 10 years of historical data, xG stats, head-to-head records, and team form.

GET/football/matchesGET/football/teamsGET/football/players

Sports News Platforms

Enrich editorial content with team form, player profiles, competition data, and match reports.

GET/football/competitionsGET/football/players

AI Builder

Not sure where to start?
We'll get you there fast.

Describe what you want to build and our AI generates a ready-to-use prompt for your favourite AI coding tool. No API knowledge needed. Just your idea.

New to APIs? Get up and running without needing to know the technical details.

Experienced dev? Skip the boilerplate and go straight to building.

Describe your idea

Answer a few questions

Use with any AI tool

Build with AI

Support_FAQ

Frequently Asked Questions

Everything you need to know about TheStatsAPI

Sign up for a 7-day free trial. You'll get instant access to your API key and all endpoints. You can test every endpoint using our interactive API Tester or grab copy-paste snippets in cURL, JavaScript, and Python.

We cover competitions, teams, players, and matches across 150 competitions by default, with up to 1,196 available on request. Each match can include live and finalized stats like possession, shots, cards, goals, xG, and more. We also provide live realtime and pre-match betting odds from Bet365, Pinnacle, Paddy Power, Betfair Sportsbook, and Kambi across markets including 1X2, Asian handicap, over/under, BTTS, draw no bet, and corners - with opening and closing lines included. Player and team stats are available per season with full historical depth.

Live realtime odds and match stats are available during eligible matches. Finalized match statistics, events, player data, and xG are verified after full time and typically settle within 1-2 hours of the final whistle.

All responses are in JSON format via a standard REST API. There's no SDK needed. Just make HTTP requests from any language or framework. We provide code snippets you can copy straight into your project or AI code editor.

Yes, we have historical data going back 10 years for major leagues. The depth varies by competition, and all plans include full access to historical data.

Absolutely. All paid plans (Starter, Growth, and Scale) allow commercial usage. For high-volume commercial applications, we recommend our Scale plan which includes higher rate limits and priority support.

Requests beyond your monthly limit will return a 429 status code. You can upgrade your plan at any time to increase your limits. Changes take effect immediately.

We cover 150 competitions across 100+ countries by default, from top-tier leagues like the Premier League, La Liga, and Bundesliga to lower divisions and international tournaments. We can extend coverage up to 1,196 competitions on request.

We offer three plans (Starter, Growth, and Scale) each with a 7-day free trial. All plans include access to every endpoint and all features. Plans differ by monthly request limits and rate limits to match your usage needs.

Still have questions?

Our support team is here to help you get started.

Email Support

Avg. response 1-2 hours

Get_Started

Ready to Power Your Sports App?

Start your 7-day free trial. All endpoints included on every plan.

Start Your Free Trial View Pricing