{ "openapi": "3.0.1", "info": { "title": "VegasInsider Scraper - NFL, NBA & MLB Odds, Betting Splits", "description": "Scrape VegasInsider odds for NFL, NBA, MLB, NHL, WNBA and college. Spreads, totals and moneylines from 9 sportsbooks, with opening lines, line movement, ticket and handle splits, futures, player props and scores.", "version": "0.1", "x-build-id": "v8Ywj42JSrXJaAwB4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~vegasinsider-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-vegasinsider-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/parseforge~vegasinsider-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-vegasinsider-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/parseforge~vegasinsider-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-vegasinsider-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", "type": "array", "description": "Leagues with a game-odds board. A league out of season has no games; futures and player props still work.", "items": { "type": "string", "enum": [ "nfl", "nba", "mlb", "nhl", "wnba", "college-football", "college-basketball" ], "enumTitles": [ "NFL", "NBA", "MLB", "NHL", "WNBA", "College Football (NCAAF)", "College Basketball (NCAAB)" ] }, "default": [ "nfl", "mlb" ] }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste VegasInsider pages to scrape directly — an odds board, a futures board, a consensus page or a scoreboard. When set, the league, date and week options are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "dateFrom": { "title": "Date from", "type": "string", "description": "First day to scrape, YYYY-MM-DD. VegasInsider keeps a rolling window of one year back and one year forward." }, "dateTo": { "title": "Date to", "type": "string", "description": "Last day to scrape, YYYY-MM-DD. Inclusive." }, "dates": { "title": "Specific dates", "type": "array", "description": "Exact days as YYYY-MM-DD. Overrides the date range.", "items": { "type": "string" } }, "weeks": { "title": "NFL / college football weeks", "type": "array", "description": "Week ids as the site writes them, e.g. 2026-reg-1, 2026-pre-3, 2025-post-2. Two seasons are online at a time.", "items": { "type": "string" } }, "includeGameOdds": { "title": "Game odds board", "type": "boolean", "description": "The spread, total and moneyline board for each league, one row per game. This is the main result; turn it off to scrape only futures, props, consensus, scores or headlines.", "default": true }, "includeBettingTrends": { "title": "Betting splits (tickets and handle)", "type": "boolean", "description": "One extra request per game. Adds the share of tickets and the share of money on each side of the spread, total and moneyline, plus the handle-minus-tickets gap. Billed per game.", "default": false }, "includeLineMovements": { "title": "Line movement history", "type": "boolean", "description": "One extra request per game. Adds every timestamped price the board has held on the spread, total and moneyline since it opened. Billed per game.", "default": false }, "includeHeadToHead": { "title": "Head-to-head history", "type": "boolean", "description": "One extra request per game. Adds past meetings between the two teams with the closing line, the score and the ATS and over/under result. Billed per game.", "default": false }, "includeFutures": { "title": "Futures odds", "type": "boolean", "description": "Championship, conference, division, award and win-total boards for each league. Billed per selection.", "default": false }, "includePlayerProps": { "title": "Season-long player props", "type": "boolean", "description": "Season-long player markets — passing, rushing and receiving yards, touchdowns, home runs, strikeouts, total bases, RBIs. Includes the DFS books (PrizePicks, Sleeper, Underdog). Billed per selection.", "default": false }, "includeConsensusPicks": { "title": "Handicapper consensus picks", "type": "boolean", "description": "How the site's handicappers are split across each market, with the opening and current numbers. Billed per game.", "default": false }, "includeScoreboard": { "title": "Scores and line scores", "type": "boolean", "description": "Final scores, the inning or quarter grid, team records and starting pitchers. Billed per game.", "default": false }, "includeNews": { "title": "Headlines", "type": "boolean", "description": "The league news deck. Billed per headline.", "default": false }, "sportsbooks": { "title": "Sportsbooks", "type": "array", "description": "Keep only these books in the per-book arrays. Leave empty for every book the board carries.", "items": { "type": "string", "enum": [ "Bet365", "BetMGM", "DraftKings", "Caesars", "FanDuel", "HardRock", "Fanatics", "RiversCasino", "PrizePicks", "Sleeper", "Underdog" ], "enumTitles": [ "bet365", "BetMGM", "DraftKings", "Caesars", "FanDuel", "Hard Rock", "Fanatics", "BetRivers / Rivers Casino", "PrizePicks (DFS)", "Sleeper (DFS)", "Underdog (DFS)" ] } }, "teams": { "title": "Teams or players", "type": "array", "description": "Keep only rows mentioning one of these, matched on any part of the name or abbreviation.", "items": { "type": "string" } }, "searchTerm": { "title": "Search term", "type": "string", "description": "Keep only rows whose matchup, selection, market or headline contains this text." }, "gameStatus": { "title": "Game status", "enum": [ "any", "scheduled", "final" ], "type": "string", "description": "Scheduled games only, finished games only, or both.", "default": "any" }, "startTimeFrom": { "title": "Starts after", "type": "string", "description": "Drop games starting before this ISO timestamp." }, "startTimeTo": { "title": "Starts before", "type": "string", "description": "Drop games starting after this ISO timestamp." }, "minBooks": { "title": "Minimum sportsbooks", "minimum": 0, "type": "integer", "description": "Drop games priced by fewer books than this." }, "minTotal": { "title": "Minimum total", "type": "number", "description": "Drop games whose consensus total is below this." }, "maxTotal": { "title": "Maximum total", "type": "number", "description": "Drop games whose consensus total is above this." }, "minSpread": { "title": "Minimum home spread", "type": "number", "description": "Drop games whose consensus home spread is below this. Negative means the home team is favoured." }, "maxSpread": { "title": "Maximum home spread", "type": "number", "description": "Drop games whose consensus home spread is above this." }, "minMoneylineHome": { "title": "Minimum home moneyline", "type": "integer", "description": "Drop games whose consensus home moneyline is below this, in American odds." }, "maxMoneylineHome": { "title": "Maximum home moneyline", "type": "integer", "description": "Drop games whose consensus home moneyline is above this, in American odds." }, "maxHoldPercent": { "title": "Maximum moneyline hold %", "type": "number", "description": "Drop games where the book's margin on the moneyline is above this. 4.5 keeps the sharper markets." }, "minSpreadMovement": { "title": "Minimum spread move", "type": "number", "description": "Drop games whose spread has moved less than this many points since it opened." }, "minTotalMovement": { "title": "Minimum total move", "type": "number", "description": "Drop games whose total has moved less than this many points since it opened." }, "minTicketPercent": { "title": "Minimum ticket %", "type": "number", "description": "Keep games where one side holds at least this share of tickets. Reads the betting splits, and fetches them even if you did not buy them." }, "minHandlePercent": { "title": "Minimum handle %", "type": "number", "description": "Keep games where one side holds at least this share of the money." }, "reverseLineMoveOnly": { "title": "Reverse line moves only", "type": "boolean", "description": "Keep only games where the spread moved against the side holding most of the tickets.", "default": false }, "futuresMarkets": { "title": "Futures markets", "type": "array", "description": "Keep only futures and prop rows whose market name contains one of these, e.g. mvp, division, win-totals.", "items": { "type": "string" } }, "minBestPrice": { "title": "Minimum best price", "type": "integer", "description": "Drop futures and prop selections whose best price is below this, in American odds." }, "maxBestPrice": { "title": "Maximum best price", "type": "integer", "description": "Drop futures and prop selections whose best price is above this, in American odds." }, "minSelectionBooks": { "title": "Minimum books per selection", "minimum": 0, "type": "integer", "description": "Drop futures and prop selections priced by fewer books than this." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Stop after this many rows. You are billed only for the rows delivered.", "default": 200 }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Games enriched at a time. VegasInsider did not rate-limit in testing; lower it if you add a slow proxy.", "default": 6 }, "maxRequestRetries": { "title": "Request retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "How many times to retry a page that fails or times out. Retries are spaced on a short fixed ladder so a slow upstream cannot eat the whole run.", "default": 2 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for a single page before giving up and retrying.", "default": 30 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The site serves every page anonymously over plain HTTP and did not rate-limit across back-to-back requests, so a proxy only adds cost.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }