prizepicks.com APIprizepicks.com ↗
Access real-time PrizePicks player prop projections, opening and current lines, game metadata, and trending props across NBA, NHL, and more sports leagues.
curl -X GET 'https://api.parse.bot/scraper/4968fa36-6dcb-4615-8b95-f94f1911ea62/get_projections?per_page=5&league_id=7&state_code=NY&single_stat=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch real-time player prop projections with resolved relationships to players, games, leagues, and stat types. Returns opening lines (board_time), current lines (line_score), odds type, and game context. Supports pagination and filtering by league, state, and live status.
| Param | Type | Description |
|---|---|---|
| is_live | boolean | Filter for live/in-game props only. Omitting returns all props. |
| per_page | integer | Number of results per page |
| league_id | integer | Filter by league ID (e.g., 7 for NBA, 8 for NHL) |
| state_code | string | US state code for geo-filtering available lines |
| single_stat | boolean | Filter for single stat props |
{
"type": "object",
"fields": {
"meta": "object containing current_page and total_pages",
"links": "object containing self link",
"projections": "array of projection objects with resolved player, game, league, and stat_type relationships"
},
"sample": {
"data": {
"meta": {
"total_pages": 1,
"current_page": 1
},
"links": {
"self": "api.prod01.universe.prizepicks.com/projections?per_page=5&single_stat=true&include=new_player%2Cstat_type%2Cleague%2Cgame&league_id=7&state_code=NY"
},
"projections": [
{
"id": "12090657",
"game": {
"status": "scheduled",
"start_time": "2026-05-15T19:00:00.000-04:00",
"external_game_id": "NBA_game_ZpUw9C37ZJ3Y6iO31MdNfTIZ"
},
"type": "projection",
"league": {
"name": "NBA",
"active": true
},
"status": "pre_game",
"odds_type": "demon",
"stat_type": {
"name": "Pts+Rebs+Asts",
"rank": 3
},
"board_time": "2026-05-13T23:18:54.429-04:00",
"line_score": 54.5,
"new_player": {
"team": "DET",
"league": "NBA",
"position": "G",
"display_name": "Cade Cunningham"
},
"start_time": "2026-05-15T19:10:00.000-04:00",
"description": "CLE",
"adjusted_odds": true,
"stat_display_name": "PRA"
}
]
},
"status": "success"
}
}About the prizepicks.com API
The PrizePicks API covers 5 endpoints that expose real-time player prop projections, league metadata, player profiles, game data, and trending popularity scores. The get_projections endpoint returns both opening lines (board_time) and current lines (line_score) alongside resolved player, game, league, and stat type relationships — all filterable by league, US state code, and live status.
Projections and Lines
The get_projections endpoint is the core of this API. Each projection object includes board_time (opening line), line_score (current line), odds type, and a fully resolved set of relationships: the player, the game, the league, and the stat type. You can narrow results using league_id (e.g., 7 for NBA, 8 for NHL), state_code to apply geo-filtering for US-state availability, is_live to isolate in-game props, and single_stat for single-stat prop types. The response includes meta.current_page and meta.total_pages for pagination via the per_page parameter.
Leagues, Players, and Games
get_leagues returns each league's id, name, active status, and projections_count, optionally filtered by state_code. get_players returns up to 250 player records per request — including display_name, position, team, league, and image_url — and accepts league_id to scope results. get_games returns up to 250 game records including external_game_id, status, start_time, is_live, and team and score metadata, also filterable by league_id.
Trending Props
The get_trending endpoint accepts a required league_id and returns a data map of projection_id to a numeric popularity score. Higher scores indicate more user activity on that line. This is useful for surfacing which player props are attracting the most attention at any given moment within a specific league.
- Monitor line movement on NBA player props by comparing
board_timeandline_scoreacross projection records - Build a live-game prop tracker using the
is_livefilter onget_projectionscombined with game status fromget_games - Display state-specific prop availability by passing
state_codetoget_projectionsorget_leagues - Rank the most popular player props within a league using popularity scores from
get_trending - Populate a player profile page with position, team, and headshot data from
get_players - Aggregate projections counts per league using the
projections_countfield returned byget_leagues - Cross-reference prop lines with game start times and live scores from
get_gamesto contextualize active projections
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does PrizePicks have an official developer API?+
How does `get_projections` handle geo-restricted lines?+
state_code parameter (e.g., CA, TX) to filter projections to lines available in that US state. Omitting state_code returns the full board without geographic filtering, which may include lines not available in all jurisdictions.What is the difference between `board_time` and `line_score` in a projection?+
board_time represents the opening line posted when the projection first appeared on the board. line_score is the current active line. Comparing the two lets you track whether a line has moved since it opened.