Player Props API

What is a player props API?

A player props API provides programmatic access to player-level betting lines from sportsbooks. Instead of manually checking odds on betting sites, developers can pull structured data for individual player markets — like how many strikeouts a pitcher will throw, how many points a basketball player will score, or whether a hockey player will score a goal.

PropLine's API delivers this data in real time, refreshing every 60 seconds (30s for in-progress games), in a clean JSON format that's compatible with the-odds-api. This makes it easy to build betting tools, analytics dashboards, line shopping apps, and prop betting models.

Prop resolution — did the bet win?

PropLine is the only player props API that tells you whether each prop bet won, lost, or pushed. After games complete, we automatically cross-reference actual player stats from official box scores against every recorded prop line.

This means you can build backtesting tools, track betting records, identify profitable trends, and verify results — all from a single API. No more manually checking box scores or maintaining your own stats database.

{
  "key": "pitcher_strikeouts",
  "description": "Total Strikeouts - Tarik Skubal (DET)",
  "outcomes": [
    {
      "name": "Over",
      "description": "Tarik Skubal (DET)",
      "point": 6.5,
      "resolution": "won",
      "actual_value": 7.0
    }
  ]
}

Prop resolution is a paid feature starting at the Hobby tier ($9/mo) via the /results endpoint.

Official SDKs

Install the official client and start pulling props in 5 lines of code.

pip install propline

from propline import PropLine

client = PropLine("your_api_key")
events = client.get_events("basketball_nba")
odds = client.get_odds("basketball_nba",
    event_id=events[0]["id"],
    markets=["player_points", "player_rebounds"])

npm install propline

import { PropLine } from "propline";

const client = new PropLine("your_api_key");
const events = await client.getEvents("basketball_nba");
const odds = await client.getOdds("basketball_nba", {
  eventId: events[0].id,
  markets: ["player_points", "player_rebounds"],
});

Frequently asked questions