# PrizePicks Player Props (`automatic/prizepicks-player-props`) Actor

Export PrizePicks player projections with player, team and game IDs, stat labels, lines and board variants. Filter leagues, players, teams and game dates, or monitor new projections and line changes with saved history.

- **URL**: https://apify.com/automatic/prizepicks-player-props.md
- **Developed by:** [Philip Kirkbride](https://apify.com/automatic) (community)
- **Categories:** Sports
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.20 / 1,000 projections

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## PrizePicks Player Props

Collect PrizePicks player projections for DFS research: player, team and game IDs, UTC game times, stat labels, lines, side availability and board variants. Compare snapshots across providers or monitor changes on later runs. Start with `{}` for an announced sample of up to 20 current projections.

### Use cases

- Compare player lines across PrizePicks, Underdog, Pick6 and Sleeper exports.
- Build alerts for new projections, line moves, availability changes and removals.
- Export NBA, NFL, NHL and esports projections with their native identities.
- Keep standard offers separate from demons, goblins, discounts and combo players.

### Also available

The player props suite: pick the job.

| Actor | Use when |
|---|---|
| **PrizePicks Props (this Actor)** | PrizePicks lines and projection changes |
| [Underdog Props](https://apify.com/automatic/underdog-player-props) | Underdog higher/lower lines and payouts |
| [Sleeper Picks Props](https://apify.com/automatic/sleeper-player-props) | Sleeper lines, multipliers and changes |
| [DraftKings Pick6](https://apify.com/automatic/pick6-player-props) | Pick6 props, multipliers and alternates |
| [BetRivers Odds & Props](https://apify.com/automatic/betrivers-odds-player-props) | BetRivers and Unibet lines plus player props |
| [Sports Injury Reports](https://apify.com/automatic/sports-injuries) | Injury status changes across leagues |

### Quick start

The Console prefill collects up to 20 NBA/NFL standard props:

```json
{"leagues":["nba","nfl"],"includeAlternates":false,"includeLive":false,"maxResults":20,"onlyChangesSinceLastRun":false,"allowPartial":false}
```

A bare `{}` announces “Sample run (up to 20 props)”, sets `OUTPUT.sampleRun: true`, tries NBA first, then NFL and other available leagues if needed, and stops when the sample is full. Set a league and `maxResults` for a larger export.

### Input

Lists match exact values ignoring case, accents and punctuation. Each list accepts 1–200 strings of 1–200 characters; an unusable entry (blank, a duplicate after normalization, or no Latin letters or digits) is skipped into `OUTPUT.skippedSearches` and the rest still runs. Values within a list combine with OR; filter fields combine with AND. Unknown values match zero. Explicit nulls, empty strings and empty arrays end the run as `no_results` and name the field. No source filters are injected as schema defaults.

| Field | Meaning and omitted behavior |
| --- | --- |
| `sports` | All sports; known groups include basketball, american_football, ice_hockey, esports, soccer, baseball, tennis, golf and mma. League codes also match. |
| `leagues` | Exact current PrizePicks league name or native ID, such as NBA/7, NFL/9, NHL/8 or CS2/265. Omit for all current leagues with available inventory; the bare sample uses NBA/NFL. |
| `statTypes` | Native label, native stat ID or normalized key, such as Points, Pts+Rebs+Asts or points_rebounds_assists. Omit for all. |
| `players` | Exact display name or native player ID. Omit for all. |
| `teams` | Exact player-team abbreviation or full team name. Omit for all. |
| `gameDateFrom` | Inclusive UTC game date, YYYY-MM-DD. Omitted: no lower bound. |
| `gameDateTo` | Inclusive UTC game date, YYYY-MM-DD. Omitted: no upper bound; cannot precede gameDateFrom. |
| `nextDays` | Today through today + N − 1 in UTC, 1–30. Omitted: no relative window. Cannot combine with explicit dates. |
| `includeAlternates` | false; true includes demons, goblins, discounts and other offers supplied on this board. Each native projection is a separate row; no complete alternate ladder is promised. |
| `includeLive` | false; true retains live offers present on this board. Complete live coverage is unverified. Locked or removed offers present in the response remain explicit unavailable records. |
| `maxResults` | 20 for the sample, otherwise 5,000; integer 1–10,000 delivered rows. |
| `onlyChangesSinceLastRun` | false; true emits a baseline, then new, line, payout, status, metadata and removed observations. |
| `onlyNewSinceLastRun` | Alias of onlyChangesSinceLastRun, including edits and removals. Do not provide both fields. |
| `stateKey` | default; history name up to 200 characters. The name plus matching filters identifies a feed. Changing output caps does not reset it. |
| `proxyConfiguration` | Managed connection included in the event price. Leave omitted for the supported settings. |
| `downloadTimeoutSecs` | 220 seconds for collection, integer 1–240. Use a 300-second run limit and the default memory for larger exports. |
| `allowPartial` | false; a failed league fails the run while preserving already delivered leagues. True permits a partial success. Failed leagues are named in status and OUTPUT and never imply removals. All-failed collection still fails. |

### Output

Each row represents one native projection with both sides together. Stable `propKey` and `recordKey` use the native projection ID; `snapshotKey` changes with meaningful content. Player, team, stat and game IDs are strings. Common league codes use ncaaf, ncaab, cs, dota and mma for the corresponding CFB, CBB, CS2, Dota2 and UFC boards; leagueNameNative and leagueNativeId preserve the source league. `matchKey` combines league, folded player name and team as a comparison aid; combo players and players without a team have a null key. It is not a verified cross-provider ID. Match game time, both teams, player, stat, period and settlement rules before comparing lines.

`boardVariant` preserves standard, demon or goblin. Promo flags and discount details stay in `payoutInfo`. `line` uses a supplied flash-sale line when present; `lineScoreNative` retains the original line. Combo identities remain intact under `player.combo`; individual membership is not inferred from a display name. Fantasy-score stats remain native with a null normalized stat. Unknown periods have null `period` and null `quote` rather than a fabricated full-game scope.

`quote` follows version 1.1 and `canonical` follows envelope 1.0 used by our other props exports. Fantasy multipliers, sportsbook odds, implied probabilities, ESPN mappings, overtime coverage and settlement rules remain null when unavailable. The source's wager types determine side availability; missing wager types mean unknown availability and both sides unavailable. No numerical multiplier is inferred from a demon or goblin label.

`OUTPUT` contains delivered counts by sport, league and stat, named failures, skipped leagues, caps, baseline/state flags and `summaryLine`. The terminal message matches this summary. Errors and status summaries are never dataset rows. Each complete league is saved before collection continues; a later failure preserves delivered results and labels the run incomplete.

### Output example

**Selected fields only.**

From a real NBA projection captured on November 12, 2026:

```json
{
  "propKey": "prizepicks:16917242",
  "source": "prizepicks",
  "league": "nba",
  "player": {
    "nativeId": "352810",
    "name": "Jaylen Brown",
    "team": "PHI",
    "teamName": "Philadelphia 76ers",
    "teamNativeId": "210",
    "position": "G-F",
    "espnPlayerId": null,
    "sportradarId": null,
    "combo": false
  },
  "statTypeNative": "Pts+Rebs+Asts",
  "statType": "points_rebounds_assists",
  "line": 55.5,
  "boardVariant": "demon",
  "matchKey": "nba:jaylenbrown:phi"
}
```

### Change tracking

```json
{"leagues":["cs2"],"includeAlternates":true,"onlyChangesSinceLastRun":true,"stateKey":"daily-cs2","maxResults":10000}
```

Run this input again to receive changes against delivered observations. Only delivered rows advance history. Charge-limited or capped observations can be delivered on a later scan if still present; this is a current-board monitor, not a queue of every intermediate movement. A failed state write fails the run and warns that delivered observations may repeat. Concurrent runs using the same feed are rejected while its writer lease is held. Different keys are independent. A non-empty complete league can establish removals; failed or empty leagues preserve prior history. A new stateKey starts fresh. Up to 10,000 delivered observations are retained per feed.

### Pricing

**$0.0002 per projection ($0.20 per 1,000) plus $0.02 per run start**. Both sides together count as one projection; optional variants each count as their own native projection. Only delivered records are charged, and under pay per event there is no separate compute or proxy charge.

The start event is billed per GB of memory, rounded up with a minimum of one; the default 1024 MB run is one start event. These examples use the default memory:

| Run | Projections | Cost |
| --- | ---: | ---: |
| Quick sample (`{}`) | 20 | $0.024 |
| 193-projection export | 193 | $0.0586 |
| 3,880-projection export | 3,880 | $0.796 |
| Scheduled check with no changes | 0 | $0.02 |

A charge limit may deliver fewer rows. The status reports “allowed N of M”, and undelivered rows do not advance history. A start-only limit delivers no rows and preserves the baseline.

### Good to know

- Coverage reflects the current pickem board. Some leagues have no available projections; complete live coverage and historical results are not supplied.
- Board size and source availability affect collection time. Narrow league selections work best for frequent monitoring; failures and incomplete coverage are explicit.
- Change tracking retains up to 10,000 delivered observations per feed. Capped observations are rescanned if still present; failed or empty leagues preserve history.
- Native identities and settlement details need review before cross-provider comparisons. Missing identities, odds and rules remain null.

# Actor input Schema

## `sports` (type: `array`):

Sport or base league name. Known groups: basketball, american_football, ice_hockey, esports, soccer, baseball, tennis, golf, mma. Unclassified leagues use their native sport or unknown.

## `leagues` (type: `array`):

Exact native league name or ID from the current leagues list. Includes NBA, NFL, NHL and CS2. Omit for all current leagues. Unknown values succeed empty and are reported.

## `statTypes` (type: `array`):

Exact native stat keys or normalized sportsbook keys. Unknown source stats retain a null normalized value. Omit for all. Maximum 200 distinct values, 200 characters each; duplicate normalized values and entries without Latin letters/digits fail.

## `players` (type: `array`):

Exact full player names (accent/punctuation insensitive) or native PrizePicks player IDs. Omit for all; explicit empty lists fail. Maximum 200 distinct values, 200 characters each; duplicate normalized values and entries without Latin letters/digits fail.

## `teams` (type: `array`):

Exact player team abbreviation or name supplied by PrizePicks. Omit for all.

## `gameDateFrom` (type: `string`):

Inclusive UTC game date, YYYY-MM-DD. Cannot be combined with nextDays.

## `gameDateTo` (type: `string`):

Inclusive UTC game date, YYYY-MM-DD. Must not precede gameDateFrom.

## `nextDays` (type: `integer`):

Inclusive UTC today through today + N - 1 days, 1–30. Omit for the entire available slate; cannot combine with explicit dates.

## `includeAlternates` (type: `boolean`):

False when omitted. True includes demon, goblin, discounted and other non-standard offers, each as its own native projection row.

## `includeLive` (type: `boolean`):

False in code. True retains any live/non-pregame offers present in the board. Does not promise complete in-play coverage.

## `maxResults` (type: `integer`):

Maximum delivered projections, 1–10000. Bare input uses 20; explicit scope uses 5000 when omitted. Undelivered changes can be delivered next time if still present.

## `onlyChangesSinceLastRun` (type: `boolean`):

False in code. First run emits a labelled baseline; subsequent runs emit new, line, payout, status and removed props. Saved state advances only for delivered rows.

## `stateKey` (type: `string`):

Non-empty name up to 200 characters; code uses default when omitted. Same name and filters share history in a persistent named key-value store. New name resets history.

## `proxyConfiguration` (type: `object`):

Managed connection included in the pay-per-event price. Leave omitted for the supported settings. No separate proxy subscription is requested by this Actor.

## `downloadTimeoutSecs` (type: `integer`):

Whole collection budget, 1–240 seconds; code default 220. Leaves time to save OUTPUT within a 300-second run.

## `allowPartial` (type: `boolean`):

False when omitted: a failed league fails the run, preserving completed deliveries. True allows partial success with failures named in OUTPUT and status. All-failed collection still fails; failed/empty leagues preserve history.

## `onlyNewSinceLastRun` (type: `boolean`):

Alias of onlyChangesSinceLastRun: emits baseline then new, line, payout, status and removed changes. Do not combine both fields.

## Actor input object example

```json
{
  "leagues": [
    "nba",
    "nfl"
  ],
  "includeAlternates": false,
  "includeLive": false,
  "maxResults": 20,
  "onlyChangesSinceLastRun": false,
  "allowPartial": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "leagues": [
        "nba",
        "nfl"
    ],
    "includeAlternates": false,
    "includeLive": false,
    "maxResults": 20,
    "onlyChangesSinceLastRun": false,
    "allowPartial": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("automatic/prizepicks-player-props").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "leagues": [
        "nba",
        "nfl",
    ],
    "includeAlternates": False,
    "includeLive": False,
    "maxResults": 20,
    "onlyChangesSinceLastRun": False,
    "allowPartial": False,
}

# Run the Actor and wait for it to finish
run = client.actor("automatic/prizepicks-player-props").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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",
    "nfl"
  ],
  "includeAlternates": false,
  "includeLive": false,
  "maxResults": 20,
  "onlyChangesSinceLastRun": false,
  "allowPartial": false
}' |
apify call automatic/prizepicks-player-props --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automatic/prizepicks-player-props"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/oCfkBsUB3MwtXLGEf/builds/v53IhPLZaJEfy8lD1/openapi.json
