{
"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
}
}
}
}
}
}
}
}
}
}