# TheStatsAPI

TheStatsAPI is a football data API for developers. It provides REST JSON endpoints for football competitions, teams, players, matches, match statistics, shot maps, xG, and football odds.

## Core URLs

- Website: https://www.thestatsapi.com
- API base URL: https://api.thestatsapi.com/api
- API documentation context: https://api.thestatsapi.com/llms.txt
- Coverage: https://www.thestatsapi.com/coverage
- Football odds API: https://www.thestatsapi.com/odds-api
- Pricing: https://www.thestatsapi.com/#pricing

## Odds API Summary

The football odds API provides pre-match odds, stored opening and last-seen prices, and live in-play odds where live_odds_available is true. Covered bookmaker sources include Bet365, Pinnacle, Betfair Exchange, and Kambi where prices are available. Supported markets include 1X2, both teams to score, total goals, match corners, and Asian handicap.

Primary odds endpoints:

- GET /football/matches/{match_id}/odds
- GET /football/matches/{match_id}/odds/live

## Odds Pages

### Pinnacle Odds API for Football
URL: https://www.thestatsapi.com/odds-api/pinnacle
Primary keyword: Pinnacle odds API
Search intent: Pinnacle football odds API, sharp odds API, Pinnacle closing odds, Pinnacle CLV API
Summary: TheStatsAPI provides Pinnacle football odds through the match odds endpoint, alongside Bet365, Betfair Exchange, and Kambi prices. Developers use Pinnacle as the sharp reference book when measuring whether a prediction model beat the market.
Related:
- Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365
- Closing line value API: https://www.thestatsapi.com/odds-api/clv
- Closing odds API: https://www.thestatsapi.com/odds-api/closing-odds
- Historical football odds API: https://www.thestatsapi.com/odds-api/historical-football-odds

### Betfair Exchange Odds API
URL: https://www.thestatsapi.com/odds-api/betfair-exchange
Primary keyword: Betfair Exchange odds API
Search intent: exchange odds API, Betfair football odds API, no vig odds API, fair odds API
Summary: TheStatsAPI exposes Betfair Exchange prices for supported football matches so developers can compare exchange pricing against sportsbook prices from Bet365, Pinnacle, and Kambi.
Related:
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison
- Football arbitrage API: https://www.thestatsapi.com/odds-api/arbitrage
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle
- Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365

### Kambi Odds API for Football
URL: https://www.thestatsapi.com/odds-api/kambi
Primary keyword: Kambi odds API
Search intent: Kambi football odds API, Kambi sportsbook odds, operator odds API
Summary: TheStatsAPI includes Kambi football odds for supported matches, giving developers another regulated operator-network price source alongside Bet365, Pinnacle, and Betfair Exchange.
Related:
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison
- Closing line value API: https://www.thestatsapi.com/odds-api/clv
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle
- Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365

### Live Football Odds API
URL: https://www.thestatsapi.com/odds-api/live-football-odds
Primary keyword: live football odds API
Search intent: in-play odds API, live betting odds API, football live odds API
Summary: TheStatsAPI provides a dedicated live football odds endpoint: /football/matches/{match_id}/odds/live. It is meaningful while a match is live and live_odds_available is true.
Related:
- Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle
- Closing line value API: https://www.thestatsapi.com/odds-api/clv
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison

### Historical Football Odds API
URL: https://www.thestatsapi.com/odds-api/historical-football-odds
Primary keyword: historical football odds API
Search intent: football odds history API, historical betting odds API, odds backtesting API
Summary: TheStatsAPI provides stored football odds for supported matches, including opening and last-seen values where odds were captured or stored. Use this with match results and stats to backtest prediction models.
Related:
- Closing odds API: https://www.thestatsapi.com/odds-api/closing-odds
- Closing line value API: https://www.thestatsapi.com/odds-api/clv
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle

