# 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, Paddy Power, Betfair Sportsbook, 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, Paddy Power, Betfair Sportsbook, and Kambi prices. Developers use Pinnacle as the sharp, low-margin reference book, deriving no-vig fair-value probabilities from its lines 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 ### Paddy Power Odds API for Football URL: https://www.thestatsapi.com/odds-api/paddy-power Primary keyword: Paddy Power odds API Search intent: Paddy Power football odds API, Paddy Power sportsbook odds, UK bookmaker odds API, Irish bookmaker odds API Summary: TheStatsAPI provides Paddy Power football odds through the match odds endpoint, alongside Bet365, Pinnacle, Betfair Sportsbook, and Kambi prices. Paddy Power is one of the best-known UK & Irish bookmakers, so its prices give a widely recognised recreational retail reference point for comparison products. Related: - Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365 - Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle - Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison - Betfair Sportsbook odds API: https://www.thestatsapi.com/odds-api/betfair-sportsbook ### Betfair Sportsbook Odds API for Football URL: https://www.thestatsapi.com/odds-api/betfair-sportsbook Primary keyword: Betfair Sportsbook odds API Search intent: Betfair Sportsbook football odds API, Betfair Sportsbook odds, fixed odds sportsbook API, UK bookmaker odds API Summary: TheStatsAPI provides Betfair Sportsbook football odds through the match odds endpoint, alongside Bet365, Pinnacle, Paddy Power, and Kambi prices. Betfair Sportsbook is the fixed-odds sportsbook arm of Betfair, distinct from the Exchange, giving competitive mainstream retail pricing for comparison products. Related: - Bet365 odds API: https://www.thestatsapi.com/odds-api/bet365 - Pinnacle odds API: https://www.thestatsapi.com/odds-api/pinnacle - Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison - Paddy Power odds API: https://www.thestatsapi.com/odds-api/paddy-power ### 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, Paddy Power, and Betfair Sportsbook. 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, Paddy Power, Betfair Sportsbook, and Kambi prices, convert them to implied probability, and flag mismatches. Related: - Odds comparison API: https://www.thestatsapi.com/odds-api/odds-comparison - Betfair Sportsbook odds API: https://www.thestatsapi.com/odds-api/betfair-sportsbook - 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, Paddy Power, Betfair Sportsbook, 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 Sportsbook odds API: https://www.thestatsapi.com/odds-api/betfair-sportsbook - 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 ## World Cup 2026 The 2026 FIFA World Cup runs 2026-06-11 to 2026-07-19 across United States, Canada, Mexico with 48 teams, 12 groups, 104 matches, 16 host cities. Defending champion: Argentina. Final: MetLife Stadium, New York/New Jersey. Look up the World Cup competition_id via GET /football/competitions and filter by name. ### World Cup 2026 key dates - Group Stage: 2026-06-11 to 2026-06-27 (72 matches) - Round of 32: 2026-06-28 to 2026-07-03 (16 matches) - Round of 16: 2026-07-04 to 2026-07-07 (8 matches) - Quarter-finals: 2026-07-09 to 2026-07-11 (4 matches) - Semi-finals: 2026-07-14 to 2026-07-15 (2 matches) - Third-place Playoff: 2026-07-18 (1 match) - Final: 2026-07-19 (1 match) Official starting lineups are confirmed approximately 75 minutes before each kickoff. ### Main World Cup pages - World Cup landing: https://www.thestatsapi.com/world-cup - Matches today (auto-updating schedule): https://www.thestatsapi.com/world-cup/today - Lineups (confirmed starting XIs): https://www.thestatsapi.com/world-cup/lineups - Fixtures: https://www.thestatsapi.com/world-cup/fixtures - Key dates: https://www.thestatsapi.com/world-cup/key-dates - Odds: https://www.thestatsapi.com/world-cup/odds - Standings: https://www.thestatsapi.com/world-cup/standings - Results: https://www.thestatsapi.com/world-cup/results - Squads: https://www.thestatsapi.com/world-cup/squads - Top scorers: https://www.thestatsapi.com/world-cup/top-scorers - Records and all-time stats: https://www.thestatsapi.com/world-cup/records - Predictions: https://www.thestatsapi.com/world-cup/predictions ### Free World Cup 2026 data downloads All 104 fixtures with dates, UTC kickoff times, stages, groups, teams, stadiums, and host cities. Free, CORS-enabled, no signup. - Overview: https://www.thestatsapi.com/world-cup/data - JSON: https://www.thestatsapi.com/world-cup/data/fixtures.json - CSV: https://www.thestatsapi.com/world-cup/data/fixtures.csv ### Team pages (48) - Mexico: https://www.thestatsapi.com/world-cup/teams/mexico - South Africa: https://www.thestatsapi.com/world-cup/teams/south-africa - Korea Republic: https://www.thestatsapi.com/world-cup/teams/south-korea - Czechia: https://www.thestatsapi.com/world-cup/teams/czechia - Canada: https://www.thestatsapi.com/world-cup/teams/canada - Bosnia and Herzegovina: https://www.thestatsapi.com/world-cup/teams/bosnia-herzegovina - Qatar: https://www.thestatsapi.com/world-cup/teams/qatar - Switzerland: https://www.thestatsapi.com/world-cup/teams/switzerland - Brazil: https://www.thestatsapi.com/world-cup/teams/brazil - Morocco: https://www.thestatsapi.com/world-cup/teams/morocco - Haiti: https://www.thestatsapi.com/world-cup/teams/haiti - Scotland: https://www.thestatsapi.com/world-cup/teams/scotland - United States: https://www.thestatsapi.com/world-cup/teams/usa - Paraguay: https://www.thestatsapi.com/world-cup/teams/paraguay - Australia: https://www.thestatsapi.com/world-cup/teams/australia - Turkiye: https://www.thestatsapi.com/world-cup/teams/turkiye - Germany: https://www.thestatsapi.com/world-cup/teams/germany - Curacao: https://www.thestatsapi.com/world-cup/teams/curacao - Cote d'Ivoire: https://www.thestatsapi.com/world-cup/teams/cote-divoire - Ecuador: https://www.thestatsapi.com/world-cup/teams/ecuador - Netherlands: https://www.thestatsapi.com/world-cup/teams/netherlands - Japan: https://www.thestatsapi.com/world-cup/teams/japan - Sweden: https://www.thestatsapi.com/world-cup/teams/sweden - Tunisia: https://www.thestatsapi.com/world-cup/teams/tunisia - Belgium: https://www.thestatsapi.com/world-cup/teams/belgium - Egypt: https://www.thestatsapi.com/world-cup/teams/egypt - IR Iran: https://www.thestatsapi.com/world-cup/teams/iran - New Zealand: https://www.thestatsapi.com/world-cup/teams/new-zealand - Spain: https://www.thestatsapi.com/world-cup/teams/spain - Cabo Verde: https://www.thestatsapi.com/world-cup/teams/cabo-verde - Saudi Arabia: https://www.thestatsapi.com/world-cup/teams/saudi-arabia - Uruguay: https://www.thestatsapi.com/world-cup/teams/uruguay - France: https://www.thestatsapi.com/world-cup/teams/france - Senegal: https://www.thestatsapi.com/world-cup/teams/senegal - Iraq: https://www.thestatsapi.com/world-cup/teams/iraq - Norway: https://www.thestatsapi.com/world-cup/teams/norway - Argentina: https://www.thestatsapi.com/world-cup/teams/argentina - Algeria: https://www.thestatsapi.com/world-cup/teams/algeria - Austria: https://www.thestatsapi.com/world-cup/teams/austria - Jordan: https://www.thestatsapi.com/world-cup/teams/jordan - Portugal: https://www.thestatsapi.com/world-cup/teams/portugal - Congo DR: https://www.thestatsapi.com/world-cup/teams/congo-dr - Uzbekistan: https://www.thestatsapi.com/world-cup/teams/uzbekistan - Colombia: https://www.thestatsapi.com/world-cup/teams/colombia - England: https://www.thestatsapi.com/world-cup/teams/england - Croatia: https://www.thestatsapi.com/world-cup/teams/croatia - Ghana: https://www.thestatsapi.com/world-cup/teams/ghana - Panama: https://www.thestatsapi.com/world-cup/teams/panama ### Group pages - Group A (mexico, south-africa, south-korea, czechia): https://www.thestatsapi.com/world-cup/groups/a - Group B (canada, bosnia-herzegovina, qatar, switzerland): https://www.thestatsapi.com/world-cup/groups/b - Group C (brazil, morocco, haiti, scotland): https://www.thestatsapi.com/world-cup/groups/c - Group D (usa, paraguay, australia, turkiye): https://www.thestatsapi.com/world-cup/groups/d - Group E (germany, curacao, cote-divoire, ecuador): https://www.thestatsapi.com/world-cup/groups/e - Group F (netherlands, japan, sweden, tunisia): https://www.thestatsapi.com/world-cup/groups/f - Group G (belgium, egypt, iran, new-zealand): https://www.thestatsapi.com/world-cup/groups/g - Group H (spain, cabo-verde, saudi-arabia, uruguay): https://www.thestatsapi.com/world-cup/groups/h - Group I (france, senegal, iraq, norway): https://www.thestatsapi.com/world-cup/groups/i - Group J (argentina, algeria, austria, jordan): https://www.thestatsapi.com/world-cup/groups/j - Group K (portugal, congo-dr, uzbekistan, colombia): https://www.thestatsapi.com/world-cup/groups/k - Group L (england, croatia, ghana, panama): https://www.thestatsapi.com/world-cup/groups/l ### Host city pages - Atlanta (Mercedes-Benz Stadium, cap 75000): https://www.thestatsapi.com/world-cup/host-cities/atlanta - Boston (Foxborough) (Gillette Stadium, cap 65878): https://www.thestatsapi.com/world-cup/host-cities/boston - Dallas (Arlington) (AT&T Stadium, cap 80000): https://www.thestatsapi.com/world-cup/host-cities/dallas - Guadalajara (Estadio Akron, cap 48071): https://www.thestatsapi.com/world-cup/host-cities/guadalajara - Houston (NRG Stadium, cap 72220): https://www.thestatsapi.com/world-cup/host-cities/houston - Kansas City (Arrowhead Stadium, cap 76416): https://www.thestatsapi.com/world-cup/host-cities/kansas-city - Los Angeles (Inglewood) (SoFi Stadium, cap 70240): https://www.thestatsapi.com/world-cup/host-cities/los-angeles - Mexico City (Estadio Azteca, cap 87523): https://www.thestatsapi.com/world-cup/host-cities/mexico-city - Miami (Miami Gardens) (Hard Rock Stadium, cap 65326): https://www.thestatsapi.com/world-cup/host-cities/miami - Monterrey (Estadio BBVA, cap 53500): https://www.thestatsapi.com/world-cup/host-cities/monterrey - New York/New Jersey (East Rutherford) (MetLife Stadium, cap 82500): https://www.thestatsapi.com/world-cup/host-cities/new-york - Philadelphia (Lincoln Financial Field, cap 69596): https://www.thestatsapi.com/world-cup/host-cities/philadelphia - San Francisco Bay Area (Santa Clara) (Levi's Stadium, cap 68500): https://www.thestatsapi.com/world-cup/host-cities/san-francisco - Seattle (Lumen Field, cap 68740): https://www.thestatsapi.com/world-cup/host-cities/seattle - Toronto (BMO Field, cap 45500): https://www.thestatsapi.com/world-cup/host-cities/toronto - Vancouver (BC Place, cap 54500): https://www.thestatsapi.com/world-cup/host-cities/vancouver ### Stage pages - Group Stage (72 matches): https://www.thestatsapi.com/world-cup/stages/group-stage - Round of 32 (16 matches): https://www.thestatsapi.com/world-cup/stages/round-of-32 - Round of 16 (8 matches): https://www.thestatsapi.com/world-cup/stages/round-of-16 - Quarter-finals (4 matches): https://www.thestatsapi.com/world-cup/stages/quarter-finals - Semi-finals (2 matches): https://www.thestatsapi.com/world-cup/stages/semi-finals - Third-place Playoff (1 matches): https://www.thestatsapi.com/world-cup/stages/third-place - Final (1 matches): https://www.thestatsapi.com/world-cup/stages/final ## Free Tools Pure client-side calculators and simulators. No login or API required. - World Cup 2026 Bracket Maker: https://www.thestatsapi.com/tools/world-cup-bracket-maker — Build and share your 48-team World Cup 2026 bracket. - World Cup 2026 Group Simulator: https://www.thestatsapi.com/tools/world-cup-group-simulator — Predict group-stage scores and see who advances. - World Cup 2026 Knockout Simulator: https://www.thestatsapi.com/tools/world-cup-knockout-simulator — Pick winners from Round of 32 to the Final. - World Cup 2026 Match Countdown: https://www.thestatsapi.com/tools/world-cup-match-countdown — Countdown timer for any World Cup 2026 fixture. - Odds Converter: https://www.thestatsapi.com/tools/odds-converter — Convert decimal, fractional, American odds and implied probability. - Implied Probability Calculator: https://www.thestatsapi.com/tools/implied-probability-calculator — Convert betting odds to implied probability and remove the vig. - Parlay Calculator: https://www.thestatsapi.com/tools/parlay-calculator — Calculate accumulator returns and combined probability. - Kelly Criterion Calculator: https://www.thestatsapi.com/tools/kelly-criterion-calculator — Optimal stake sizing for value bets. - Arbitrage Calculator: https://www.thestatsapi.com/tools/arbitrage-calculator — Detect 2-way and 3-way arbitrage betting opportunities. - Hedge Calculator: https://www.thestatsapi.com/tools/hedge-calculator — Calculate hedge bets to lock in profit or minimise loss. - Asian Handicap Calculator: https://www.thestatsapi.com/tools/asian-handicap-calculator — Calculate Asian handicap settlements from any score. - Over/Under Goals Calculator: https://www.thestatsapi.com/tools/over-under-goals-calculator — Compute over/under settlements for any goals line. - Poisson Score Predictor: https://www.thestatsapi.com/tools/poisson-score-predictor — Predict match scores from expected goals (xG). - League Table Generator: https://www.thestatsapi.com/tools/league-table-generator — Paste match results, get a sorted league table. - Match Kickoff Time Converter: https://www.thestatsapi.com/tools/match-kickoff-time-converter — Convert match kickoff times across time zones.