propzapi

Python client for propzapi, the props-first sports odds API.

Player props, game odds, fixtures and live scores as clean JSON. No scraping, no per-sportsbook parsers.

pip install propzapi

Get a key

Free tier is 500 credits a month, no card. Grab one from propzapi.com/app, or mint one in code:

from propzapi import register

print(register())
# {'api_key': 'pk_live_...', 'plan': 'free', 'credits': 500}

Quickstart

from propzapi import Propzapi

client = Propzapi("pk_live_...")        # or set PROPZAPI_API_KEY

# Player props, the thing most odds APIs cover thinly
props = client.props(league="NFL", market="player_passing_yards")

# Game odds grouped by book
odds = client.odds(league="NBA", market="h2h")

# Fixtures and live scores
games = client.events(league="NBA", status="live")

# What each call cost you
print(client.last_credits_cost)

Player props

Props are the point of this API. Markets are named player_<stat>:

Leave market unset to get every prop on the slate.

for event in client.props(league="NBA", market="player_points"):
    for book in event["books"]:
        print(event["home_team"], book["book"], book["markets"])

Methods

market on odds() takes h2h, spreads, totals or player_props. Leave it unset for all game markets together.

Credits

propzapi meters by market and returns the exact cost of each call in an X-Credits-Cost header. The client reads it for you:

client.props(league="NFL")
client.last_credits_cost     # what that call actually cost
client.last_response         # the full payload, if you want the rest

Errors

Everything raises PropzapiError, with the status code attached:

from propzapi import Propzapi, PropzapiError

try:
    client.props(league="NFL")
except PropzapiError as e:
    print(e.status)   # 401 bad key, 402 out of credits, 429 rate limited
    print(e.payload)  # decoded body when there is one

Notes

• Not a sportsbook. propzapi is a data provider and takes no wagers.
• Bring your own requests.Session if you want retries or connection reuse: Propzapi(key, session=my_session).

Links

• Docs
• Build an NFL player props model
• Odds API vs web scraping

License

MIT