# Action Network Scraper - Betting Splits, Odds, Props & Picks (`topapi/action-network-scraper`) Actor

Scrape Action Network: public betting % (tickets and money) and sharp gap, every sportsbook's odds, best prices, line moves and history, steam, props, expert picks, injuries, standings and futures. NFL, NBA, MLB, NHL, college, soccer, UFC, tennis. Monitor mode. $3.10 per 1,000 games.

- **URL**: https://apify.com/topapi/action-network-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Sports, Automation, Integrations
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.10 / 1,000 games

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

### What does Action Network Scraper do?

**Action Network Scraper** extracts sportsbook odds and public betting data from [Action Network](https://www.actionnetwork.com) and turns leagues, days, weeks or game links into one row per game: the **share of bets and the share of money** on every side, every selected sportsbook's moneyline, spread and total, best prices, opening-to-current line movement and the game itself. Built for bettors, betting-model builders, tipsters and sports media who need splits and lines on a schedule without copying them by hand.

Action Network API · Action Network betting splits · public betting percentages · sharp money tracker · line movement scraper

- **Bets, money and the gap between them:** `ticketPercent`, `moneyPercent` and a signed `sharpGap` (money % minus tickets %) on every consensus side, plus flat columns (`spreadHomeTicketsPct`, `overMoneyPct` ...) ready for a spreadsheet.
- **24 leagues in one run:** NFL, NCAA Football, UFL, NBA, NCAA Basketball (men and women), WNBA, MLB, NHL, nine soccer competitions plus the combined soccer slate, UFC, boxing, ATP, WTA and the combined tennis slate.
- **Every book you pick:** DraftKings, FanDuel, BetMGM, bet365, BetRivers, Caesars and Fanatics by default, plus Kalshi and Polymarket for a prediction-market comparison; any Action Network book id (463 listed) can be added.
- **Signals computed for you:** reverse line moves, sharp-money moves, cross-book arbitrage and middles, closing line value, and with line history on, **steam moves** (3+ books moving the same way within 10 minutes before kickoff).
- **Game detail and expert picks at no extra charge:** rosters, box score and season stats, play-by-play, lineups, officials, venue, weather, game injuries, depth charts, trends, and every Action Network expert's pick with record, units and ROI, plus a per-side expert consensus.
- **Monitor mode:** a scheduled run delivers only the games whose lines, odds, betting % or status moved, with the previous values and a splits trend across polls. An unchanged poll costs about $0.0001.
- **No login, cookies or API key.** Pay only for delivered games; filters run before anything is charged.

### What data can you get from Action Network?

<table>
<tr>
<td>🎟️ Tickets % and money % per side (<code>consensus</code>, flat <code>*TicketsPct</code> / <code>*MoneyPct</code>)</td>
<td>📐 Sharp gap and sharp side (<code>maxSharpGap</code>, <code>sharpSide</code>)</td>
<td>📊 Consensus moneyline, spread, total with no-vig probability, hold and overround</td>
</tr>
<tr>
<td>🏦 Every book × market × segment × side (<code>booksPricing</code>)</td>
<td>💰 Best price and best line per side (<code>bestPrices</code>, <code>bestLines</code>)</td>
<td>↕️ Opening → current line and odds (<code>lineMovement</code>, <code>openSpreadHome</code> ...)</td>
</tr>
<tr>
<td>🧮 Team totals, halves, quarters, periods, first five (<code>teamTotals</code>, <code>consensusByPeriod</code>)</td>
<td>🚨 Reverse line moves, sharp money, arbitrage, middles (<code>signals</code>)</td>
<td>🔮 Kalshi / Polymarket vs sportsbook probability (<code>predictionMarketEdge</code>)</td>
</tr>
<tr>
<td>🏁 Score by period, graded result (winner, ATS, O/U), closing line value</td>
<td>🧑‍🏫 Expert picks with record, ROI, units, streak; expert consensus</td>
<td>🏟️ Rosters, box score, play-by-play, lineups, officials, venue, weather</td>
</tr>
<tr>
<td>📈 Full line history per book with timestamps, steam moves (add-on)</td>
<td>🎯 Player and game props from every book (add-on)</td>
<td>🩹 Injury reports, standings with ATS and O/U records, futures (league rows)</td>
</tr>
</table>

Measured on 213 game rows from 11 captured scoreboards (2026-11-06): consensus lines on 98.6%, best prices and per-book prices on 99.5%, opening-to-current movement on 98.6%, public betting % on the total on 85% and on the moneyline on 83% (tennis, UFC and boxing carry no betting %), bet count on 80%.

### How to scrape Action Network with Action Network Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) - $5 of monthly credit, no card needed.
2. Open [Action Network Scraper](https://apify.com/topapi/action-network-scraper) and click **Try for free**.
3. Pick **Leagues** (the form starts with NBA, NFL, NHL, MLB and soccer). Leave **Day** and **Week** empty for the current slate.
4. Turn on **Full line history** or **Player and game props** if you need them, and set **Maximum games**.
5. Click **Start**. A league slate finishes in a few seconds.
6. Open the **Storage** tab and **Export** as JSON, CSV or Excel. The **Betting splits** view is the table most people want.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **What to scrape** | | |
| `leagues` | List | nfl, ncaaf, ufl, nba, ncaab, wnba, ncaaw, mlb, nhl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, champions, europa, worldcup, ufc, boxing, atp, wta, tennis. Empty (and no game) = nba, nfl, nhl, mlb, soccer |
| `gameUrls` | List | Game pages (`https://www.actionnetwork.com/nfl-game/.../290807`) or league pages (`/nba/public-betting`, `/nhl/odds`) |
| `gameIds` | List | Action Network game ids, any season back to 2015 |
| `date` | String | One US Eastern day: `2026-11-08`, `today`, `tomorrow`, `yesterday`. Empty = today / the current week |
| `dateFrom`, `dateTo` | String | A range of days (up to 366) |
| `daysAhead`, `daysBack` | Integer | Days after / before today |
| `week`, `weekTo`, `season`, `seasonType` | Integer / String | NFL, NCAA Football and UFL weeks (`reg`, `post`, `pre`) |
| **Filters** (applied before any game is fetched or charged) | | |
| `gameStatus` | List | `upcoming`, `live`, `finished` |
| `teams` | List | Team names, nicknames, cities or abbreviations; fighters or tennis players |
| `onlyTrending`, `minBets`, `minSharpGap` | Boolean / Integer | Trending games, a minimum bet count, a minimum money-vs-tickets gap |
| `onlyWithOdds`, `onlyWithSplits` | Boolean | Priced games only; games with betting % only |
| `startsWithinHours`, `startsAfter`, `startsBefore` | Integer / String | A start-time window |
| `sortBy` | Select | `startTime` (default), `betCount`, `sharpGap`, `total`, `spread` |
| `maxGames`, `maxGamesPerLeague` | Integer | Default `100` games per run; `0` = no cap |
| **Books and markets** | | |
| `books` | List | Book names (`draftkings`, `fanduel`, `betmgm`, `bet365`, `betrivers`, `caesars`, `fanatics`, `kalshi`, `polymarket`, `hardrock`, `thescore`, `unibet`, `pinnacle`, `bovada` ...) or ids (e.g. `1006` FanDuel NY). Consensus (15) and Open (30) are always read |
| `periods` | List | `firsthalf`, `secondhalf`, `firstquarter` ... `fourthquarter`, `firstperiod` ... `thirdperiod`, `firstinning`, `firstfiveinnings` |
| **Add-ons** | | |
| `includeGameDetail` | Boolean | Rosters, stats, play-by-play, lineups, officials, venue, injuries, depth charts, trends. Default `true`, free |
| `includeExpertPicks` | Boolean | Expert picks + expert consensus. Default `true`, free |
| `includeWeather` | Boolean | Hourly forecast for upcoming outdoor games. Default `true`, free |
| `includeLineMovement` | Boolean | Full line history + steam moves - charged as **line-history** per game that has it |
| `includeProps`, `propTypes` | Boolean / List | The prop board (NFL ~99 prop types, NBA ~76) - charged as **prop-board** per game that has props |
| `includeInjuries` | Boolean | One row per league - charged as **injury-report** |
| `includeStandings` | Boolean | One row per league, free |
| `includeFutures`, `futureCategories`, `maxFutures` | Boolean / List / Integer | Futures rows, charged as **futures-row**; default cap 100 |
| `includeGames` | Boolean | Turn off for injury / standings / futures only |
| `outputMode` | Select | `full` or `compact` (drops rosters, stats, play-by-play and the per-book list) |
| **Monitor and alerts** | | |
| `monitorMode`, `monitorName`, `resetMonitor` | Boolean / String | Deliver only new or moved games; one memory per name |
| `minLineMove`, `minOddsMove`, `minSplitMove` | Number / Integer | Thresholds: 0.5 points, 10 cents, 2 percentage points by default |
| `monitorOn`, `includeUnchanged` | List / Boolean | Which changes deliver a game (`NEW`, `LINE_MOVED`, `ODDS_MOVED`, `SPLITS_MOVED`, `STATUS_CHANGED`, `SCORE_CHANGED`) |
| `webhookUrl`, `slackWebhookUrl`, `discordWebhookUrl`, `alertOn`, `alertMinSharpGap` | String / List / Integer | One alert per run listing the flagged games |
| **Advanced** | | |
| `maxConcurrency`, `proxyConfiguration` | Integer / Object | Not needed: Action Network answers directly |

#### Input JSON

```json
{
  "leagues": ["nfl"],
  "week": 9,
  "season": 2026,
  "books": ["draftkings", "fanduel", "betmgm", "caesars"],
  "periods": ["event", "firsthalf"],
  "includeLineMovement": true,
  "includeProps": true,
  "propTypes": ["Pass Yds", "Rush Yds", "Rec Yds"],
  "maxGames": 16
}
```

#### Use a week for football, a day for everything else

NFL, NCAA Football and UFL are scheduled by week: **Do:** `"week": 1, "weekTo": 18, "season": 2025` for a season backfill. A `date` on a football league reads the week containing that day and keeps only that day's games. NBA, NHL, MLB, soccer, tennis and fights use days: **Do:** `"dateFrom": "2025-01-01", "dateTo": "2025-01-31"`.

#### Filter on the scoreboard, not afterwards

Every filter (`gameStatus`, `teams`, `minBets`, `minSharpGap`, `onlyWithSplits`, the start window) runs on the league's scoreboard before any game is read, so a filter that keeps 5 games out of 60 costs 5 games. **Don't** pull a whole college Saturday to keep three teams: pass `"teams": ["Alabama", "Georgia", "Texas"]`.

### ⬆️ Output

Every game becomes one dataset item. A real row from a run of `{}` (the default leagues) on 2026-11-06, run `2Oaj1chimq9rZw1IQ` (blocks trimmed to one side; the full row has 97 fields, ~120 KB with game detail):

```json
{
  "gameId": 290958,
  "eventType": "game",
  "title": "New York Giants @ Philadelphia Eagles",
  "gameUrl": "https://www.actionnetwork.com/nfl-game/giants-eagles-score-odds-november-8-2026/290958",
  "league": "nfl", "season": 2026, "week": 9, "seasonType": "reg",
  "startTime": "2026-11-08T18:00:00.000Z", "status": "scheduled", "totalBets": 10890, "bookCount": 7,
  "consensusMlAway": -170, "consensusMlHome": 140,
  "mlAwayTicketsPct": 81, "mlAwayMoneyPct": 51, "mlHomeTicketsPct": 19, "mlHomeMoneyPct": 49,
  "consensusSpreadHome": 3, "spreadHomeTicketsPct": 33, "spreadHomeMoneyPct": 26,
  "consensusTotal": 38.5, "overTicketsPct": 75, "overMoneyPct": 67,
  "openSpreadHome": -5.5, "openTotal": 44.5,
  "maxSharpGap": 30, "sharpSide": { "market": "moneyline", "side": "home", "sharpGap": 30 },
  "consensus": { "spread": { "sides": [{ "side": "home", "odds": -103, "decimalOdds": 1.9709, "line": 3, "impliedProbability": 0.507389, "noVigProbability": 0.485807, "ticketPercent": 33, "moneyPercent": 26, "sharpGap": -7 }], "holdPercent": 4.2536 } },
  "bestPrices": { "spread": [{ "side": "away", "odds": -115, "line": -3, "bookId": 68, "bookName": "DraftKings NJ", "deeplinkId": "ML2670652431" }] },
  "lineMovement": { "spread": [{ "side": "home", "openingLine": -5.5, "currentLine": 3, "lineDelta": 8.5, "openingOdds": -110, "currentOdds": -103 }] },
  "signals": { "reverseLineMoves": [{ "market": "total", "publicSide": "over", "ticketPercent": 75, "moneyPercent": 67, "openingLine": 44.5, "currentLine": 38.5 }], "sharpMoneyMoves": [], "arbitrage": [], "middles": [] },
  "predictionMarketEdge": [{ "bookName": "Kalshi", "side": "away", "predictionMarketOdds": -163, "predictionMarketProbability": 0.619772, "sportsbookNoVigProbability": 0.60177, "edge": 0.018002 }],
  "expertConsensus": [{ "market": "custom", "customPickType": "core_bet_type_65_interceptions", "picks": 2, "verifiedPicks": 2, "experts": 2, "plays": ["J.McCarthy o0.5 Int"] }],
  "weather": { "atKickoff": { "temperature": 58.21, "windSpeed": 9.78, "windDirection": "W", "description": "Partly Cloudy" } }
}
```

Tennis, UFC and boxing rows have `eventType: "competition"` and a `competitors` list instead of teams. League rows: `recordType` `"injuries"` (one row per league with the report), `"standings"` (one row per league: every team's record, against-the-spread and over/under records, points, ranks, streak) and `"futures"` (one row per selection with every book's price and the best one).

#### Signals, defined

| Field | Rule |
|---|---|
| `sharpGap` | money % minus tickets % on a side (zero splits are null, never 0) |
| `signals.reverseLineMoves` | a side with 55%+ of tickets whose line or price moved in its favour since the open (the books moved toward the other side) |
| `signals.sharpMoneyMoves` | a side with money 10+ points ahead of tickets whose line moved against it since the open |
| `signals.arbitrage` | best price per side across the selected sportsbooks summing under 100% implied, with ROI and stake shares |
| `signals.middles` | spread or total numbers at two books leaving a window of 1+ point |
| `steamMoves` | line history on: 3+ books moving the same market the same way within 10 minutes, before kickoff |
| `predictionMarketEdge` | Kalshi / Polymarket implied probability minus the sportsbook consensus no-vig probability |
| `closingLineValue` | finished games: opening vs closing line and probability per side |
| `expertConsensus` | expert picks grouped by market side: picks, verified picks, experts, units |

### How can I use Action Network data?

- 🎯 **Bettors** - sort the slate by `maxSharpGap`, check `reverseLineMoves` and shop `bestPrices` before kickoff.
- 📊 **Betting-model builders** - backfill seasons of closing lines, splits and graded results (`result`, `closingLineValue`) by week or date range.
- 🔔 **Tipsters and Discord groups** - schedule monitor mode every 15 minutes and post line moves and steam to a webhook.
- 🧠 **AI and research teams** - feed compact rows (`outputMode: "compact"`) to an agent through the API or MCP.
- 📰 **Sports media** - pull injury reports, standings with ATS records and futures for previews.

### How much does it cost to scrape Action Network?

Pay per event, no start fee:

| Event | Price | When |
|---|---:|---|
| **Game** | **$3.10 per 1,000 games** | every game row delivered |
| Line history | $3.10 per 1,000 games | games whose full history was read |
| Prop board | $4.00 per 1,000 games | games with at least one prop market |
| Injury report | $6.20 per 1,000 league reports | league reports with at least one injury |
| Futures row | $4.50 per 1,000 rows | each futures selection |
| Standings, expert picks, weather, game detail | free | |

Examples measured on 2026-11-06: the Store's prefill (9 games) bills $0.028; an NFL, NBA and NHL slate (27 games) $0.084; a full NFL week with line history, props, the injury report, standings and 50 futures rows $0.38. Games removed by filters and games unchanged since the last monitor run are never charged.

### Run it on a schedule

- **Monitor mode:** set `"monitorMode": true` and a `monitorName`, save it as a task and schedule it (every 15-60 minutes on game day). Each poll returns only games that are new or moved past `minLineMove` / `minOddsMove` / `minSplitMove`, with `changeKinds`, `previous` and `splitsTrend`. A game delivered without a part a later poll asks for (game detail, line history, props, expert picks) comes back once with `changeType: "DETAILS"` and that part, charged like any delivered game. Measured: an unchanged poll cost $0.000095.
- **Alerts:** add `webhookUrl`, `slackWebhookUrl` or `discordWebhookUrl`; each run posts one message listing the flagged games.
- **API:** `POST https://api.apify.com/v2/acts/topapi~action-network-scraper/run-sync-get-dataset-items?token=<TOKEN>` with the input as the body returns the rows; see the [API tab](https://apify.com/topapi/action-network-scraper/api).
- **MCP / AI agents:** add `topapi/action-network-scraper` to the [Apify MCP server](https://mcp.apify.com/).
- **No-code:** Make, Zapier, n8n, Google Sheets via [Apify integrations](https://docs.apify.com/integrations).

### Coverage

- **Leagues:** the 24 above. An out-of-season league returns nothing and costs nothing.
- **Books:** 463 Action Network book ids, including state feeds (FanDuel NY `1006`, Caesars NY `1005`, BetRivers NY `972`, DraftKings MD `1963`, Hard Rock FL `2725`, Fanatics CT `2821`) and offshore books (Pinnacle `3`, Bovada `21`, BetOnline `1`, Circa `78`).
- **History:** results and box scores back to 2015; prices and betting % from the 2024 season (a 2019 NBA date returns results without prices).
- **Speed:** a league slate in 2-4 s; a full NFL week with line history and props in about a minute (100 prop reads per game); a 1,000-game NBA backfill with game detail in 12-14 minutes on the default 512 MB (raising the memory runs it faster at about the same platform cost).

### Limits & empty runs

- **Betting % come from Action Network's consensus line** and only where Action Network tracks the game; far-future games read 0 / 0, which this actor returns as null.
- **Tennis, UFC and boxing** carry odds and results but no betting %.
- **Props and line history** cover team sports; Action Network keeps them for recent games.
- **Not included:** Action Network PRO content (prop projections, PRO reports) - only what a signed-out visitor sees.
- **Empty dataset:** the league is out of season or has no games that day, your filters removed every game (the status message lists how many each filter removed), or a monitor poll found nothing new. Nothing is charged in any of those cases.

### FAQ

#### Does Action Network have a public API?

Not a documented one. Action Network Scraper reads the same JSON the actionnetwork.com web app loads for signed-out visitors and returns it with a stable schema.

#### What is the difference between tickets % and money %?

Tickets % is the share of bets on a side, money % the share of the money staked. When money runs ahead of tickets, fewer bettors carry more of the stake; `sharpGap` is that difference as one sortable number.

#### Can Action Network Scraper get past seasons?

Yes. Use `week` + `weekTo` + `season` for football and `dateFrom` / `dateTo` for other leagues, or pass game ids. Prices and betting % start with the 2024 season.

#### Can I get first-half, quarter or first-five-innings lines?

Yes, with `periods`. Not every game prices every segment; segments that are not priced are simply absent.

#### What are book ids 15 and 30?

Not sportsbooks: 15 is Action Network's consensus line (it carries the betting %) and 30 is the opening line. Both are always read, so splits and movement never go missing when you pick one book.

#### How do I watch line moves through the day?

Monitor mode on a schedule. The first poll delivers every game (NEW); later polls deliver only games whose line, price, betting % or status moved, with the previous values.

#### Can I use Action Network Scraper through the Apify API or MCP?

Yes. Every input is optional, so `{"leagues": ["nba"]}` is a complete call. `outputMode: "compact"` keeps rows small for agents.

#### Why did my run return no games?

The league is out of season or has no games on that day (dates are US Eastern), or the filters removed them. The status message says which.

#### Do I need an Action Network account?

No. Nothing signed-in is read.

#### Is it legal to scrape Action Network?

Action Network Scraper collects only what Action Network shows publicly without logging in, and no PRO content. Odds and betting data are for information and analysis.

#### Your feedback

Found a bug or missing a field? Open an issue on the [Issues tab](https://apify.com/topapi/action-network-scraper/issues/open).

# Actor input Schema

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

Leagues to cover: nfl, ncaaf, ufl, nba, ncaab, wnba, ncaaw, mlb, nhl, soccer (all leagues), epl, laliga, bundesliga, seriea, ligue1, mls, champions, europa, worldcup, ufc, boxing, atp, wta, tennis. Out of season = no rows, no charge. Empty = nba, nfl, nhl, mlb, soccer.

## `gameUrls` (type: `array`):

Action Network game pages (https://www.actionnetwork.com/nfl-game/.../290807) or league pages (https://www.actionnetwork.com/nba/public-betting, /nhl/odds). A game link reads that game; a league link adds the league.

## `gameIds` (type: `array`):

Action Network game ids (the number at the end of a game link), e.g. 290807. Any season back to 2015 (prices and splits from 2024).

## `date` (type: `string`):

One day in US Eastern time: 2026-11-08, today, tomorrow or yesterday. For NFL / NCAA Football the week containing that day is read and only that day's games are kept. Empty = today (the current week for NFL / NCAA Football).

## `dateFrom` (type: `string`):

First day of a range (US Eastern), e.g. 2026-11-01. Every day up to To day is read (at most 366).

## `dateTo` (type: `string`):

Last day of a range, e.g. 2026-11-07.

## `daysAhead` (type: `integer`):

Also read this many days after today (0 = today only).

## `daysBack` (type: `integer`):

Also read this many days before today (results, closing lines, final splits).

## `week` (type: `integer`):

Week number. Empty = the current week.

## `weekTo` (type: `integer`):

Read every week from Week to this one (a season backfill).

## `season` (type: `integer`):

Season year for a week (2025 = the 2025-26 NFL season). Empty = the current season.

## `seasonType` (type: `string`):

With Week: regular season (default), postseason or preseason.

## `gameStatus` (type: `array`):

Keep only games in these states. Empty = all.

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

Keep games of these teams (full name, nickname, city or abbreviation: "Lakers", "Kansas City Chiefs", "NYY") or fighters / tennis players. Also narrows injuries, standings and futures.

## `onlyTrending` (type: `boolean`):

Keep only games Action Network flags as trending.

## `minBets` (type: `integer`):

Keep games with at least this many bets tracked by Action Network (totalBets).

## `minSharpGap` (type: `integer`):

Keep games where money % and ticket % differ by at least this much on some side (maxSharpGap).

## `onlyWithOdds` (type: `boolean`):

Skip games no book has priced yet.

## `onlyWithSplits` (type: `boolean`):

Skip games without public betting percentages (tickets and money).

## `startsWithinHours` (type: `integer`):

Keep games that start in the next N hours.

## `startsAfter` (type: `string`):

ISO time, e.g. 2026-11-08T17:00:00Z.

## `startsBefore` (type: `string`):

ISO time, e.g. 2026-11-09T05:00:00Z.

## `sortBy` (type: `string`):

Order of the games within each league and day (with Maximum games, the first ones are kept).

## `maxGames` (type: `integer`):

Cap on game rows for the whole run (0 = no cap).

## `maxGamesPerLeague` (type: `integer`):

Cap per league (empty = no cap).

## `books` (type: `array`):

Books to price, by name or Action Network book id (e.g. 1006 = FanDuel NY). Empty = DraftKings, FanDuel, BetMGM, bet365, BetRivers, Caesars, Fanatics, Kalshi and Polymarket. The consensus line (15, it carries the betting %) and the opening line (30) are always read.

## `periods` (type: `array`):

Segments to price besides the full game (always read). Not every game prices every segment.

## `includeGameDetail` (type: `boolean`):

Rosters, box score and season stats, play-by-play, lineups, officials, venue, game injuries, depth charts, team stats and trends in each game row (one read per game; included in the game price).

## `includeExpertPicks` (type: `boolean`):

Each Action Network expert's pick on the game with record, units, ROI, streak and followers, plus a per-side expert consensus. Included in the game price.

## `includeWeather` (type: `boolean`):

Hourly forecast at the venue for upcoming outdoor games (football, baseball, soccer). Included in the game price.

## `includeLineMovement` (type: `boolean`):

Every timestamped price change per book back to the opener, plus steam moves (3+ books moving the same way within 10 minutes). Charged per game that has history.

## `includeProps` (type: `boolean`):

The prop board of each game (NFL ~99 prop types, NBA ~76) with every selected book's line and price. Charged per game that has props.

## `propTypes` (type: `array`):

Only these prop types (names or groups as Action Network shows them: "Pass Yds", "Points", "Anytime TD Scorer", "Rushing"). Empty = all.

## `includeInjuries` (type: `boolean`):

One row per league with the current injury report. Charged per league report with at least one injury.

## `includeStandings` (type: `boolean`):

One row per league: records, against-the-spread and over/under records, points, ranks, streak. Free.

## `includeFutures` (type: `boolean`):

Futures odds (champion, conference, division, MVP and awards, win totals, player season totals): one row per selection with every book's price and the best one. Charged per row.

## `futureCategories` (type: `array`):

Only categories whose name contains one of these, e.g. "Superbowl", "MVP", "Total Wins". Empty = all.

## `maxFutures` (type: `integer`):

Cap on futures rows for the run (NFL alone lists ~1,600).

## `includeGames` (type: `boolean`):

Turn off to get only injury reports, standings or futures.

## `outputMode` (type: `string`):

Compact keeps odds, splits, movement, best prices, signals, results and the expert consensus, and drops the bulky blocks.

## `monitorMode` (type: `boolean`):

Deliver only games that are new or whose lines, odds, betting % or status moved since the last run with the same Monitor name (with the previous values and a splits trend). An unchanged poll costs almost nothing.

## `monitorName` (type: `string`):

Keeps separate memories for separate schedules.

## `resetMonitor` (type: `boolean`):

Start the monitor memory over (every game is NEW again).

## `minLineMove` (type: `number`):

A spread or total change of at least this much counts as LINE_MOVED.

## `minOddsMove` (type: `integer`):

A moneyline / spread / total price change of at least this much (American odds) counts as ODDS_MOVED.

## `minSplitMove` (type: `integer`):

A tickets % or money % change of at least this much on any side counts as SPLITS_MOVED.

## `monitorOn` (type: `array`):

Which changes deliver a game. Empty = everything except score changes.

## `includeUnchanged` (type: `boolean`):

Monitor mode: also deliver (and charge) games that did not move, marked UNCHANGED.

## `webhookUrl` (type: `string`):

Receives the run's flagged games as one JSON POST (reverse line moves, sharp money, steam, arbitrage...).

## `slackWebhookUrl` (type: `string`):

Slack incoming-webhook URL for the same alert.

## `discordWebhookUrl` (type: `string`):

Discord webhook URL for the same alert.

## `alertOn` (type: `array`):

Empty = reverse line moves, sharp money, steam and arbitrage.

## `alertMinSharpGap` (type: `integer`):

With Alert on: sharp gap.

## `maxConcurrency` (type: `integer`):

Game reads in flight at once.

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

Not needed: Action Network answers directly. If a request is refused the run moves to the Apify datacenter, then residential proxy by itself. Set your own proxy here to use it first.

## Actor input object example

```json
{
  "leagues": [
    "nba",
    "nfl",
    "nhl",
    "mlb",
    "soccer"
  ],
  "onlyTrending": false,
  "onlyWithOdds": false,
  "onlyWithSplits": false,
  "sortBy": "startTime",
  "maxGames": 10,
  "maxGamesPerLeague": 2,
  "includeGameDetail": true,
  "includeExpertPicks": true,
  "includeWeather": true,
  "includeLineMovement": false,
  "includeProps": false,
  "includeInjuries": false,
  "includeStandings": false,
  "includeFutures": false,
  "maxFutures": 100,
  "includeGames": true,
  "outputMode": "full",
  "monitorMode": false,
  "monitorName": "default",
  "resetMonitor": false,
  "minLineMove": 0.5,
  "minOddsMove": 10,
  "minSplitMove": 2,
  "includeUnchanged": false,
  "alertMinSharpGap": 20,
  "maxConcurrency": 16,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

One item per game (odds from every selected book, public betting %, best prices, line movement, signals, result, game detail, expert picks, optional line history and props), plus injury, standings and futures rows when asked.

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

Per-scoreboard counts, filters, reads and egress (written for runs where a read failed).

# 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",
        "nhl",
        "mlb",
        "soccer"
    ],
    "maxGames": 10,
    "maxGamesPerLeague": 2
};

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

# Prepare the Actor input
run_input = {
    "leagues": [
        "nba",
        "nfl",
        "nhl",
        "mlb",
        "soccer",
    ],
    "maxGames": 10,
    "maxGamesPerLeague": 2,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/action-network-scraper").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",
    "nhl",
    "mlb",
    "soccer"
  ],
  "maxGames": 10,
  "maxGamesPerLeague": 2
}' |
apify call topapi/action-network-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/action-network-scraper"
        }
    }
}
```

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/tvY1XstEMNPOGArL2/builds/mbzbXtRY5jcdbEAjo/openapi.json