### Closing Odds API for Football
URL: https://www.thestatsapi.com/odds-api/closing-odds
Primary keyword: closing odds API
Search intent: football closing odds API, closing line API, closing price odds API
Summary: Closing odds are the market prices immediately before kickoff. TheStatsAPI stores last-seen pre-match prices for supported matches, so developers can use those values as a closing-price proxy when a dedicated final-close snapshot is not available.
Related:
- Closing line value API: https://www.thestatsapi.com/odds-api/clv
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle
- Historical football odds API: https://www.thestatsapi.com/odds-api/historical-football-odds
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison

### Closing Line Value (CLV) API
URL: https://www.thestatsapi.com/odds-api/clv
Primary keyword: CLV API
Search intent: closing line value API, football CLV API, betting model API
Summary: TheStatsAPI supports CLV workflows by returning opening and last-seen odds for supported football matches. Compare your model or entry price against the last-seen market price, especially Pinnacle where available.
Related:
- Closing odds API: https://www.thestatsapi.com/odds-api/closing-odds
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle
- Historical football odds API: https://www.thestatsapi.com/odds-api/historical-football-odds
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison

### Football Arbitrage API
URL: https://www.thestatsapi.com/odds-api/arbitrage
Primary keyword: football arbitrage API
Search intent: betting arbitrage API, football arb API, odds scanner API
Summary: TheStatsAPI gives arbitrage and value tools multi-bookmaker football odds in one response. You can compare Bet365, Pinnacle, Betfair Exchange, and Kambi prices, convert them to implied probability, and flag mismatches.
Related:
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison
- Betfair Exchange odds API: https://www.thestatsapi.com/odds-api/betfair-exchange
- Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle

### Football Odds Comparison API
URL: https://www.thestatsapi.com/odds-api/odds-comparison
Primary keyword: football odds comparison API
Search intent: odds comparison API, bookmaker odds API, football odds data API
Summary: TheStatsAPI is a football odds comparison API for developers who need prices from Bet365, Pinnacle, Betfair Exchange, and Kambi alongside football match data.
Related:
- Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle
- Betfair Exchange odds API: https://www.thestatsapi.com/odds-api/betfair-exchange
- Football arbitrage API: https://www.thestatsapi.com/odds-api/arbitrage

### Asian Handicap Odds API
URL: https://www.thestatsapi.com/odds-api/asian-handicap
Primary keyword: Asian handicap odds API
Search intent: football handicap odds API, Asian handicap API, handicap betting odds API
Summary: TheStatsAPI returns Asian handicap odds inside the match odds response for supported matches and bookmakers, with opening and last-seen values where available.
Related:
- Closing odds API: https://www.thestatsapi.com/odds-api/closing-odds
- Closing line value API: https://www.thestatsapi.com/odds-api/clv
- Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison

### BTTS Odds API for Football
URL: https://www.thestatsapi.com/odds-api/btts
Primary keyword: BTTS odds API
Search intent: both teams to score odds API, football BTTS API, BTTS betting data
Summary: TheStatsAPI returns BTTS odds inside the match odds response for supported football matches and bookmakers. Values include yes/no prices with opening and last-seen odds where available.
Related:
- Corners odds API: https://www.thestatsapi.com/odds-api/corners
- Asian handicap odds API: https://www.thestatsapi.com/odds-api/asian-handicap
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison
- Historical football odds API: https://www.thestatsapi.com/odds-api/historical-football-odds

### Corners Odds API for Football
URL: https://www.thestatsapi.com/odds-api/corners
Primary keyword: corners odds API
Search intent: football corners odds API, corners betting API, match corners API
Summary: TheStatsAPI returns match corners odds in the match odds response for supported football matches and bookmakers, including over/under prices where available.
Related:
- BTTS odds API: https://www.thestatsapi.com/odds-api/btts
- Asian handicap odds API: https://www.thestatsapi.com/odds-api/asian-handicap
- Closing line value API: https://www.thestatsapi.com/odds-api/clv
- Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison