Skip to content

get_player_props

10 creditsMulti-tablePOST /v1/get_player_props

Data refreshed · changelog

Player prop lines by sportsbook, opening and closing

Use it when you are backtesting or shopping player props: every book's over/under on passing, rushing and receiving yards, receptions, passing TDs and anytime TD for a game, or one player's lines across a season, with the opening or closing price. From the 2023 season.

Parameters

game_idstringoptional
Game id, e.g. 2025_01_KC_LAC.
player_idstringoptional
GSIS player id (00-00XXXXX) from search_players. With season: that player's props across the season.
seasonstring | numberoptional
Season year, with player_id.
marketenum: player_pass_yds | player_pass_tds | player_pass_completions | player_pass_attempts | player_pass_interceptions | player_rush_yds | player_rush_attempts | player_reception_yds | player_receptions | player_anytime_td | player_tds_over | player_1st_td | player_pass_longest_completion | player_rush_longest | player_reception_longestoptional
One market: player_pass_yds (passing yards), player_pass_tds (passing touchdowns), player_pass_completions (pass completions), player_pass_attempts (pass attempts), player_pass_interceptions (interceptions thrown), player_rush_yds (rushing yards), player_rush_attempts (rush attempts), player_reception_yds (receiving yards), player_receptions (receptions), player_anytime_td (anytime touchdown (over = scores)), player_tds_over (touchdowns scored), player_1st_td (first touchdown scorer (over = scores the game's first touchdown)), player_pass_longest_completion (longest completion), player_rush_longest (longest rush), player_reception_longest (longest reception)
bookmakerstringoptional
Bookmaker key, e.g. draftkings, fanduel, pinnacle.
snapshot_typeenum: opening | closingoptional
closing (default): the last line before kickoff. opening: the first one captured.
estimate_onlybooleanoptional
Return what this call would cost, without charging or running it.

Notes

  • Over MCP, ask for it in plain English and the client calls get_player_props itself. Point any MCP client at https://mcp.endzoneapi.com/mcp?key=YOUR_API_KEY.
  • It costs 10 credits a game before it starts and 20 once it has been played (accounts opened before October 30 2026 pay 10 for every game), taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.endzoneapi.com/v1/get_player_props \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "2025_01_KC_LAC",
  "market": "player_pass_yds"
}'

Response

json
{
  "snapshot_type": "closing",
  "games": 1,
  "props": [
    {
      "game_id": "2025_01_KC_LAC",
      "player_name": "Justin Herbert",
      "gsis_id": "00-0036355",
      "market": "player_pass_yds",
      "bookmaker": "betmgm",
      "line": 236.5,
      "over_odds": -115,
      "under_odds": -118,
      "captured_at": "2025-09-05T21:55:39.000Z",
      "scheduled_start": "2025-09-06T00:00:00.000Z",
      "minutes_before_scheduled_start": 124.4,
      "source": "archive"
    },
    {
      "game_id": "2025_01_KC_LAC",
      "player_name": "Patrick Mahomes",
      "gsis_id": "00-0033873",
      "market": "player_pass_yds",
      "bookmaker": "betmgm",
      "line": 245.5,
      "over_odds": -135,
      "under_odds": 100,
      "captured_at": "2025-09-05T21:55:39.000Z",
      "scheduled_start": "2025-09-06T00:00:00.000Z",
      "minutes_before_scheduled_start": 124.4,
      "source": "archive"
    }
  ],
  "count": 14
}

Response fields

snapshot_typestring
gamesnumber
props[]array
List of objects
props[].game_idstring
props[].player_namestring
props[].gsis_idstring
props[].marketstring
props[].bookmakerstring
props[].linenumber
props[].over_oddsnumber
props[].under_oddsnumber
props[].captured_atstring
props[].scheduled_startstring
props[].minutes_before_scheduled_startnumber
props[].sourcestring
countnumber

Used in

Related endpoints

Try it

500 free credits every month: 25 calls to get_player_props, and no card.