{ "openapi": "3.0.1", "info": { "title": "MLB Player & Game Stats Scraper", "description": "Extract MLB teams, rosters, player season stats, schedules, scores and standings from the public MLB Stats API.", "version": "0.1", "x-build-id": "qJIhz8wkEt3HMXNpR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~mlb-stats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-mlb-stats-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/scrapers_lat~mlb-stats-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-mlb-stats-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/scrapers_lat~mlb-stats-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-mlb-stats-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": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of records to collect. Optional." }, "withDetails": { "title": "Include Player Stats (roster mode)", "type": "boolean", "description": "In roster mode, when enabled the scraper also fetches each player's season hitting or pitching stats and bio (height, weight, bat side, throwing hand, birthplace). Has no effect in other modes.", "default": true }, "mode": { "title": "Mode", "enum": [ "teams", "roster", "players", "schedule", "standings" ], "type": "string", "description": "What to collect. teams = all 30 MLB clubs. roster = every player on a team. players = profile and season stats for specific players. schedule = games and final scores for a date. standings = division standings for a league and season.", "default": "standings" }, "season": { "title": "Season", "minimum": 1876, "maximum": 2030, "type": "integer", "description": "Season year (used by teams, roster, players and standings modes). Defaults to the current MLB season when left empty." }, "teamId": { "title": "Team (roster mode)", "enum": [ "109", "133", "144", "110", "111", "112", "145", "113", "114", "115", "116", "117", "118", "108", "119", "146", "158", "142", "121", "147", "143", "134", "135", "137", "136", "138", "139", "140", "141", "120" ], "type": "string", "description": "MLB team whose roster to fetch. Required for roster mode." }, "playerIds": { "title": "Player IDs (players mode)", "type": "array", "description": "MLB player IDs to look up in players mode (one record per player). For example 592450 is Aaron Judge and 660271 is Shohei Ohtani. Find IDs in the output of teams or roster mode.", "items": { "type": "string" } }, "statGroup": { "title": "Stat Group (players / roster mode)", "enum": [ "hitting", "pitching" ], "type": "string", "description": "Which season stat line to attach to each player: hitting or pitching.", "default": "hitting" }, "date": { "title": "Date (schedule mode)", "type": "string", "description": "Date for schedule mode in YYYY-MM-DD format, for example 2025-07-04. Defaults to today when left empty." }, "leagueId": { "title": "League (standings mode)", "enum": [ "103,104", "103", "104" ], "type": "string", "description": "League for standings mode: American League, National League, or both.", "default": "103,104" } } }, "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 } } } } } } } } } }