# EndzoneAPI

> The football data API. 20 football data tools for AI agents. REST API + MCP server.

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

## Quick Start

- API base URL: https://mcp.endzoneapi.com
- Auth: `Authorization: Bearer YOUR_API_KEY` or `x-api-key: YOUR_API_KEY`
- MCP server: `https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY`
- Python client: `pip install endzoneapi` (https://pypi.org/project/endzoneapi/). Reads ENDZONEAPI_API_KEY.
- 500 free credits every month, no credit card required
- REST API responses include `X-Credits-Used` and `X-Credits-Remaining` headers
- Seasons: 4-digit season year, the year the regular season starts (2025 for the 2025-26 season). Team codes like KC, BUF, PHI, SF. Game ids like 2025_01_KC_BUF (season_week_away_home).

## 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.
- EndzoneAPI is independent, not an official league partner, and grants no league rights.
- Full answers: https://endzoneapi.com/docs/timing-and-rights

## Which Tool Should I Use?

### Static reference
- All 32 teams with conference, division, colours, and logos -> list_teams (1 cr)

### Basic lookup
- Standings and playoff seeding by the NFL tiebreaking procedure, with the step that decided each rank -> get_standings (2 cr)
- Upcoming games by week or for the next N days -> get_schedule (2 cr)
- Find players by name, team, or position -> search_players (2 cr)
- Injury report by team and week with practice and game status -> get_injuries (2 cr)
- Team depth chart by week -> get_depth_chart (2 cr)

### Stats + aggregation
- Team totals and per-week lines with EPA, success rate, and situational splits -> get_team_stats (5 cr)
- Query games by season, week, team, date, type, or status, with closing lines -> get_games (5 cr)
- Weekly and season stat lines for one player: passing, rushing, receiving, defense, kicking, fantasy -> get_player_stats (5 cr)
- Leaderboard for any stat, filtered by position, team, and season -> get_player_leaders (5 cr)
- Offensive, defensive, and special-teams snaps and shares by game or player -> get_snap_counts (5 cr)
- Next Gen Stats tracking metrics and Pro Football Reference advanced stats -> get_advanced_stats (5 cr)

### Multi-table
- Full game detail with team stats, starting QBs, odds, weather, and officials -> get_game_detail (10 cr)
- Matchup history with win/loss records and margins -> get_head_to_head (10 cr)
- Play-by-play with EPA, win probability, situation filters -> get_plays (10 cr)
- Odds by game with bookmaker filters -> get_odds (10 cr)
- Player prop lines by sportsbook, opening and closing -> get_player_props (10 cr)
- A player's prop lines against the result, game by game -> get_prop_history (10 cr)
- Alternate spreads and totals by sportsbook: every point on the ladder, opening and closing, from the 2023 season to the current one -> get_alt_lines (10 cr)

### Time-series
- Time-series odds grouped by bookmaker -> get_line_movement (25 cr)

## Intents

- "I want a list of all teams and their codes" -> list_teams
- "Who is leading the AFC East?" -> get_standings
- "What games are on this week?" -> get_schedule
- "Give me every game from the 2024 season with closing lines" -> get_games
- "What happened in the Chiefs vs Chargers opener?" -> get_game_detail
- "How have the Bills done against the Chiefs recently?" -> get_head_to_head
- "Find Patrick Mahomes' player id" -> search_players
- "Show me a player's weekly stat lines this season" -> get_player_stats
- "Which quarterbacks have the best EPA?" -> get_player_leaders
- "How efficient is this team's offense week to week?" -> get_team_stats
- "How much separation is this receiver getting?" -> get_advanced_stats
- "How often was this quarterback pressured?" -> get_advanced_stats
- "How does this offense do on third down?" -> get_plays
- "Which plays came in the red zone?" -> get_plays
- "Who is out this week for Kansas City?" -> get_injuries
- "Who is the starting left tackle?" -> get_depth_chart
- "How many snaps did the rookie play?" -> get_snap_counts
- "Give me all third-down plays for an offense" -> get_plays
- "What is the spread on the Chiefs game?" -> get_odds
- "How did the line move before kickoff?" -> get_line_movement
- "What was the closing passing-yards line for this quarterback every week?" -> get_player_props
- "Which book had the best anytime touchdown price?" -> get_player_props
- "What did KC -10.5 pay at each book before kickoff?" -> get_alt_lines
- "How often does this player go over his receiving yards line?" -> get_prop_history

## Pages

- [Docs](https://endzoneapi.com/docs): every endpoint, with parameters and a live example response.
- [Data changelog](https://endzoneapi.com/changelog): when each dataset was last refreshed and what it runs through, read from the database.
- [Status](https://endzoneapi.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://endzoneapi.com/docs/atlas): what exists, which endpoints expose it, and where coverage is partial.
- [Teams](https://endzoneapi.com/teams): a page per club with its record, season figures and recent games.
- [Players](https://endzoneapi.com/players): a page per NFL player with prop history: the over/under record against the closing line in each market (passing, rushing and receiving yards, receptions, anytime touchdown and more) and the last games.
- [Data timing and rights](https://endzoneapi.com/docs/timing-and-rights): what timestamps mean, when each dataset updates, whether lines are pre-game, and what the terms allow.
- [Pricing](https://endzoneapi.com/pricing): credits per call and what a plan includes.
- [Sign up](https://endzoneapi.com/signup): 500 free credits every month, no card.

### Live odds

- [NFL odds this week](https://endzoneapi.com/odds): This week's NFL spreads, totals and moneylines from tracked sportsbooks, refreshed hourly.
- [NFL player props this week](https://endzoneapi.com/props): This week's NFL player props: passing, rushing and receiving yards, receptions, passing TDs and anytime TD, with the consensus line and the best over and under price across sportsbooks.

### Other leagues

- [The college football API.](https://endzoneapi.com/college-football): FBS college football as an API: scores and ranks, box scores, play-by-play with win probability, standings, Elo, sportsbook lines from 2012, player props and alternate lines from 2023. REST and MCP. MCP: https://mcp.endzoneapi.com/mcp/ncaaf
- [The FCS football API.](https://endzoneapi.com/fcs-football): FCS college football as an API: scores, box scores, play-by-play with win probability, conference standings, player lines and sportsbook lines from 2017. REST and MCP. MCP: https://mcp.endzoneapi.com/mcp/fcs

### Datasets

- [NFL historical odds and closing lines](https://endzoneapi.com/data/historical-odds): Closing spread and total for every NFL game since 1999, moneyline since 2010, a whole season in one call. REST or MCP, 500 free credits every month.
- [NFL player props by sportsbook, 2023 on](https://endzoneapi.com/data/player-props): NFL player prop lines from 7 sportsbooks since 2023: yards, receptions, passing TDs and anytime TD, opening and closing. REST or MCP, 500 free credits every month.
- [NFL advanced stats: Next Gen Stats and PFR metrics](https://endzoneapi.com/data/advanced-stats): NFL Next Gen Stats since 2016 and PFR advanced stats since 2018, per player per week, plus snap counts. REST or MCP, 500 free credits every month.
- [NFL play-by-play data with EPA](https://endzoneapi.com/data/play-by-play): Every NFL play since 1999 with EPA, win probability and the full set of model columns, filterable by team, down, play type and win probability. REST or MCP.
- [NFL injury report data](https://endzoneapi.com/data/injury-data): Every weekly NFL injury report since 2009: game status, practice participation and the injury, by team and week. REST or MCP, 500 free credits every month.

### Compared with the alternatives

- [The NFL API: free data, community docs and EndzoneAPI](https://endzoneapi.com/compare/nfl-api): The NFL has no public API. nflverse files and ESPN's unofficial endpoints are free. Where each fits, what the community docs cover, and how EndzoneAPI differs. (checked 2026-10-14)
- [EndzoneAPI vs SportsDataIO for NFL data](https://endzoneapi.com/compare/sportsdataio-alternative): SportsDataIO sells real-time NFL feeds with production pricing through sales. EndzoneAPI is self-serve historical and in-season data from $19/mo, with an MCP server. (checked 2026-10-07)
- [EndzoneAPI vs nflverse and nflfastR](https://endzoneapi.com/compare/nflfastr-api): nflverse is free, CC-BY data you load as files in R or Python. EndzoneAPI serves play-by-play, EPA and closing lines over HTTP and MCP, filtered per request. (checked 2026-09-26)
- [EndzoneAPI vs ESPN's hidden API](https://endzoneapi.com/compare/espn-api-alternative): ESPN's sports API is unofficial and undocumented, and its hosts change without notice. EndzoneAPI is documented NFL data with EPA and closing lines since 1999. (checked 2026-09-26)
- [Historical NFL player prop odds APIs, compared](https://endzoneapi.com/compare/nfl-player-prop-odds-api): Six APIs that serve NFL player props, by what history they keep, whether they return results, books, price and MCP support. Checked against each provider's site. (checked 2026-10-19)

### Endpoint pages

- [list_teams](https://endzoneapi.com/docs/list-teams): All 32 teams with conference, division, colours, and logos
- [get_standings](https://endzoneapi.com/docs/get-standings): Standings and playoff seeding by the NFL tiebreaking procedure, with the step that decided each rank
- [get_team_stats](https://endzoneapi.com/docs/get-team-stats): Team totals and per-week lines with EPA, success rate, and situational splits
- [get_games](https://endzoneapi.com/docs/get-games): Query games by season, week, team, date, type, or status, with closing lines
- [get_schedule](https://endzoneapi.com/docs/get-schedule): Upcoming games by week or for the next N days
- [get_game_detail](https://endzoneapi.com/docs/get-game-detail): Full game detail with team stats, starting QBs, odds, weather, and officials
- [get_head_to_head](https://endzoneapi.com/docs/get-head-to-head): Matchup history with win/loss records and margins
- [search_players](https://endzoneapi.com/docs/search-players): Find players by name, team, or position
- [get_player_stats](https://endzoneapi.com/docs/get-player-stats): Weekly and season stat lines for one player: passing, rushing, receiving, defense, kicking, fantasy
- [get_player_leaders](https://endzoneapi.com/docs/get-player-leaders): Leaderboard for any stat, filtered by position, team, and season
- [get_injuries](https://endzoneapi.com/docs/get-injuries): Injury report by team and week with practice and game status
- [get_depth_chart](https://endzoneapi.com/docs/get-depth-chart): Team depth chart by week
- [get_snap_counts](https://endzoneapi.com/docs/get-snap-counts): Offensive, defensive, and special-teams snaps and shares by game or player
- [get_plays](https://endzoneapi.com/docs/get-plays): Play-by-play with EPA, win probability, situation filters
- [get_advanced_stats](https://endzoneapi.com/docs/get-advanced-stats): Next Gen Stats tracking metrics and Pro Football Reference advanced stats
- [get_odds](https://endzoneapi.com/docs/get-odds): Odds by game with bookmaker filters
- [get_line_movement](https://endzoneapi.com/docs/get-line-movement): Time-series odds grouped by bookmaker
- [get_player_props](https://endzoneapi.com/docs/get-player-props): Player prop lines by sportsbook, opening and closing
- [get_prop_history](https://endzoneapi.com/docs/get-prop-history): A player's prop lines against the result, game by game
- [get_alt_lines](https://endzoneapi.com/docs/get-alt-lines): Alternate spreads and totals by sportsbook: every point on the ladder, opening and closing, from the 2023 season to the current one

### Metric definitions

- [EPA](https://endzoneapi.com/glossary/epa): How much a single play changed the number of points its team could expect to score next: the closest thing football has to a universal currency.
- [Success rate](https://endzoneapi.com/glossary/success-rate): The share of plays that gained enough to keep the drive on schedule. EPA's blunt, stable cousin.
- [Win probability](https://endzoneapi.com/glossary/win-probability): The chance a team wins from the state the game is in right now.
- [CPOE](https://endzoneapi.com/glossary/cpoe): How often a passer completes throws compared with what the throw itself justified.
- [Air yards](https://endzoneapi.com/glossary/air-yards): How far downfield the ball travelled before it was caught or fell: opportunity, measured before the catch.
- [Snap share](https://endzoneapi.com/glossary/snap-share): The share of his team's offensive or defensive snaps a player was on the field for. The first thing to check before anything else.
- [Yards after catch](https://endzoneapi.com/glossary/yards-after-catch): Yards a receiver gains once the ball is in his hands, as opposed to the yards the throw travelled.
- [Time to throw](https://endzoneapi.com/glossary/time-to-throw): Seconds from the snap until the ball leaves the quarterback's hand, measured by tracking rather than charted by hand.
- [Closing line](https://endzoneapi.com/glossary/closing-line): The last price a market offered before kickoff, and the most accurate public forecast of a game that exists.
- [Point differential](https://endzoneapi.com/glossary/point-differential): Points scored minus points allowed. A better guide to a team's next game than its record is.
- [Passer rating](https://endzoneapi.com/glossary/passer-rating): The league's own quarterback formula, built from four rate stats and capped at 158.3.
- [Win probability added](https://endzoneapi.com/glossary/win-probability-added): How much a single play moved a team's chance of winning that specific game: the change in win probability, play by play.

### By what you are building

- [Analysts and researchers](https://endzoneapi.com/for/analysts): 1.2 million plays with expected points and win probability, plus Next Gen Stats tracking in the same database.
- [Bettors and modellers](https://endzoneapi.com/for/bettors): Every game carries a closing spread, and the play-by-play underneath is already priced in EPA and win probability.
- [Developers](https://endzoneapi.com/for/developers): REST for code, MCP for Claude and Cursor: 20 tools, one key, no scraping.
- [Fantasy players](https://endzoneapi.com/for/fantasy): Snap shares, air yards, depth charts and injury status: the leading indicators, not last week's box score.

### Code guides

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

- [How do I backtest NFL closing lines in Python?](https://endzoneapi.com/guides/backtest-nfl-closing-lines-python): Every regular-season game with its score and the closing spread, total and moneylines on the same row, so a cover or over rate is one line of pandas. Tool: get_games.
- [How do I calculate NFL EPA per play in Python?](https://endzoneapi.com/guides/nfl-epa-per-play-python): Every play a team ran in a season with expected points added, win probability and success on each row, and a summary the API computes for you. Tool: get_plays.
- [How do I get an NFL player's weekly stats in Python?](https://endzoneapi.com/guides/nfl-player-weekly-stats-python): A quarterback's season as one row per game, with passing, rushing and fantasy columns, plus the season totals, from a single call. Tool: get_player_stats.
- [How do I get NFL Next Gen Stats in Python?](https://endzoneapi.com/guides/nfl-next-gen-stats-python): Season passing tracking metrics for every qualifying quarterback: time to throw, air yards, aggressiveness and completion percentage above expectation. Tool: get_advanced_stats.
- [How do I compare NFL player prop lines across sportsbooks?](https://endzoneapi.com/guides/nfl-player-prop-lines-by-sportsbook-python): The closing passing-yards line for one quarterback in one game at every book that posted it, with the over and under prices. Tool: get_player_props.
- [How do I track NFL spread and total movement in Python?](https://endzoneapi.com/guides/nfl-line-movement-spread-total-python): Time-stamped snapshots of every sportsbook's spread, total and moneyline for a game. This keeps the last week before kickoff and prints how each book moved. Tool: get_line_movement.
- [How often does an NFL quarterback go over his passing yards line?](https://endzoneapi.com/guides/nfl-passing-yards-prop-history-python): One row per game with a quarterback's closing and opening yards line, the price, what he threw for and whether he went over. Josh Allen went over in 10 of 18. Tool: get_prop_history.
- [How do I get NFL scores and the schedule for a week in Python?](https://endzoneapi.com/guides/nfl-scores-and-schedule-by-week-python): All 16 games of NFL week 4 with final scores, kickoff day, stadium and starting quarterbacks in one call. The week averaged 47.8 points a game. Tool: get_schedule.
- [How do I get NFL standings in Python?](https://endzoneapi.com/guides/nfl-standings-python): The NFL table for 2026: record, point differential, streak and playoff seed for all 32 teams. Kansas City and Minnesota, both 4-0, held the top seeds. Tool: get_standings.
- [How do I get the NFL injury report in Python?](https://endzoneapi.com/guides/nfl-injury-report-python): Every player ruled Out on the week 5 NFL injury report: 92 players, with team, position and the injury named. Hamstring was the most common at 21. Tool: get_injuries.
- [How often does an NFL receiver go over his receiving yards line?](https://endzoneapi.com/guides/nfl-receiving-yards-prop-history-python): One row per game with a receiver's opening and closing yards line, the price, what he gained and whether he went over. Ja'Marr Chase went over in 10 of 16. Tool: get_prop_history.
- [How often does an NFL player score when he is priced to?](https://endzoneapi.com/guides/nfl-anytime-touchdown-prop-history-python): One row per game with a player's anytime touchdown price, his touchdowns and whether he scored, to compare the odds with what happened. Derrick Henry scored in 9 of 17. Tool: get_prop_history.
- [How often does an NFL running back go over his rushing yards line?](https://endzoneapi.com/guides/nfl-rushing-yards-prop-history-python): One row per game with a back's opening and closing rushing line, the price, his yards and whether he went over. Derrick Henry averaged 94 yards against an 84 line. Tool: get_prop_history.
- [How often does an NFL receiver go over his receptions line?](https://endzoneapi.com/guides/nfl-receptions-prop-history-python): One row per game with a receiver's receptions line, the price, his catches and whether he went over. Amon-Ra St. Brown went over in 10 of 16 last season. Tool: get_prop_history.
- [How often does an NFL quarterback go over his passing touchdowns line?](https://endzoneapi.com/guides/nfl-passing-touchdowns-prop-history-python): One row per game with a quarterback's passing touchdowns line, the price, how many he threw and whether he went over. Josh Allen went over in 10 of 18. Tool: get_prop_history.

### Claude skills

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

- game-lookup (Data Exploration): Games, schedules, scores, standings and playoff seeding.
- player-scouting (Data Exploration): Player search, weekly stats, leaders, snaps and usage.
- odds-explorer (Data Exploration): Multi-book lines, line movement, alternate ladders, key numbers.
- game-preview (Data Exploration): Pre-game brief: form, efficiency, injuries, rest, weather, lines.
- epa-analysis (Football Analytics): EPA per play, success rate, situational splits, team and unit rankings.
- next-gen-stats (Football Analytics): Time to throw, CPOE, rush yards over expected, separation, pressure.
- college-football (Football Analytics): FBS and FCS: ranks, Elo, plays, lines, and what differs from the NFL.
- feature-engineering (Methodology): Leak-free rolling EPA, opponent adjustment, QB and rest features, Elo.
- walk-forward-validation (Methodology): Time-ordered model testing against the closing line baseline.
- probability-calibration (Methodology): Reliability tables, Brier, log loss, Platt scaling with small samples.
- odds-analysis (Methodology): American odds, devigging methods, hold, EV and break-even rates.
- edge-detection (Betting): Model vs devigged market, EV, shrinkage and fractional Kelly.
- backtesting (Betting): Honest strategy tests on closing lines, ROI intervals, CLV vs Pinnacle.
- prop-modeling (Betting): Player props: usage, game script, distributions, prop history over rates.
- dispatch (Workflow): Routes a football request to the right 2-3 skills.
- endzoneapi-tool (Infrastructure): Every tool, credit cost, coverage by season, REST and MCP setup.