{ "openapi": "3.0.1", "info": { "title": "MLB Scraper", "description": "[💰 $20 / 1K] Extract MLB games, teams, rosters, players, and standings — scores, schedules, matchups, player bios and season stats, and division and wild-card standings. Pick clubs by name or abbreviation, filter by season and game type.", "version": "1.0", "x-build-id": "ihZCMpu538KtCpdCT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~mlb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-mlb-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/solidcode~mlb-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-mlb-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/solidcode~mlb-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-mlb-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": { "dataType": { "title": "What to extract", "enum": [ "games", "teams", "rosters", "players", "standings" ], "type": "string", "description": "Choose the kind of MLB data you want. Games returns schedules with scores and matchups. Teams returns all 30 clubs with league, division, and venue. Rosters returns each team's active roster. Players returns player bios and season stats. Standings returns division, league, or wild-card standings.", "default": "games" }, "teams": { "title": "Teams", "type": "array", "description": "Team names (e.g. \"New York Yankees\"), abbreviations (e.g. \"NYY\"), team IDs, or mlb.com team page links. Used to pick which teams' Rosters to fetch, and to narrow Games and Standings to specific clubs. Leave empty to include all 30 teams.", "items": { "type": "string" } }, "players": { "title": "Players", "type": "array", "description": "Player names (e.g. \"Shohei Ohtani\"), player IDs, or mlb.com player page links. Applies to the Players data type. Leave empty to fetch all players on the selected teams' rosters instead.", "items": { "type": "string" } }, "season": { "title": "Season (year)", "minimum": 1876, "maximum": 2100, "type": "integer", "description": "The season year to collect, for example 2025. Leave at the current year for the latest season. Applies to all data types.", "default": 2026 }, "startDate": { "title": "Games from date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Collect games on or after this date. Use the format YYYY-MM-DD, for example 2025-05-15. Leave empty to use today. Applies to the Games data type only." }, "endDate": { "title": "Games up to date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Collect games on or before this date. Use the format YYYY-MM-DD. Leave empty to match the start date (a single day). Applies to the Games data type only." }, "gameType": { "title": "Game type", "enum": [ "", "R", "F", "D", "L", "W", "S" ], "type": "string", "description": "Only include games of this type. Leave as \"All game types\" to include everything. Applies to the Games data type.", "default": "" }, "standingsType": { "title": "Standings grouping", "enum": [ "byDivision", "byLeague", "wildCard", "wildCardWithLeaders" ], "type": "string", "description": "How to group the standings. Division shows each division's table, League ranks all teams in each league, Wild Card shows the wild-card race, and Wild Card with leaders adds the division leaders to that view. Applies to the Standings data type only.", "default": "byDivision" }, "includeStats": { "title": "Include season stats", "type": "boolean", "description": "For Rosters and Players, also fetch each player's season stats (hitting, pitching, and fielding). Turn this off for faster, cheaper runs that return only the roster and bio information. Has no effect on Games, Teams, or Standings.", "default": true }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "How many records to collect in total across all filters. Default 100. Set to 0 to collect as many as possible (up to a safety ceiling). You'll get at most this many — fewer when the source has fewer. Rosters are collected team by team and stop once this total is reached. Standings and Teams always return their full fixed set regardless of this value.", "default": 100 } } }, "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 } } } } } } } } } }