# PrizePicks Player Props Scraper - Real-Time Board & Lines (`crawloop/prizepicks-player-props-scraper`) Actor Extract real-time player props and lines from PrizePicks across 29 leagues in under 45 seconds. Get over/under lines, odds tiers (demon/goblin), matchups, and schedules. Advanced cost-saving filters (by league, player, stats, teams, and tiers). 51 fields per prop. JSON, CSV, Excel export. - **URL**: https://apify.com/crawloop/prizepicks-player-props-scraper.md - **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community) - **Categories:** Automation, Developer tools, Integrations - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.05 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## PrizePicks Player Props Scraper > **20,000 player props in under 45 seconds — real-time over/under lines with 51 fields across 29 leagues.** Get every active player prop from PrizePicks as structured, clean JSON. Each result represents one prop: a player, a stat, and an over/under line with the odds tier. Filter by league, player name, team, or fetch the entire board in a single call. --- ### Features - **51 fields per prop** — full player profiles, team brand colors, game matchups, odds difficulty tiers, and timestamps. - **29 leagues supported** — NBA, MLB, NHL, NFL, WNBA, Soccer, Tennis, PGA, Esports (CS2, LoL, Valorant, Dota 2, Call of Duty, Rocket League), AFL, Cricket, and more. - **Real-time data** — updates lines every few minutes. - **Cost-Optimized Filters** — apply filters to narrow output and cut costs (filters combine with AND logic, filtered-out rows are not billed). --- ### What Data Can You Extract? Every result includes: - **Player details**: Player name, team, position, jersey number, headshot URL, combo flag, and player ID. - **Stat details**: Stat category, short name (e.g. Points, PRA, SOT, Goals). - **Line details**: Over/under line score with odds tier (standard, demon, goblin). - **Matchup details**: Game matchup with home/away teams, full team names, markets, and brand colors. - **Time & status**: Game start time, board time, last updated timestamp, game live status. - **Duration & details**: Duration (Full, 1st Half, 1st Quarter, 1st Period), projection type name, and rank. #### Odds Tiers PrizePicks offers the same stat at different difficulty levels: | Tier | Meaning | Example | |---|---|---| | **Standard** | Normal line | Jokic PRA 50.5 | | **Demon** | Harder to hit, higher payout | Jokic PRA 56.5 | | **Goblin** | Easier to hit, lower payout | Jokic PRA 48.5 | --- ### Input Parameters All filters are optional and combine with **AND** logic. Filtered-out projections are not billed. | Parameter | Type | Default | Description | |---|---|---|---| | `leagues` | array | `["NBA"]` | One or more leagues. Select `"All"` for every available league, or `"Esports"` for all 6 esports titles. | | `playerNames` | string | — | Comma-separated player names. Case-insensitive, diacritic-insensitive (Jokic matches Jokić). Partial matching. | | `statTypes` | string | — | Comma-separated stat types. Accepts full names or abbreviations (PRA, Points, Goals, SOT). Case-insensitive, exact match. | | `oddsTiers` | array | — | One or more tiers: `standard`, `demon`, `goblin`. Leave empty for all tiers. | | `teams` | string | — | Comma-separated team names or abbreviations (Lakers, LAL). Matches player's team or either side of matchup. | | `maxProjections` | integer | `30000` | Maximum number of projection records to output for the run (up to 100,000). | | `prizePicksStateCode` | string | `"GA"` | State code sent to public middleware endpoints. | --- ### Input Examples #### Basic — NBA Props ```json { "leagues": ["NBA"] } ```` #### Multiple Leagues ```json { "leagues": ["NBA", "NHL", "Soccer"] } ``` #### Advanced Filtering (AND logic) ```json { "leagues": ["NBA"], "playerNames": "Jokic, LeBron", "statTypes": "PRA", "oddsTiers": ["demon"], "teams": "Lakers" } ``` *** ### Output Example Every prop includes all fields below. This is a real result from the NBA board: ```json { "projection_id": "10880149", "line": 44.5, "stat": "Pts+Rebs+Asts", "stat_short": "PRA", "odds_tier": "demon", "adjusted_odds": true, "flash_line": null, "is_promo": false, "status": "pre_game", "is_live": false, "is_live_scored": true, "in_game": false, "refundable": true, "rank": 4884, "projection_type": "Single Stat", "start_time": "2026-03-27T22:40:00.000-04:00", "board_time": "2026-03-27T01:20:37.914-04:00", "updated_at": "2026-03-27T01:18:38.101-04:00", "description": "BKN", "hot": null, "tv_channel": null, "custom_image": null, "event_type": "team", "end_time": null, "today": null, "player_name": "LeBron James", "player_team": "LAL", "player_team_name": "Lakers", "player_market": "Los Angeles", "player_position": "F", "player_image": "https://static.prizepicks.com/images/players/nba/LeBron_James.webp", "player_jersey": "23", "player_combo": false, "player_id": "188012", "league": "NBA", "league_id": 7, "game_start": "2026-03-27T22:30:00.000-04:00", "game_end": null, "game_status": "scheduled", "game_is_live": false, "home_team": "LAL", "home_team_name": "Lakers", "home_team_market": "Los Angeles", "home_team_color": "FDB927", "away_team": "BKN", "away_team_name": "Nets", "away_team_market": "Brooklyn", "away_team_color": "FFFFFF", "duration": "Full", "projection_type_name": "Single Stat", "stat_rank": 2 } ``` *** ### Supported Leagues | Category | Leagues | |---|---| | **Major Sports** | NBA, MLB, NHL, NFL, WNBA, Soccer, Tennis, College Basketball (CBB) | | **Esports** | CS2 (Counter-Strike), League of Legends (LoL), Valorant, Dota 2, Rocket League, Call of Duty | | **Golf & Motorsport** | PGA, LIV Golf, NASCAR | | **International & Other** | Cricket, AFL, Bowling, Badminton | *** ### Pricing — Pay Per Event (PPE) Optimized for Apify pay-per-event pricing: **$0.05 per 1,000 projections**. Since filters are processed before results are pushed to the dataset, **filtered-out projections are not billed**. Use filters (`playerNames`, `oddsTiers`, `statTypes`, `teams`, `leagues`) to reduce cost to pennies per run! *** ### Integration with AI Assistants Paste this prompt into ChatGPT, Claude, Cursor, or your custom LLM: ```text /prizepicks-player-props-scraper on Apify. Call: ApifyClient("TOKEN").actor("/prizepicks-player-props-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: leagues (string[], required: "All"|"Esports"|"NBA"|"MLB"|"NHL"|"Soccer"|etc, 29 leagues), playerNames (string, comma-separated), statTypes (string, comma-separated stat names like "Points, PRA, Goals"), oddsTiers (string[], "standard"|"demon"|"goblin"), teams (string, comma-separated team names/abbreviations). Filters combine with AND logic, filtered rows not billed. ``` # Actor input Schema ## `sourceMode` (type: `string`): Choose the main collection method. Direct scraping is the default production mode. ## `curlCommand` (type: `string`): Used only by Full board browser cURL mode. Paste a working browser 'Copy as cURL' request for the PrizePicks projections endpoint. ## `prizePicksCollectionStrategy` (type: `string`): Used only by Direct scraping mode. Public middleware full board is the default. App then public first tries the app board, then falls back to public collection methods. ## `leagues` (type: `array`): One or more leagues. Select 'All' for every available league, or 'Esports' for all 6 esports titles. ## `playerNames` (type: `string`): Comma-separated player names. Case-insensitive, diacritic-insensitive (Jokic matches Jokić). Partial matching. ## `statTypes` (type: `string`): Comma-separated stat types. Accepts full names or abbreviations (PRA, Points, Goals, SOT). Exact match, case-insensitive. ## `oddsTiers` (type: `array`): One or more tiers: standard, demon, goblin. Leave empty for all tiers. ## `teams` (type: `string`): Comma-separated team names or abbreviations (Lakers, LAL). Matches player's team or either side of matchup. ## `maxProjections` (type: `integer`): Maximum number of projection records to output for the run. ## `prizePicksStateCode` (type: `string`): State code sent to the public middleware endpoints. ## `maxProxyAttempts` (type: `integer`): Only used by App then public fallback mode. How many different sticky proxy sessions to try when the app board is blocked. ## `proxyConfiguration` (type: `object`): Proxy configuration for direct scraping. Residential proxy with sticky sessions is recommended. ## `proxyCountryCode` (type: `string`): Country code forced in direct scraping mode. US is the recommended default. ## Actor input object example ```json { "sourceMode": "direct", "curlCommand": "", "prizePicksCollectionStrategy": "public_middleware", "leagues": [ "NBA", "Esports", "All" ], "playerNames": "", "statTypes": "", "oddsTiers": [ "standard", "demon", "goblin" ], "teams": "", "maxProjections": 30000, "prizePicksStateCode": "GA", "maxProxyAttempts": 8, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "proxyCountryCode": "US" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "leagues": [ "NBA", "Esports", "All" ], "oddsTiers": [ "standard", "demon", "goblin" ] }; // Run the Actor and wait for it to finish const run = await client.actor("crawloop/prizepicks-player-props-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "leagues": [ "NBA", "Esports", "All", ], "oddsTiers": [ "standard", "demon", "goblin", ], } # Run the Actor and wait for it to finish run = client.actor("crawloop/prizepicks-player-props-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "leagues": [ "NBA", "Esports", "All" ], "oddsTiers": [ "standard", "demon", "goblin" ] }' | apify call crawloop/prizepicks-player-props-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawloop/prizepicks-player-props-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PrizePicks Player Props Scraper - Real-Time Board & Lines", "description": "Extract real-time player props and lines from PrizePicks across 29 leagues in under 45 seconds. Get over/under lines, odds tiers (demon/goblin), matchups, and schedules. Advanced cost-saving filters (by league, player, stats, teams, and tiers). 51 fields per prop. JSON, CSV, Excel export.", "version": "0.0", "x-build-id": "KfGdE8xuIfJgsVVW3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~prizepicks-player-props-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-prizepicks-player-props-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawloop~prizepicks-player-props-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-prizepicks-player-props-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawloop~prizepicks-player-props-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-prizepicks-player-props-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "sourceMode": { "title": "Source Mode", "enum": [ "direct", "full_board_request", "demo" ], "type": "string", "description": "Choose the main collection method. Direct scraping is the default production mode.", "default": "direct" }, "curlCommand": { "title": "Browser cURL Command", "type": "string", "description": "Used only by Full board browser cURL mode. Paste a working browser 'Copy as cURL' request for the PrizePicks projections endpoint.", "default": "" }, "prizePicksCollectionStrategy": { "title": "PrizePicks Collection Strategy", "enum": [ "public_middleware", "app_then_public" ], "type": "string", "description": "Used only by Direct scraping mode. Public middleware full board is the default. App then public first tries the app board, then falls back to public collection methods.", "default": "public_middleware" }, "leagues": { "title": "Leagues", "type": "array", "description": "One or more leagues. Select 'All' for every available league, or 'Esports' for all 6 esports titles.", "default": [ "NBA" ], "items": { "type": "string" } }, "playerNames": { "title": "Player Names", "type": "string", "description": "Comma-separated player names. Case-insensitive, diacritic-insensitive (Jokic matches Jokić). Partial matching.", "default": "" }, "statTypes": { "title": "Stat Types", "type": "string", "description": "Comma-separated stat types. Accepts full names or abbreviations (PRA, Points, Goals, SOT). Exact match, case-insensitive.", "default": "" }, "oddsTiers": { "title": "Odds Tiers", "type": "array", "description": "One or more tiers: standard, demon, goblin. Leave empty for all tiers.", "default": [], "items": { "type": "string" } }, "teams": { "title": "Teams", "type": "string", "description": "Comma-separated team names or abbreviations (Lakers, LAL). Matches player's team or either side of matchup.", "default": "" }, "maxProjections": { "title": "Max Projections", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of projection records to output for the run.", "default": 30000 }, "prizePicksStateCode": { "title": "PrizePicks State Code", "type": "string", "description": "State code sent to the public middleware endpoints.", "default": "GA" }, "maxProxyAttempts": { "title": "Max Proxy Attempts", "minimum": 1, "maximum": 25, "type": "integer", "description": "Only used by App then public fallback mode. How many different sticky proxy sessions to try when the app board is blocked.", "default": 8 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy configuration for direct scraping. Residential proxy with sticky sessions is recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "proxyCountryCode": { "title": "Proxy Country Code", "type": "string", "description": "Country code forced in direct scraping mode. US is the recommended default.", "default": "US" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```