# StrikerAPI

> The soccer data API. 17 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

## 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`
- 500 free credits on signup, 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 calendar year. Team codes like ARS, LIV, MNC (or an ESPN team id); list_teams has them. Match ids like 704345 (an ESPN match id; find them with list_games).

## 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, 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)

### Time-series
- Daily 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

## 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.
- [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.
- [Pricing](https://strikerapi.com/pricing): credits per call and what a plan includes.
- [Sign up](https://strikerapi.com/signup): 500 free credits, 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 from the sportsbooks ESPN reports, refreshed daily.

### 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

### 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 ESPN 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 ESPN reports, from 2017-18, with the result attached. REST or MCP.

### Compared with the alternatives

- [StrikerAPI vs API-Football](https://strikerapi.com/compare/api-football-alternative): API-Football covers hundreds of competitions with a daily request quota. StrikerAPI covers seven, with located shots, our xG, per-book odds history and an MCP server.
- [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.

### 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, 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): Daily snapshots of each sportsbook's line before kick-off

### 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.
- [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 and the Champions League, with stable ids.