# Sports Betting Odds Scraper - Live Lines, Arbitrage & +EV (`scrapesage/sports-betting-odds-scraper`) Actor
Scrape live sports betting odds from FanDuel, Bovada & Pinnacle (sharp lines): moneyline, spread & totals for NFL, NBA, MLB, NHL, UFC, soccer & more. Best price per outcome, no-vig fair odds, arbitrage & +EV value detection, line-movement monitoring. No third-party API key. JSON, CSV, Excel.
- **URL**: https://apify.com/scrapesage/sports-betting-odds-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Automation, Developer tools, Integrations
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $8.00 / 1,000 game / event odds records
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
## Sports Betting Odds Scraper — Live Lines, Best Price, Arbitrage & +EV
Pull **live sports betting odds** from **FanDuel, Bovada and Pinnacle** in one run — moneyline, spread/handicap and totals for **NFL, NBA, MLB, NHL, WNBA, UFC/MMA, FIFA World Cup, soccer, tennis, golf and more**. Every game comes back as one clean record with **every book's price side by side**, the **best price per outcome** (line shopping), **no-vig fair odds**, and automatic **arbitrage** and **+EV value-bet** detection.
**No third-party odds API key.** The actor reads each sportsbook's own JSON directly — fast, keyless, no browser. Add **monitoring mode** to capture only **new games and line movement** since your last run.
### Why this sports odds scraper?
Most odds scrapers give you one book, or wrap a paid third-party odds API, and return raw prices with no analysis. This actor aggregates **multiple books directly** and ships the **richest, most actionable odds dataset in the category**:
| Feature | Typical scrapers | This actor |
|---|---|---|
| Books in a single run | 1 | ✅ FanDuel + Bovada + **Pinnacle (sharp)** |
| Needs a paid third-party odds API key | often | ✅ No — direct from each book |
| Best price per outcome (line shopping) | ❌ | ✅ |
| No-vig **fair** odds & implied probability | ❌ | ✅ per book + sharp/consensus |
| **Arbitrage** detection with stake split | ❌ | ✅ |
| **+EV value bets** vs the sharp line | ❌ | ✅ |
| Moneyline + spread + totals (full game) | partial | ✅ all three |
| 2-way **and** 3-way (soccer draw) markets | ❌ | ✅ |
| Live / in-play odds | ❌ | ✅ opt-in |
| Line-movement **monitoring** (only changes) | ❌ | ✅ |
| Output as rich per-game records **or** flat rows | ❌ | ✅ both |
Pinnacle is the book sharp bettors price off because it runs the lowest margin (often ~2% vs 4–5% at recreational books). This actor uses Pinnacle's **no-vig** line as the fair-value reference, so a FanDuel or Bovada price that beats it is flagged as **+EV** automatically.
### Use cases
- **Line shopping** — always bet the best available number. Each outcome shows every book's price and which book has the best one.
- **Arbitrage / sure bets** — surface games where the best price on each side guarantees a profit, with the exact stake split per leg.
- **+EV / value betting** — find recreational-book prices that beat Pinnacle's sharp no-vig fair odds.
- **Line-movement & steam tracking** — schedule the actor with monitoring mode to capture only odds that moved, perfect for alerts.
- **Models & backtesting** — feed clean, normalized moneyline/spread/total data (American + decimal + implied probability) into your prediction or pricing models.
- **Odds comparison sites, bots & dashboards** — power a comparison widget, Discord/Telegram bot, or BI dashboard with structured multi-book odds.
### How to use
1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **Sports Betting Odds Scraper**, pick your **leagues**, **books** and **markets**, and click **Start**.
3. Watch games stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML or RSS — or pull results via the [Apify API](https://docs.apify.com/api/v2).
### Input
```json
{
"leagues": ["MLB", "WORLDCUP", "NBA", "UFC"],
"books": ["pinnacle", "fanduel", "bovada"],
"markets": ["moneyline", "spread", "total"],
"outputMode": "events",
"includeLive": true,
"onlyArbitrage": false,
"maxEvents": 200
}
````
- **leagues** — MLB, NBA, WNBA, NCAAB, NFL, NCAAF, NHL, UFC, FIFA World Cup, EPL, UCL, MLS, La Liga, ATP, WTA, PGA, Boxing. Out-of-season leagues simply return nothing.
- **books** — `pinnacle` (sharp reference), `fanduel`, `bovada`. Use 2+ to unlock best price + arbitrage.
- **markets** — `moneyline`, `spread` (run line / puck line / handicap), `total` (over/under).
- **outputMode** — `events` (one rich record per game, default) or `rows` (one flat row per book × market × selection).
- **includeLive** *(default true)* — include in-play games.
- **includeAlternateLines** *(default false)* — capture every alternate spread & total, not just the main line.
- **onlyArbitrage / onlyValueBets** — emit only games with an arbitrage or a +EV bet.
- **minArbitrageProfit / minValueEdge** — minimum % thresholds for those flags.
- **monitorMode** *(default false)* — emit only new games and **moved lines** since the last run (great with Schedules).
- **maxEvents** — cap on games per run.
- **fanduelState** — which state's FanDuel lines to read (default Virginia).
### Output
Event mode — one rich record per game (`type: "event"`):
```json
{
"type": "event",
"eventKey": "MLB|2026-06-17|cincinnati reds-new york mets",
"sport": "Baseball",
"league": "MLB",
"leagueName": "MLB",
"eventName": "New York Mets @ Cincinnati Reds",
"homeTeam": "Cincinnati Reds",
"awayTeam": "New York Mets",
"startTime": "2026-06-17T16:40:00.000Z",
"isLive": false,
"books": ["pinnacle", "fanduel", "bovada"],
"bookCount": 3,
"sharpBook": "pinnacle",
"markets": {
"moneyline": {
"selections": {
"home": {
"team": "Cincinnati Reds",
"prices": [
{ "book": "bovada", "american": 111, "decimal": 2.11, "impliedProbability": 0.4739 },
{ "book": "fanduel", "american": 114, "decimal": 2.14, "impliedProbability": 0.4673 },
{ "book": "pinnacle", "american": 115, "decimal": 2.15, "impliedProbability": 0.4651 }
],
"best": { "book": "pinnacle", "american": 115, "decimal": 2.15 }
},
"away": { "team": "New York Mets", "prices": [ "..." ], "best": { "book": "pinnacle", "american": -127 } }
},
"fairProbabilities": { "home": 0.454, "away": 0.546 },
"fairReference": "pinnacle",
"bestPrice": { "home": { "book": "pinnacle", "american": 115 }, "away": { "book": "pinnacle", "american": -127 } }
},
"spread": { "lines": [ { "point": 1.5, "awayPoint": -1.5, "home": { "best": { "book": "pinnacle", "american": -141 } }, "away": { "best": { "book": "bovada", "american": 125 } } } ] },
"total": { "lines": [ { "point": 9, "over": { "best": { "book": "fanduel", "american": -108 } }, "under": { "best": { "book": "bovada", "american": -105 } } } ] }
},
"arbitrage": { "exists": false, "count": 0, "opportunities": [] },
"valueBets": [],
"scrapedAt": "2026-06-17T15:30:00.000Z"
}
```
Rows mode — one flat record per price (`type: "oddsRow"`):
```json
{ "type": "oddsRow", "league": "MLB", "eventName": "New York Mets @ Cincinnati Reds", "market": "moneyline", "selection": "home", "team": "Cincinnati Reds", "point": null, "book": "fanduel", "american": 114, "decimal": 2.14, "impliedProbability": 0.4673, "isBestPrice": false, "fairProbability": 0.454 }
```
When an arbitrage exists, each opportunity includes the legs and the exact stake split:
```json
{ "market": "moneyline", "profitPercent": 1.84, "impliedBookSum": 0.982,
"legs": [ { "side": "home", "book": "bovada", "american": 118, "stakePercent": 47.1 },
{ "side": "away", "book": "fanduel", "american": -115, "stakePercent": 52.9 } ] }
```
### Automate & schedule
Run this actor on autopilot and pull odds into your own stack:
- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run every few minutes/hourly to track line movement, or daily to grab the next slate. Combine with monitoring mode to capture only what changed.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — fire a Slack/Discord alert or CRM/sheet update the moment a run finds an arbitrage or a moved line.
```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });
const run = await client.actor('scrapesage/sports-betting-odds-scraper').call({
leagues: ['MLB', 'WORLDCUP', 'NBA'],
books: ['pinnacle', 'fanduel', 'bovada'],
markets: ['moneyline', 'spread', 'total'],
onlyArbitrage: false,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got odds for ${items.length} games`);
```
### Integrate with any app
Connect the dataset to 5,000+ apps — no code required:
- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push arbs or line moves straight into a sheet or chat.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored slate has a value bet.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe odds into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.
### Use with AI assistants (MCP)
The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find tonight's MLB games where FanDuel beats the Pinnacle no-vig line" and let it run this scraper for you.
### More scrapers from scrapesage
Build a complete real-time data stack:
- **[CoinGecko Crypto Scraper](https://apify.com/scrapesage/coingecko-crypto-scraper)** — crypto prices, markets, NFTs & exchanges with monitoring.
- **[Yahoo Finance Scraper](https://apify.com/scrapesage/yahoo-finance-scraper)** — stocks, ETFs, FX, crypto quotes, financials & analyst ratings.
- **[Google News Scraper](https://apify.com/scrapesage/google-news-scraper)** — articles, full text & related coverage with monitoring.
- **[Google Trends Scraper](https://apify.com/scrapesage/google-trends-scraper)** — search-demand & trending topics across Google surfaces.
- **[Eventbrite Scraper](https://apify.com/scrapesage/eventbrite-scraper)** — events, ticket prices & organizer leads.
- **[Resident Advisor Scraper](https://apify.com/scrapesage/resident-advisor-scraper)** — electronic-music events, venues & promoter leads.
- **[Steam Scraper](https://apify.com/scrapesage/steam-scraper)** — game store data, prices & reviews.
- **[YouTube Scraper](https://apify.com/scrapesage/youtube-scraper)** — channels, videos & creator contacts.
### Tips
- **Get data right now**: pick an in-season league. In summer, MLB, WNBA and the FIFA World Cup are live; in fall/winter, NFL, NBA, NHL and college sports.
- **Best price & arbitrage need 2+ books** — keep at least two books selected (Pinnacle + one recreational book is the most useful pairing).
- **More opportunities**: arbitrage and +EV fire most often on **live** games, **alternate lines**, soccer and less efficient markets — enable `includeLive` and `includeAlternateLines`.
- **Line-movement monitoring**: turn on `monitorMode` and schedule the run; you'll only get games whose odds changed.
- **Proxies**: the default Apify Proxy (datacenter, US) works for all three books. If one starts blocking, switch to Residential in the proxy settings.
### FAQ
**Do I need a sportsbook account or a paid odds API key?** No. The actor reads each sportsbook's own public JSON directly. No login, no third-party odds API, no browser.
**Which books are supported?** FanDuel, Bovada and Pinnacle. Pinnacle is included as the sharp reference book used for no-vig fair odds and +EV detection.
**What are no-vig / fair odds?** Sportsbooks bake a margin ("vig") into their prices. Removing it gives the implied "fair" probability of each outcome. The actor reports per-book no-vig probabilities and a sharp/consensus fair line so you can spot mispriced sides.
**How does arbitrage detection work?** For each market it takes the best available price on every outcome across your selected books; if their implied probabilities sum to under 100%, it's an arbitrage, and the actor returns the guaranteed profit % and the stake split per leg.
**Can I get only the opportunities?** Yes — enable `onlyArbitrage` and/or `onlyValueBets`, and set `minArbitrageProfit` / `minValueEdge` thresholds.
**How do I track line movement?** Turn on `monitorMode` and run on a [Schedule](https://docs.apify.com/platform/schedules). The actor remembers prior odds and emits only games that are new or whose lines moved.
**American or decimal odds?** Both — every price includes American odds, decimal odds and implied probability.
**Is scraping odds legal?** This actor collects publicly available odds data. You are responsible for using the data in compliance with applicable laws and each site's terms, and for gambling responsibly where legal.
### Need help?
Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests (more books, leagues, player props) are welcome — this actor is actively maintained.
# Actor input Schema
## `leagues` (type: `array`):
Which leagues to pull odds for. The actor returns whatever games each book currently lists for these leagues (out-of-season leagues simply return nothing). Pick in-season leagues for live data.
## `books` (type: `array`):
Which sportsbooks to pull odds from. Pinnacle = the sharp reference book (its no-vig line powers +EV detection). FanDuel = largest US book. Bovada = popular offshore book. Use 2+ books to unlock best-price line shopping and arbitrage.
## `markets` (type: `array`):
Which betting markets to include. Moneyline = who wins. Spread = point spread / run line / puck line / handicap. Total = over/under total points/runs/goals.
## `outputMode` (type: `string`):
Rich event records = one record per game with every book's prices nested, best price, no-vig fair odds, arbitrage and +EV value bets (the richest format). Flat odds rows = one row per book × market × selection (great for spreadsheets and databases).
## `includeLive` (type: `boolean`):
Include games that have already started (live, in-play odds) in addition to upcoming games.
## `includeAlternateLines` (type: `boolean`):
Also capture alternate point spreads and totals (e.g. every available line, not just the main one). Adds many more selections per game.
## `onlyArbitrage` (type: `boolean`):
Emit only games where a guaranteed-profit arbitrage exists across the selected books (best price on each side sums to under 100%).
## `onlyValueBets` (type: `boolean`):
Emit only games that contain at least one positive-expected-value bet (a book price beating the sharp / consensus no-vig fair odds).
## `minArbitrageProfit` (type: `integer`):
Only flag arbitrage opportunities with at least this guaranteed profit percentage. 0 = flag any positive arbitrage.
## `minValueEdge` (type: `integer`):
Only flag +EV value bets whose edge over the fair price is at least this percentage. 0 = flag any positive edge.
## `maxEvents` (type: `integer`):
Maximum number of games (events) to output this run. In flat-rows mode each game still expands to multiple rows.
## `monitorMode` (type: `boolean`):
Remember odds across runs in a named key-value store and emit ONLY games whose odds are new or have MOVED since the last run. Perfect for line-movement alerts, steam moves and new-game tracking. Works with Apify Schedules — schedule the run, monitoring mode dedupes against prior runs.
## `monitorKey` (type: `string`):
Names the memory used by monitoring mode. Use a distinct key per saved watch so different monitors don't share state.
## `fanduelState` (type: `string`):
US state whose FanDuel sportsbook to read (FanDuel serves slightly different lines per state). Most users can leave the default.
## `pinnacleApiKey` (type: `string`):
Optional override for the Pinnacle guest API key. Leave blank to use the built-in public key.
## `maxConcurrency` (type: `integer`):
Maximum parallel requests across books and leagues. Keep moderate (3–6) to avoid rate limits.
## `proxyConfiguration` (type: `object`):
Proxy settings. Apify Proxy (datacenter, US) works for all three books; switch to Residential if a book starts blocking.
## Actor input object example
```json
{
"leagues": [
"MLB",
"WORLDCUP",
"NBA",
"WNBA",
"NFL",
"UFC",
"EPL"
],
"books": [
"pinnacle",
"fanduel",
"bovada"
],
"markets": [
"moneyline",
"spread",
"total"
],
"outputMode": "events",
"includeLive": true,
"includeAlternateLines": false,
"onlyArbitrage": false,
"onlyValueBets": false,
"minArbitrageProfit": 0,
"minValueEdge": 0,
"maxEvents": 200,
"monitorMode": false,
"monitorKey": "default",
"fanduelState": "va",
"maxConcurrency": 4,
"proxyConfiguration": {
"useApifyProxy": true
}
}
```
# Actor output Schema
## `results` (type: `string`):
All scraped odds records as JSON items in the default dataset.
# 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": [
"MLB",
"WORLDCUP",
"NBA",
"WNBA",
"NFL",
"UFC",
"EPL"
],
"books": [
"pinnacle",
"fanduel",
"bovada"
],
"markets": [
"moneyline",
"spread",
"total"
],
"proxyConfiguration": {
"useApifyProxy": true
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/sports-betting-odds-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": [
"MLB",
"WORLDCUP",
"NBA",
"WNBA",
"NFL",
"UFC",
"EPL",
],
"books": [
"pinnacle",
"fanduel",
"bovada",
],
"markets": [
"moneyline",
"spread",
"total",
],
"proxyConfiguration": { "useApifyProxy": True },
}
# Run the Actor and wait for it to finish
run = client.actor("scrapesage/sports-betting-odds-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": [
"MLB",
"WORLDCUP",
"NBA",
"WNBA",
"NFL",
"UFC",
"EPL"
],
"books": [
"pinnacle",
"fanduel",
"bovada"
],
"markets": [
"moneyline",
"spread",
"total"
],
"proxyConfiguration": {
"useApifyProxy": true
}
}' |
apify call scrapesage/sports-betting-odds-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapesage/sports-betting-odds-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Sports Betting Odds Scraper - Live Lines, Arbitrage & +EV",
"description": "Scrape live sports betting odds from FanDuel, Bovada & Pinnacle (sharp lines): moneyline, spread & totals for NFL, NBA, MLB, NHL, UFC, soccer & more. Best price per outcome, no-vig fair odds, arbitrage & +EV value detection, line-movement monitoring. No third-party API key. JSON, CSV, Excel.",
"version": "0.1",
"x-build-id": "Q3zOJkEhsz0I824TP"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~sports-betting-odds-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-sports-betting-odds-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/scrapesage~sports-betting-odds-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-sports-betting-odds-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/scrapesage~sports-betting-odds-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-sports-betting-odds-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": {
"leagues": {
"title": "Leagues / sports",
"type": "array",
"description": "Which leagues to pull odds for. The actor returns whatever games each book currently lists for these leagues (out-of-season leagues simply return nothing). Pick in-season leagues for live data.",
"items": {
"type": "string",
"enum": [
"MLB",
"WORLDCUP",
"NBA",
"WNBA",
"NCAAB",
"NFL",
"NCAAF",
"NHL",
"UFC",
"EPL",
"UCL",
"MLS",
"LALIGA",
"ATP",
"WTA",
"PGA",
"BOXING"
],
"enumTitles": [
"MLB (baseball)",
"Soccer — FIFA World Cup",
"NBA (basketball)",
"WNBA (basketball)",
"NCAA Basketball",
"NFL (football)",
"NCAA Football",
"NHL (hockey)",
"UFC / MMA",
"Soccer — English Premier League",
"Soccer — UEFA Champions League",
"Soccer — MLS",
"Soccer — La Liga",
"Tennis — ATP",
"Tennis — WTA",
"PGA Golf",
"Boxing"
]
},
"default": [
"MLB",
"WORLDCUP",
"NBA",
"WNBA",
"NFL",
"UFC",
"EPL"
]
},
"books": {
"title": "Sportsbooks",
"type": "array",
"description": "Which sportsbooks to pull odds from. Pinnacle = the sharp reference book (its no-vig line powers +EV detection). FanDuel = largest US book. Bovada = popular offshore book. Use 2+ books to unlock best-price line shopping and arbitrage.",
"items": {
"type": "string",
"enum": [
"pinnacle",
"fanduel",
"bovada"
],
"enumTitles": [
"Pinnacle (sharp lines)",
"FanDuel",
"Bovada"
]
},
"default": [
"pinnacle",
"fanduel",
"bovada"
]
},
"markets": {
"title": "Markets",
"type": "array",
"description": "Which betting markets to include. Moneyline = who wins. Spread = point spread / run line / puck line / handicap. Total = over/under total points/runs/goals.",
"items": {
"type": "string",
"enum": [
"moneyline",
"spread",
"total"
],
"enumTitles": [
"Moneyline",
"Spread / handicap",
"Total (over/under)"
]
},
"default": [
"moneyline",
"spread",
"total"
]
},
"outputMode": {
"title": "Output shape",
"enum": [
"events",
"rows"
],
"type": "string",
"description": "Rich event records = one record per game with every book's prices nested, best price, no-vig fair odds, arbitrage and +EV value bets (the richest format). Flat odds rows = one row per book × market × selection (great for spreadsheets and databases).",
"default": "events"
},
"includeLive": {
"title": "Include live (in-play) games",
"type": "boolean",
"description": "Include games that have already started (live, in-play odds) in addition to upcoming games.",
"default": true
},
"includeAlternateLines": {
"title": "Include alternate spreads & totals",
"type": "boolean",
"description": "Also capture alternate point spreads and totals (e.g. every available line, not just the main one). Adds many more selections per game.",
"default": false
},
"onlyArbitrage": {
"title": "Only arbitrage games",
"type": "boolean",
"description": "Emit only games where a guaranteed-profit arbitrage exists across the selected books (best price on each side sums to under 100%).",
"default": false
},
"onlyValueBets": {
"title": "Only +EV value games",
"type": "boolean",
"description": "Emit only games that contain at least one positive-expected-value bet (a book price beating the sharp / consensus no-vig fair odds).",
"default": false
},
"minArbitrageProfit": {
"title": "Min arbitrage profit %",
"minimum": 0,
"type": "integer",
"description": "Only flag arbitrage opportunities with at least this guaranteed profit percentage. 0 = flag any positive arbitrage.",
"default": 0
},
"minValueEdge": {
"title": "Min value edge %",
"minimum": 0,
"type": "integer",
"description": "Only flag +EV value bets whose edge over the fair price is at least this percentage. 0 = flag any positive edge.",
"default": 0
},
"maxEvents": {
"title": "Max events",
"minimum": 1,
"type": "integer",
"description": "Maximum number of games (events) to output this run. In flat-rows mode each game still expands to multiple rows.",
"default": 200
},
"monitorMode": {
"title": "Monitoring mode — only new odds & line moves",
"type": "boolean",
"description": "Remember odds across runs in a named key-value store and emit ONLY games whose odds are new or have MOVED since the last run. Perfect for line-movement alerts, steam moves and new-game tracking. Works with Apify Schedules — schedule the run, monitoring mode dedupes against prior runs.",
"default": false
},
"monitorKey": {
"title": "Monitor key",
"type": "string",
"description": "Names the memory used by monitoring mode. Use a distinct key per saved watch so different monitors don't share state.",
"default": "default"
},
"fanduelState": {
"title": "FanDuel state",
"enum": [
"az",
"co",
"ct",
"il",
"in",
"ia",
"ks",
"ky",
"la",
"md",
"mi",
"nj",
"ny",
"oh",
"pa",
"tn",
"va",
"wv",
"wy",
"nc",
"vt",
"dc"
],
"type": "string",
"description": "US state whose FanDuel sportsbook to read (FanDuel serves slightly different lines per state). Most users can leave the default.",
"default": "va"
},
"pinnacleApiKey": {
"title": "Pinnacle API key (optional)",
"type": "string",
"description": "Optional override for the Pinnacle guest API key. Leave blank to use the built-in public key."
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 12,
"type": "integer",
"description": "Maximum parallel requests across books and leagues. Keep moderate (3–6) to avoid rate limits.",
"default": 4
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy settings. Apify Proxy (datacenter, US) works for all three books; switch to Residential if a book starts blocking.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```