EndzoneAPI for Python

Python client for the EndzoneAPI NFL data API. It has no required dependencies (standard library only) and works on Python 3.9 and newer. Pandas is optional.

Install

pip install endzoneapi
pip install "endzoneapi[pandas]"   # only if you want DataFrames

Set your key

Get a free key at https://endzoneapi.com/signup. Free accounts get 500 credits a month.

export ENDZONEAPI_API_KEY=your_key_here

from endzoneapi import Client

client = Client()                      # reads ENDZONEAPI_API_KEY
client = Client(api_key="your_key")    # or pass it in

Examples

1. Player props for one game

get_player_props returns every player's line, by sportsbook, for one market. Pass estimate_only=True first to see the credit cost without being charged.

from endzoneapi import Client, to_dataframe

client = Client()

print(client.get_player_props(game_id="2025_01_KC_LAC", estimate_only=True))

props = client.get_player_props(
    game_id="2025_01_KC_LAC",
    market="player_pass_yds",
    bookmaker="draftkings",
)
df = to_dataframe(props, key="props")
print(df[["player_name", "line", "over_odds", "under_odds"]])

2. Props for every game in a week

Loop over a week of games and stack the results. This is the usual shape of a props model's data pull.

import pandas as pd
from endzoneapi import Client, to_dataframe

client = Client()

games = client.get_games(season=2025, week=1, limit=2)["games"]
frames = []
for game in games:
    props = client.get_player_props(game_id=game["game_id"], market="player_rush_yds")
    frames.append(to_dataframe(props, key="props"))
week = pd.concat(frames, ignore_index=True)
print(len(week), "lines from", len(games), "games")
print(week.groupby("bookmaker").size())

3. Find a player, then pull his stats

Player ids are GSIS ids. search_players finds them by name.

from endzoneapi import Client

client = Client()

mahomes = client.search_players("Mahomes", limit=1)["players"][0]
stats = client.get_player_stats(mahomes["player_id"], season=2025)
print(mahomes["name"], mahomes["team"])
print(stats)

Credits

Every method returns the data object from the response. After each call, client.last_credits_used and client.last_credits_remaining hold the counters from the X-Credits-Used and X-Credits-Remaining headers. Methods that take estimate_only=True return the price of a call without running or charging it.

Pandas

from endzoneapi import to_dataframe

df = to_dataframe(data)                # finds the main list in the response
df = to_dataframe(data, key="rows")    # or name the list yourself

Nested fields become dotted columns. Install pandas separately or with pip install "endzoneapi[pandas]".

Errors

Every error is an APIError subclass, with the server's message and the HTTP status.

from endzoneapi import Client, APIError, InsufficientCreditsError, RateLimitError

client = Client()
try:
    data = client.list_teams()
except InsufficientCreditsError:
    print("Out of credits, top up at https://endzoneapi.com")
except RateLimitError as exc:
    print("Slow down, retry after", exc.retry_after)
except APIError as exc:
    print(exc.status_code, exc.message)

The client retries 429 and 5xx responses and connection failures up to 3 times with backoff, and honors Retry-After. Set Client(max_retries=0) to turn that off.

If you see CERTIFICATE_VERIFY_FAILED on a python.org install for macOS, run the "Install Certificates.command" script that came with Python, or pip install certifi (the client uses it when present).

Options

Client(
    api_key=None,                          # defaults to $ENDZONEAPI_API_KEY
    base_url="https://mcp.endzoneapi.com",           # point at another host
    timeout=60.0,                          # seconds per request
    max_retries=3,
)

client.call("tool_name", {"arg": "value"}) calls any tool by name, which helps when the API adds a tool before this package does.

Tools

Method names match the API tool names. Arguments are keyword arguments; required ones can also be passed positionally. Each method's docstring lists its arguments (help(client.list_teams)).

Full API reference: https://endzoneapi.com/docs

License

MIT