{ "openapi": "3.0.1", "info": { "title": "StatMuse Sports Stats Scraper (NBA, NFL, MLB, NHL & More)", "description": "Scrapes StatMuse (statmuse.com) answers to natural-language sports questions plus player game logs and team pages for NBA, NFL, MLB, NHL, WNBA, college football, soccer and golf. Returns the answer sentence and stat tables as flat rows. Optional cache skips past-season queries.", "version": "1.0", "x-build-id": "hNwpxua99x91hYdOQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/confidential_gnat~statmuse-sports-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-confidential_gnat-statmuse-sports-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/confidential_gnat~statmuse-sports-scraper/runs": { "post": { "operationId": "runs-sync-confidential_gnat-statmuse-sports-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/confidential_gnat~statmuse-sports-scraper/run-sync": { "post": { "operationId": "run-sync-confidential_gnat-statmuse-sports-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": { "startUrls": { "title": "StatMuse page URLs", "type": "array", "description": "StatMuse question, player game log or team pages, for example https://www.statmuse.com/nba/ask/lebron-james-last-10-games, https://www.statmuse.com/nba/ask?q=celtics+against+the+spread+record, https://www.statmuse.com/nba/player/lebron-james-1780/game-log?seasonYear=2024 or https://www.statmuse.com/nba/team/los-angeles-lakers-15/2025. A plain player page is read as its current game log. Leave empty to use the questions below.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "cacheProjectName": { "title": "Cache project name", "type": "string", "description": "Use the same name on each scheduled run to skip history you already have. Only queries and pages about a finished past season are cached (for example 'most points in a game 2024-25'); 'this season', last N games, leaderboards and current pages are always scraped. Cached ones are skipped and not charged; new records get changeType: new." }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum records per question or start URL. In table row mode a record is one table row (a result table holds up to 50 rows); in whole table mode a record is one table.", "default": 5 }, "queries": { "title": "Questions", "type": "array", "description": "Plain-English sports questions, one per line, for example 'Celtics against the spread record', 'most points in a game 2024-25' or 'Mahomes passing yards 2024'. Each question is asked in the sport selected below.", "items": { "type": "string" } }, "sport": { "title": "Sport for questions", "enum": [ "nba", "nfl", "mlb", "nhl", "wnba", "cfb", "fc", "pga" ], "type": "string", "description": "Which StatMuse sport section the questions are asked in. Soccer is /fc. Defaults to NBA.", "default": "nba" }, "flattenTable": { "title": "One record per table row", "type": "boolean", "description": "On: every table row becomes a flat record with its stats as columns (best for CSV and spreadsheets). Off: one record per table with its columns and rows nested.", "default": true }, "includeAnswerText": { "title": "Include answer sentence", "type": "boolean", "description": "Add StatMuse's one-sentence answer to every record. Turn off to make records smaller.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "This website works without a proxy. Enable Apify Proxy only if you get blocked.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }