# StrikerAPI

> The soccer data API. 19 soccer data tools for AI agents. REST API + MCP server.

Full reference with response shapes: https://strikerapi.com/llms-full.txt
MCP server setup: https://strikerapi.com/llms-install.md
MCP server for AI agents (clients, prompts, every tool): https://strikerapi.com/mcp
Datasets with live coverage by season: https://strikerapi.com/docs/atlas
Tool catalogue with JSON Schema: https://mcp.strikerapi.com/v1/tools
OpenAPI 3.1 spec: https://mcp.strikerapi.com/openapi.json

## Quick Start

- API base URL: https://mcp.strikerapi.com
- Auth: `Authorization: Bearer YOUR_API_KEY` or `x-api-key: YOUR_API_KEY`
- MCP server: `https://mcp.strikerapi.com/mcp?key=YOUR_API_KEY`
- Python client: `pip install strikerapi` (https://pypi.org/project/strikerapi/). Reads STRIKERAPI_API_KEY.
- 500 free credits every month, no credit card required
- REST API responses include `X-Credits-Used` and `X-Credits-Remaining` headers
- Seasons: the year the season starts (2025 = 2025-26); MLS, the NWSL, Liga MX, Brazil and Argentina: the calendar year. Team codes like ARS, LIV, MNC (or a team id); list_teams has them. Match ids like 704345 (a match id; find them with list_games).

## Data timing and rights

- Odds and props are pre-game only. captured_at is when a line was captured (the page says exactly what it means for each kind of row); where props are held, rows also carry scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start).
- Records are overwritten when sources correct them; no revision history is kept.
- You may store the data, train models, backtest, and build commercial products that show your users what you derive. You may not redistribute the data, or odds as a raw feed, as a dataset or API of its own. After an account closes, stored data is for internal use only.
- StrikerAPI is independent, not an official league partner, and grants no league rights.
- Full answers: https://strikerapi.com/docs/timing-and-rights

## Which Tool Should I Use?

### Static reference
- Club ids, abbreviations and colours for a season -> list_teams (1 cr)
- Find players by name -> search_players (1 cr)

### Basic lookup
- Fixtures and results by season, stage, date, range or club -> list_games (2 cr)
- Upcoming fixtures with the median three-way line across sportsbooks -> get_schedule (2 cr)
- The league table: points, deductions, goal difference, home and away, form -> get_standings (2 cr)
- Our club Elo ratings, ranked -> get_ratings (2 cr)
- Two clubs' meetings: record, goals and every result -> get_head_to_head (2 cr)

### Stats + aggregation
- One match: score, both box scores, every player's line, key events, each book's line -> get_game (5 cr)
- Formations, starting XIs, benches and substitutions with minutes -> get_lineups (5 cr)
- Profile, per-season totals and per-90 rates, last 10 matches -> get_player (5 cr)
- A player's full match log -> get_player_games (5 cr)
- Season leaders: goals, assists, shots, xG, cards, saves -> get_leaders (5 cr)
- Per-match averages: goals, xG, shots, possession (missing for some leagues and seasons), passing, discipline, for and against -> get_team_stats (5 cr)
- Every sportsbook's three-way moneyline, goal handicap and total for a match (5) or a day (10), with results -> get_odds (5 cr)

### Multi-table
- Match events: goals, cards, substitutions, shots with location and xG, fouls, corners -> get_events (10 cr)
- Shot map for a club, player or defence: every located shot with outcome and xG, plus zone totals -> get_shot_map (10 cr)
- Anytime goalscorer prices by sportsbook (one pre-kick-off capture per price) -> get_player_props (10 cr)
- A player's anytime goalscorer price against whether he scored, match by match -> get_prop_history (10 cr)

### Time-series
- Snapshots of each sportsbook's line before kick-off -> get_line_movement (10 cr)

## Intents

- "What is the Premier League table right now?" -> get_standings
- "Which clubs are in the league this season, and their ids?" -> list_teams
- "Every match Haaland played this season, with minutes" -> get_player_games
- "What are Arsenal's results this season?" -> list_games
- "Who plays this weekend, and at what price?" -> get_schedule
- "Box scores and key events for one match" -> get_game
- "What formation did each side play, and when were the subs?" -> get_lineups
- "What is Bukayo Saka's player id?" -> search_players
- "How many goals and xG per 90 does a striker have?" -> get_player
- "Who leads the league in expected goals?" -> get_leaders
- "Which clubs create the most xG, and concede the least?" -> get_team_stats
- "Where does Manchester City shoot from?" -> get_shot_map
- "Every shot in a match, in order" -> get_events
- "Arsenal against Tottenham, all time" -> get_head_to_head
- "Which clubs are strongest by Elo?" -> get_ratings
- "What did each sportsbook close at for a match?" -> get_odds
- "How did the line move before kick-off?" -> get_line_movement
- "What was the anytime goalscorer price for Haaland, and which book had the best?" -> get_player_props
- "How often does a striker score in matches where he was priced to score?" -> get_prop_history

## Pages

- [Docs](https://strikerapi.com/docs): every endpoint, with parameters and a live example response.
- [Data changelog](https://strikerapi.com/changelog): when each dataset was last refreshed and what it runs through, read from the database.
- [Status](https://strikerapi.com/status): measured uptime for the website and MCP server over 24 hours, 7 days and 90 days, probed every five minutes from outside our own infrastructure, with incidents and data freshness.
- [Data atlas](https://strikerapi.com/docs/atlas): what exists, which endpoints expose it, and where coverage is partial.
- [Teams](https://strikerapi.com/teams): a page per club with its record, season figures and recent games.
- [Players](https://strikerapi.com/players): a page per player with an anytime goalscorer record: how often they scored in matches with a price, by league, and the last matches.
- [Data timing and rights](https://strikerapi.com/docs/timing-and-rights): what timestamps mean, when each dataset updates, whether lines are pre-game, and what the terms allow.
- [Pricing](https://strikerapi.com/pricing): credits per call and what a plan includes.
- [Sign up](https://strikerapi.com/signup): 500 free credits every month, no card.

### Live odds

- [Premier League odds this week](https://strikerapi.com/odds): This week's Premier League three-way moneylines, goal handicaps and totals by sportsbook, captured daily and every hour for games in the next four days.
- [Premier League player props today](https://strikerapi.com/props): Anytime goalscorer prices for the next Premier League matches, with the best Yes and No price across sportsbooks and how many books post each player.
- [MLS player props today](https://strikerapi.com/props/mls): Anytime goalscorer prices for the next MLS matches, with the best Yes and No price across sportsbooks and how many books post each player.
- [La Liga player props today](https://strikerapi.com/props/la-liga): Anytime goalscorer prices for the next La Liga matches, with the best Yes and No price across sportsbooks and how many books post each player.
- [Serie A player props today](https://strikerapi.com/props/serie-a): Anytime goalscorer prices for the next Serie A matches, with the best Yes and No price across sportsbooks and how many books post each player.
- [Bundesliga player props today](https://strikerapi.com/props/bundesliga): Anytime goalscorer prices for the next Bundesliga matches, with the best Yes and No price across sportsbooks and how many books post each player.
- [Ligue 1 player props today](https://strikerapi.com/props/ligue-1): Anytime goalscorer prices for the next Ligue 1 matches, with the best Yes and No price across sportsbooks and how many books post each player.
- [Champions League player props today](https://strikerapi.com/props/champions-league): Anytime goalscorer prices for the next Champions League matches, with the best Yes and No price across sportsbooks and how many books post each player.

### Other leagues

- [The MLS data API](https://strikerapi.com/mls): MLS matches since 2001: lineups from 2004, box scores and shot maps from 2008 (gap 2010-11), tables, Elo ratings and sportsbook lines from 2017. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/mls
- [The La Liga data API](https://strikerapi.com/la-liga): La Liga matches since 2001-02: lineups and goals for every season, box scores from 2005-06, shot maps from 2012-13, tables, Elo ratings and sportsbook lines. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/laliga
- [The Serie A data API](https://strikerapi.com/serie-a): Serie A matches since 2001-02: lineups and goals for every season, box scores from 2007-08, shot maps from 2012-13, tables, Elo ratings and sportsbook lines. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/seriea
- [The Bundesliga data API](https://strikerapi.com/bundesliga): Bundesliga matches since 2001-02: lineups and goals for every season, box scores from 2006-07, shot maps from 2012-13, tables, Elo ratings and sportsbook lines. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/bundesliga
- [The Ligue 1 data API](https://strikerapi.com/ligue-1): Ligue 1 matches since 2001-02: lineups and goals for every season, box scores from 2006-07, shot maps from 2012-13, tables, Elo ratings and sportsbook lines. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/ligue1
- [The Champions League data API](https://strikerapi.com/champions-league): Champions League matches since 2001-02, qualifying to the final: lineups, goals, box scores, shot maps from 2012-13, group tables, Elo ratings and sportsbook lines. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/ucl
- [The EFL Championship data API](https://strikerapi.com/championship): EFL Championship matches since 2001-02: lineups, goals and player box scores for every season, shot maps from 2008-09, tables, Elo ratings and sportsbook lines from 2018-19. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/championship
- [The NWSL data API](https://strikerapi.com/nwsl): NWSL matches since 2013: lineups and every goal mostly from 2019, box scores, shot maps from 2025, tables, Elo ratings and sportsbook lines from 2023. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/nwsl
- [The Liga MX data API](https://strikerapi.com/liga-mx): Liga MX matches since 2001, Apertura and Clausura in calendar-year seasons: lineups from 2003, shot maps from 2013, Elo ratings and sportsbook lines from 2017. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/ligamx
- [The Europa League data API](https://strikerapi.com/europa-league): Europa League matches since 2009-10, group stage or league phase to the final: lineups, goals, box scores, shot maps, tables, Elo ratings and sportsbook lines from 2017-18. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/uel
- [The Conference League data API](https://strikerapi.com/conference-league): Conference League matches since its first season, 2021-22: lineups, goals, box scores, shot maps, tables, Elo ratings and sportsbook lines from 2023-24. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/uecl
- [The Eredivisie data API](https://strikerapi.com/eredivisie): Eredivisie matches since 2000-01: lineups and goals, box scores and shot maps from 2020-21, tables, Elo ratings and sportsbook lines from 2018-19. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/eredivisie
- [The Primeira Liga data API](https://strikerapi.com/primeira-liga): Primeira Liga matches since 2006-07: lineups for every match, shot maps from 2016-17, tables, Elo ratings and sportsbook lines from 2018-19. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/primeira
- [The Scottish Premiership data API](https://strikerapi.com/scottish-premiership): Scottish Premiership matches since 2001-02: lineups and goals, box scores and shot maps for part of the history, tables, Elo ratings and sportsbook lines from 2018-19. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/scotland
- [The Brazilian Serie A data API](https://strikerapi.com/brazil-serie-a): Brazilian Serie A matches since 2006: lineups, box scores from 2010, shot maps from 2014, tables, Elo ratings and sportsbook lines from 2021. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/brazil
- [The Argentine Liga Profesional data API](https://strikerapi.com/argentina-liga-profesional): Argentine first-division matches since 2000: lineups from 2005, box scores from 2008, shot maps from 2014, Elo ratings and sportsbook lines from 2023. REST and MCP. MCP: https://mcp.strikerapi.com/mcp/argentina

### Datasets

- [Premier League shot location and xG data](https://strikerapi.com/data/premier-league-shot-data): The location, end point, outcome and body part of every Premier League shot charted since 2012-13, with our expected goals. REST or MCP.
- [Premier League match event data](https://strikerapi.com/data/premier-league-match-events): Every Premier League goal and substitution since 2001-02, cards from 2011-12, and from 2012-13 every shot, foul, corner and offside. REST or MCP.
- [Premier League historical odds](https://strikerapi.com/data/soccer-odds-history): Home, draw and away moneylines, goal handicaps and totals from each sportsbook reported with the match, from 2017-18, with the result attached. REST or MCP.
- [Anytime goalscorer prices by sportsbook](https://strikerapi.com/data/player-props): Anytime goalscorer prices by sportsbook for seven competitions, including MLS and the Champions League, since 2024, with the result. REST or MCP.

### Compared with the alternatives

- [The soccer API: free tiers, open data and StrikerAPI](https://strikerapi.com/compare/soccer-api): football-data.org, StatsBomb open data, soccerdata and Understat are free in different ways. Where each fits, what their terms say, and how StrikerAPI differs. (checked 2026-10-14)
- [StrikerAPI vs API-Football](https://strikerapi.com/compare/api-football-alternative): API-Football covers hundreds of competitions with a daily request quota. StrikerAPI covers seventeen, with located shots, our xG, per-book odds history and an MCP server. (checked 2026-10-08)
- [StrikerAPI vs football-data.org](https://strikerapi.com/compare/football-data-org-alternative): football-data.org is a fixtures, results and tables API with a free tier. StrikerAPI adds shot locations, xG, lineups with minutes and per-book odds history. (checked 2026-10-08)
- [StrikerAPI vs Sportmonks](https://strikerapi.com/compare/sportmonks-alternative): Sportmonks covers 2,200+ competitions with plans priced by league count. StrikerAPI covers seventeen, with located shots, our xG and per-book odds history, paid per call. (checked 2026-10-09)
- [StrikerAPI vs scraping FBref](https://strikerapi.com/compare/fbref-scraping): FBref has no public API, and Sports Reference's terms bar scrapers and bulk collection. StrikerAPI serves soccer data over REST and MCP with no scraper to maintain. (checked 2026-10-09)
- [Anytime goalscorer odds history APIs, compared](https://strikerapi.com/compare/anytime-goalscorer-odds-api): Five APIs that serve soccer anytime goalscorer prices, by leagues, history, results, price and MCP support. Checked against each provider's site. (checked 2026-10-21)

### Endpoint pages

- [list_teams](https://strikerapi.com/docs/list-teams): Club ids, abbreviations and colours for a season
- [list_games](https://strikerapi.com/docs/list-games): Fixtures and results by season, stage, date, range or club
- [get_schedule](https://strikerapi.com/docs/get-schedule): Upcoming fixtures with the median three-way line across sportsbooks
- [get_game](https://strikerapi.com/docs/get-game): One match: score, both box scores, every player's line, key events, each book's line
- [get_lineups](https://strikerapi.com/docs/get-lineups): Formations, starting XIs, benches and substitutions with minutes
- [get_standings](https://strikerapi.com/docs/get-standings): The league table: points, deductions, goal difference, home and away, form
- [get_ratings](https://strikerapi.com/docs/get-ratings): Our club Elo ratings, ranked
- [get_head_to_head](https://strikerapi.com/docs/get-head-to-head): Two clubs' meetings: record, goals and every result
- [search_players](https://strikerapi.com/docs/search-players): Find players by name
- [get_player](https://strikerapi.com/docs/get-player): Profile, per-season totals and per-90 rates, last 10 matches
- [get_player_games](https://strikerapi.com/docs/get-player-games): A player's full match log
- [get_leaders](https://strikerapi.com/docs/get-leaders): Season leaders: goals, assists, shots, xG, cards, saves
- [get_team_stats](https://strikerapi.com/docs/get-team-stats): Per-match averages: goals, xG, shots, possession (missing for some leagues and seasons), passing, discipline, for and against
- [get_events](https://strikerapi.com/docs/get-events): Match events: goals, cards, substitutions, shots with location and xG, fouls, corners
- [get_shot_map](https://strikerapi.com/docs/get-shot-map): Shot map for a club, player or defence: every located shot with outcome and xG, plus zone totals
- [get_odds](https://strikerapi.com/docs/get-odds): Every sportsbook's three-way moneyline, goal handicap and total for a match (5) or a day (10), with results
- [get_line_movement](https://strikerapi.com/docs/get-line-movement): Snapshots of each sportsbook's line before kick-off
- [get_player_props](https://strikerapi.com/docs/get-player-props): Anytime goalscorer prices by sportsbook (one pre-kick-off capture per price)
- [get_prop_history](https://strikerapi.com/docs/get-prop-history): A player's anytime goalscorer price against whether he scored, match by match

### Metric definitions

- [Expected goals (xG)](https://strikerapi.com/glossary/expected-goals): The chance a shot is scored, from where it was taken and whether it was a header, fitted on the league's own history.
- [Shot map](https://strikerapi.com/glossary/shot-map): Every shot a team or player took, or a team conceded, drawn where it was taken, with its outcome and xG.
- [Conversion rate](https://strikerapi.com/glossary/conversion-rate): Goals divided by shots: how often a team's or a player's shots go in.
- [Per 90 minutes](https://strikerapi.com/glossary/per-90): A player's totals scaled to one full match, so starters and substitutes can be compared on rates.
- [Three-way moneyline](https://strikerapi.com/glossary/three-way-moneyline): The match-result market: one price on the home win, one on the draw and one on the away win.
- [Goal handicap](https://strikerapi.com/glossary/asian-handicap): A head start in goals given to one side so the market has two outcomes: -0.5 means the home side must win.
- [Closing line](https://strikerapi.com/glossary/closing-line): A sportsbook's last price before kick-off, the market's most informed view of a match.
- [Anytime goalscorer price](https://strikerapi.com/glossary/anytime-goalscorer): A sportsbook's price that a named player scores at least once in the match: one Yes price, with no line.
- [Elo rating](https://strikerapi.com/glossary/elo-rating): A club strength rating that moves after every match by how surprising the result was.
- [xG difference](https://strikerapi.com/glossary/xg-difference): A team's expected goals for minus expected goals against: the quality of the chances it makes and allows.
- [Clean sheet](https://strikerapi.com/glossary/clean-sheet): A match in which a team concedes no goals; for a goalkeeper, a start in which his side conceded none.

### By what you are building

- [Analysts and researchers](https://strikerapi.com/for/analysts): Every located shot since 2012-13 with outcome, body part and our expected goals, joined to lineups, box scores and tables.
- [Bettors and modelers](https://strikerapi.com/for/bettors): Home, draw and away moneylines, goal handicaps and totals by sportsbook from 2017-18, joined to the result, our Elo and xG.
- [Developers and AI builders](https://strikerapi.com/for/developers): REST and MCP over the Premier League, MLS, La Liga, Serie A, the Bundesliga, Ligue 1, the Champions League, the EFL Championship, the NWSL, Liga MX, the Europa League, the Conference League, the Eredivisie, the Primeira Liga, the Scottish Premiership, Brazil's Serie A and Argentina's Liga Profesional, with stable ids.

### Code guides

Python, JavaScript and cURL for common questions, each run against the live API (code verified 2026-10-12). Index: https://strikerapi.com/guides

- [How do I make a Premier League xG shot map in Python?](https://strikerapi.com/guides/premier-league-xg-shot-map-python): Every located shot a club took in a season, with player, outcome, body part, expected goals and pitch coordinates, plus totals by zone. Tool: get_shot_map.
- [How do I build a Premier League expected goals table in pandas?](https://strikerapi.com/guides/premier-league-xg-table-pandas): Per-match goals, expected goals, shots, possession and passing for all 20 clubs, for or against, in one call. Tool: get_team_stats.
- [Where can I get football Elo ratings by club in Python?](https://strikerapi.com/guides/soccer-elo-ratings-python): Our Elo rating for every club, ranked, as of any date you pass, with the method written out in the response. Tool: get_ratings.
- [Who leads the Premier League in expected goals, and how do I rank players in Python?](https://strikerapi.com/guides/premier-league-top-scorers-xg-python): A season leaderboard on any stat we compute or keep, with expected goals ranked by total or per 90 and a minimum number of appearances. Tool: get_leaders.
- [How do I get Premier League odds from every sportsbook with the results?](https://strikerapi.com/guides/premier-league-odds-and-results-python): A day of matches with each sportsbook's three-way moneyline, goal handicap and total, opening and closing, next to the result. Tool: get_odds.
- [How do I get anytime goalscorer odds and results for a player in Python?](https://strikerapi.com/guides/soccer-anytime-goalscorer-odds-python): One row per match with a striker's anytime goalscorer price, the number of books and whether he scored. Erling Haaland scored in 20 of 34 priced matches. Tool: get_prop_history.
- [How do I turn three-way soccer odds into probabilities in Python?](https://strikerapi.com/guides/soccer-three-way-odds-to-probabilities-python): A club's season of matches with every sportsbook's home, draw and away closing price. This removes the margin to get probabilities and scores them against the results. Tool: get_odds.
- [How do I get Premier League standings in Python?](https://strikerapi.com/guides/premier-league-standings-python): The Premier League table for 2026-27: record, goals, points and recent form for all 20 clubs. Manchester City and Arsenal led on 15 points. Tool: get_standings.
- [How do I get Premier League scores and fixtures in Python?](https://strikerapi.com/guides/premier-league-scores-and-fixtures-python): Every Premier League match on a date with score, result and attendance. October 10 had six matches and 3.33 goals per match. Tool: list_games.
- [How do I get a Premier League player's match stats in Python?](https://strikerapi.com/guides/premier-league-player-match-log-python): A player's Premier League match log with minutes, goals, shots and xG. Erling Haaland had 5 goals from 3.87 xG in five matches. Tool: get_player_games.

### Claude skills

16 free Claude skills (SKILL.md files) wired to these tools: https://github.com/noahowsh/strikerapi-mcp/tree/main/skills. Overview: https://strikerapi.com/skills

- match-lookup (Data Exploration): Fixtures, results, box scores, lineups and match events.
- team-analysis (Data Exploration): Table, form, home and away splits, xG for and against.
- player-scouting (Data Exploration): Per-90 profiles, leaders, match logs and finishing vs xG.
- odds-explorer (Data Exploration): Three-way prices, best book, margin and line movement.
- xg-analysis (Soccer Analytics): Shot maps, xG tables, expected points and finishing.
- elo-ratings (Soccer Analytics): Club Elo ratings, win probabilities and custom Elo builds.
- poisson-score-models (Soccer Analytics): Poisson and Dixon-Coles scorelines, totals and handicaps.
- odds-analysis (Methodology): Three-way devigging: proportional, power and Shin.
- walk-forward-validation (Methodology): Leak-free splits, point-in-time features, RPS vs the close.
- probability-calibration (Methodology): Per-class reliability, RPS and scaling for home/draw/away.
- edge-detection (Betting): Model vs devigged market, EV, fractional Kelly and CLV.
- backtesting (Betting): Strategy tests at real opening and closing prices.
- goalscorer-prop-modeling (Betting): Anytime goalscorer probabilities vs sportsbook prices.
- match-preview (Workflow): One-fixture preview: form, xG, Elo, head to head and the line.
- strikerapi-tool (Infrastructure): All 19 tools, credits, REST and MCP access, the data envelope.
- dispatch (Infrastructure): Routes a request to the right two or three skills.