--- type: "firecrawl-provider" description: "MLB Baseball Savant (Statcast): player name search and trending players, player bio by MLBAM id, per-plate-appearance game logs, pitch-by-pitch Statcast search over a date window, per-pitch-type summaries, season leaderboards (expected stats, exit velocity, sprint speed, outs above average, pitch arsenals) and the daily MLB schedule with win probability." use_when: "MLB Baseball Savant (Statcast): player name search and trending players, player bio by MLBAM id, per-plate-appearance game logs, pitch-by-pitch Statcast search over a date window, per-pitch-type summaries, season leaderboards (expected stats, exit velocity, sprint speed, outs above average, pitch arsenals) and the daily MLB schedule with win probability." categories: "Sports" capabilities: 8 credits_per_call: 5 --- # MLB Baseball Savant on Firecrawl Alexandria MLB Baseball Savant (Statcast): player name search and trending players, player bio by MLBAM id, per-plate-appearance game logs, pitch-by-pitch Statcast search over a date window, per-pitch-type summaries, season leaderboards (expected stats, exit velocity, sprint speed, outs above average, pitch arsenals) and the daily MLB schedule with win probability. - Categories: Sports - Category index: [Sports category](https://firecrawl.dev/alexandria/agents/categories/sports) - Provider key: `baseballsavant-mlb-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/baseballsavant-mlb-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/openapi.json) ## Capabilities - [Get leaderboard](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_leaderboard): One Baseball Savant leaderboard as the site's CSV export (`/leaderboard/{board}?...&csv=true`): `expected_statistics` (xBA/xSLG/xwOBA, batters or pitchers), `statcast` (exit velocity and barrels, batters or pitchers), `sprint_speed`, `outs_above_average` (fielders) and `pitch_arsenals` (average velocity per pitch type, pitchers). All qualified rows are fetched and paged with `limit`/`cursor`; `columns` names the board-specific metric columns. - [Get pitch type summary](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_pitch_type_summary): Per-pitch-type Statcast aggregates for one batter or pitcher (`/player/pitch_types`): usage, results (BA/SLG/wOBA and expected versions), plate discipline (swings, whiffs, K%, BB%), batted-ball quality (hard-hit %, barrels, exit velocity) and run value, for a season or a date window inside it. An existing player with no data returns an empty list; an unknown id is `not_found`. - [Get player](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_player): One player's biographical record by MLBAM id from the MLB Stats API that Baseball Savant is built on (`statsapi.mlb.com/api/v1/people/{id}?hydrate=currentTeam`): names, number, birth date and place, height/weight, bats/throws, position, current team, debut and draft year, plus the Savant player-page URL. - [Get player gamelogs](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_player_gamelogs): Every plate appearance of one player in one season from Baseball Savant's game logs (`/player-services/gamelogs`): date, game, result, final pitch, and Statcast batted-ball metrics (exit velocity, launch angle, distance, barrel, xBA) with the play id. Newest first; paged with `limit`/`cursor`. An id that exists but has no data for the season returns an empty list; an unknown id is `not_found`. - [Get schedule](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_schedule): All MLB games on one date from Baseball Savant's schedule feed (`/schedule?date=`): game id, type, first-pitch time, status, teams with scores and records, probable pitchers, venue, linescore and Savant's latest win-probability point. A date with no games returns an empty list. - [Search players](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/search_players): Player name autocomplete from Baseball Savant (`/player/search-all`). Returns MLBAM player ids with name, position, club and league. An unknown name returns an empty list (not an error). - [Search statcast](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/search_statcast): Pitch-by-pitch Statcast search (`/statcast_search/csv`, the site's CSV export) for one batter or pitcher, or one team, over a date window of at most 31 days in one season: pitch type, velocity, spin, movement, location, count, result, and batted-ball metrics (exit velocity, launch angle, distance, xBA/xwOBA, bat speed). Rows are returned as the site orders them and paged with `limit`/`cursor`. The export has no play UUID; use `get_player_gamelogs` for `play_id`. - [Trending players](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/trending_players): The players Baseball Savant currently lists as trending (`/savant/api/v1/trending-players`): a short list of MLBAM ids with name, position, club and a page-view trend label. ## 1. Choose this provider when MLB Baseball Savant (Statcast): player name search and trending players, player bio by MLBAM id, per-plate-appearance game logs, pitch-by-pitch Statcast search over a date window, per-pitch-type summaries, season leaderboards (expected stats, exit velocity, sprint speed, outs above average, pitch arsenals) and the daily MLB schedule with win probability. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "baseballsavant-mlb-com", "capability": "baseball-statcast/get_leaderboard", "options": { "board": "expected_statistics", "limit": 5, "season": 2026 } } ``` ## 3. Add provider options Use only the options needed for the task: - `board` (string, required): Which leaderboard. Example: `expected_statistics` - `cursor` (string): Continuation cursor from a previous response's `next_cursor`; send it with the same other inputs to get the next page. Example: `next_cursor` - `limit` (number): Maximum rows per page (default 50, max 1000). Example: `50` - `min` (string): Qualification threshold as the site accepts it: `q` for qualified (default on `expected_statistics`, `statcast`, `outs_above_average`) or a number (plate appearances / batted balls / competitive runs / pitches; default 10 on `sprint_speed`, 100 on `pitch_arsenals`). Pattern: ^(q|[0-9]{1,5})$. Example: `` - `player_type` (string): `batter` (default) or `pitcher`; applies to `expected_statistics` and `statcast` only. Example: `batter` - `season` (number, required): Season year. Statcast pitch tracking starts in 2015; the pitch-level search covers 2008 onward. Example: `2008` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "baseballsavant-mlb-com", capability: "baseball-statcast/get_leaderboard", options: { board: "expected_statistics", limit: 5, season: 2026, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "baseballsavant-mlb-com", "capability": "baseball-statcast/get_leaderboard", "options": { "board": "expected_statistics", "limit": 5, "season": 2026 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "baseballsavant-mlb-com", "capability": "baseball-statcast/get_leaderboard", "options": { "board": "expected_statistics", "limit": 5, "season": 2026 } } }' ``` ### CLI ```sh firecrawl scrape 'baseballsavant-mlb-com/baseball-statcast/get_leaderboard' \ --options '{"board":"expected_statistics","limit":5,"season":2026}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "baseballsavant-mlb-com", "capability": "baseball-statcast/get_leaderboard", "options": { "board": "expected_statistics", "limit": 5, "season": 2026 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "baseballsavant-mlb-com", "capability": "baseball-statcast/get_leaderboard", "options": { "board": "expected_statistics", "limit": 5, "season": 2026 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "board": "expected_statistics", "columns": [ "year", "pa", "bip", "ba", "est_ba", "est_ba_minus_ba_diff", "slg", "est_slg", "est_slg_minus_slg_diff", "woba", "est_woba", "est_woba_minus_woba_diff" ], "count": 5, "min": "q", "next_cursor": "5", "observed_at_ms": 1791156867556, "player_type": "batter", "rows": [ { "metrics": { "ba": 0.28, "bip": 444, "est_ba": 0.264, "est_ba_minus_ba_diff": 0.016000000000000014, "est_slg": 0.508, "est_slg_minus_slg_diff": 0.061999999999999944, "est_woba": 0.374, "est_woba_minus_woba_diff": 0.026000000000000023, "pa": 726, "slg": 0.57, "woba": 0.4, "year": 2026 }, "name": "Crow-Armstrong, Pete", "player_id": 691718 }, { "metrics": { "ba": 0.241, "bip": 472, "est_ba": 0.249, "est_ba_minus_ba_diff": -0.008000000000000007, "est_slg": 0.39, "est_slg_minus_slg_diff": -0.008000000000000007, "est_woba": 0.336, "est_woba_minus_woba_diff": -0.007000000000000006, "pa": 717, "slg": 0.382, "woba": 0.329, "year": 2026 }, "name": "Herrera, Iván", "player_id": 671056 }, { "metrics": { "ba": 0.242, "bip": 440, "est_ba": 0.233, "est_ba_minus_ba_diff": 0.00899999999999998, "est_slg": 0.402, "est_slg_minus_slg_diff": -0.009000000000000008, "est_woba": 0.331, "est_woba_minus_woba_diff": 0.0020000000000000018, "pa": 710, "slg": 0.393, "woba": 0.333, "year": 2026 }, "name": "Busch, Michael", "player_id": 683737 }, { "metrics": { "ba": 0.278, "bip": 509, "est_ba": 0.264, "est_ba_minus_ba_diff": 0.014000000000000012, "est_slg": 0.445, "est_slg_minus_slg_diff": -0.015000000000000013, "est_woba": 0.355, "est_woba_minus_woba_diff": 0.0020000000000000018, "pa": 707, "slg": 0.43, "woba": 0.357, "year": 2026 }, "name": "McGonigle, Kevin", "player_id": 805808 }, { "metrics": { "ba": 0.289, "bip": 503, "est_ba": 0.296, "est_ba_minus_ba_diff": -0.007000000000000006, "est_slg": 0.5, "est_slg_minus_slg_diff": -0.030000000000000027, "est_woba": 0.379, "est_woba_minus_woba_diff": -0.02100000000000002, "pa": 704, "slg": 0.47, "woba": 0.358, "year": 2026 }, "name": "Tatis Jr., Fernando", "player_id": 665487 } ], "season": 2026, "source_url": "https://baseballsavant.mlb.com/leaderboard/expected_statistics?type=batter&year=2026&position=&team=&filterType=bip&min=q&sort=0&sortDir=asc&csv=true", "total": 246 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get leaderboard - Capability: `baseball-statcast/get_leaderboard` - Description: One Baseball Savant leaderboard as the site's CSV export (`/leaderboard/{board}?...&csv=true`): `expected_statistics` (xBA/xSLG/xwOBA, batters or pitchers), `statcast` (exit velocity and barrels, batters or pitchers), `sprint_speed`, `outs_above_average` (fielders) and `pitch_arsenals` (average velocity per pitch type, pitchers). All qualified rows are fetched and paged with `limit`/`cursor`; `columns` names the board-specific metric columns. - Instructions: Season-level rankings across players; take `player_id` into the player functions. Boards not listed here are not supported. - Cost: 5 credits per call - Capability file: [Get leaderboard](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_leaderboard) Accepted options: - `board` (string, required): Which leaderboard. Example: `expected_statistics` - `cursor` (string): Continuation cursor from a previous response's `next_cursor`; send it with the same other inputs to get the next page. Example: `next_cursor` - `limit` (number): Maximum rows per page (default 50, max 1000). Example: `50` - `min` (string): Qualification threshold as the site accepts it: `q` for qualified (default on `expected_statistics`, `statcast`, `outs_above_average`) or a number (plate appearances / batted balls / competitive runs / pitches; default 10 on `sprint_speed`, 100 on `pitch_arsenals`). Pattern: ^(q|[0-9]{1,5})$. Example: `` - `player_type` (string): `batter` (default) or `pitcher`; applies to `expected_statistics` and `statcast` only. Example: `batter` - `season` (number, required): Season year. Statcast pitch tracking starts in 2015; the pitch-level search covers 2008 onward. Example: `2008` Response schema example: ```json { "board": "expected_statistics", "columns": [ "year", "pa", "bip", "ba", "est_ba", "est_ba_minus_ba_diff", "slg", "est_slg", "est_slg_minus_slg_diff", "woba", "est_woba", "est_woba_minus_woba_diff" ], "count": 5, "min": "q", "next_cursor": "5", "observed_at_ms": 1791156867556, "player_type": "batter", "rows": [ { "metrics": { "ba": 0.28, "bip": 444, "est_ba": 0.264, "est_ba_minus_ba_diff": 0.016000000000000014, "est_slg": 0.508, "est_slg_minus_slg_diff": 0.061999999999999944, "est_woba": 0.374, "est_woba_minus_woba_diff": 0.026000000000000023, "pa": 726, "slg": 0.57, "woba": 0.4, "year": 2026 }, "name": "Crow-Armstrong, Pete", "player_id": 691718 }, { "metrics": { "ba": 0.241, "bip": 472, "est_ba": 0.249, "est_ba_minus_ba_diff": -0.008000000000000007, "est_slg": 0.39, "est_slg_minus_slg_diff": -0.008000000000000007, "est_woba": 0.336, "est_woba_minus_woba_diff": -0.007000000000000006, "pa": 717, "slg": 0.382, "woba": 0.329, "year": 2026 }, "name": "Herrera, Iván", "player_id": 671056 }, { "metrics": { "ba": 0.242, "bip": 440, "est_ba": 0.233, "est_ba_minus_ba_diff": 0.00899999999999998, "est_slg": 0.402, "est_slg_minus_slg_diff": -0.009000000000000008, "est_woba": 0.331, "est_woba_minus_woba_diff": 0.0020000000000000018, "pa": 710, "slg": 0.393, "woba": 0.333, "year": 2026 }, "name": "Busch, Michael", "player_id": 683737 }, { "metrics": { "ba": 0.278, "bip": 509, "est_ba": 0.264, "est_ba_minus_ba_diff": 0.014000000000000012, "est_slg": 0.445, "est_slg_minus_slg_diff": -0.015000000000000013, "est_woba": 0.355, "est_woba_minus_woba_diff": 0.0020000000000000018, "pa": 707, "slg": 0.43, "woba": 0.357, "year": 2026 }, "name": "McGonigle, Kevin", "player_id": 805808 }, { "metrics": { "ba": 0.289, "bip": 503, "est_ba": 0.296, "est_ba_minus_ba_diff": -0.007000000000000006, "est_slg": 0.5, "est_slg_minus_slg_diff": -0.030000000000000027, "est_woba": 0.379, "est_woba_minus_woba_diff": -0.02100000000000002, "pa": 704, "slg": 0.47, "woba": 0.358, "year": 2026 }, "name": "Tatis Jr., Fernando", "player_id": 665487 } ], "season": 2026, "source_url": "https://baseballsavant.mlb.com/leaderboard/expected_statistics?type=batter&year=2026&position=&team=&filterType=bip&min=q&sort=0&sortDir=asc&csv=true", "total": 246 } ``` ### Get pitch type summary - Capability: `baseball-statcast/get_pitch_type_summary` - Description: Per-pitch-type Statcast aggregates for one batter or pitcher (`/player/pitch_types`): usage, results (BA/SLG/wOBA and expected versions), plate discipline (swings, whiffs, K%, BB%), batted-ball quality (hard-hit %, barrels, exit velocity) and run value, for a season or a date window inside it. An existing player with no data returns an empty list; an unknown id is `not_found`. - Instructions: A compact pitch-mix / pitch-outcome profile for a known `player_id` without pulling every pitch. - Cost: 5 credits per call - Capability file: [Get pitch type summary](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_pitch_type_summary) Accepted options: - `end_date` (string): Optional last game date inside the season. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `player_id` (number, required): MLBAM player id (the `player_id` returned by `search_players`, also used by MLB.com and statsapi.mlb.com). Example: `10` - `player_type` (string): `batter` (default) or `pitcher`. Example: `batter` - `season` (number, required): Season year. Statcast pitch tracking starts in 2015; the pitch-level search covers 2008 onward. Example: `2008` - `start_date` (string): Optional first game date inside the season. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` Response schema example: ```json { "count": 10, "end_date": null, "observed_at_ms": 1791156862497, "pitch_types": [ { "at_bats": 50, "avg_exit_velocity_mph": 98.6, "avg_launch_angle_deg": 25.5, "avg_spin_rate_rpm": 2355, "avg_velocity_mph": 95.2, "ba": 0.2, "babip": 0.25, "barrel_percent_bbe": 25, "barrels": 7, "bb_percent": 16.1, "doubles": 2, "fouls": 67, "hard_hit_percent": 71.42857142857143, "hit_by_pitch": 2, "hits": 10, "home_runs": 4, "iso": 0.28, "k_percent": 35.5, "obp": 0.355, "pitch_name": "4-Seam Fastball", "pitch_percent": 25.6, "pitch_type": "FF", "pitches": 311, "plate_appearances": 62, "run_value": 2.065, "run_value_per_100": 0.663987138, "singles": 4, "slg": 0.48, "strikeouts": 22, "swings": 132, "takes": 179, "triples": 0, "walks": 10, "whiff_percent": 28, "whiffs": 37, "woba": 0.366, "xba": 0.256, "xobp": 0.4, "xslg": 0.601, "xwoba": 0.425 }, { "at_bats": 40, "avg_exit_velocity_mph": 92.2, "avg_launch_angle_deg": 9.2, "avg_spin_rate_rpm": 2468, "avg_velocity_mph": 86.8, "ba": 0.175, "babip": 0.24, "barrel_percent_bbe": 15.384615384615383, "barrels": 4, "bb_percent": 6.8, "doubles": 2, "fouls": 39, "hard_hit_percent": 57.692307692307686, "hit_by_pitch": 0, "hits": 7, "home_runs": 1, "iso": 0.125, "k_percent": 34.1, "obp": 0.227, "pitch_name": "Slider", "pitch_percent": 17.5, "pitch_type": "SL", "pitches": 213, "plate_appearances": 44, "run_value": -2.69, "run_value_per_100": -1.262910798, "singles": 4, "slg": 0.3, "strikeouts": 15, "swings": 100, "takes": 113, "triples": 0, "walks": 3, "whiff_percent": 35, "whiffs": 35, "woba": 0.232, "xba": 0.174, "xobp": 0.227, "xslg": 0.345, "xwoba": 0.248 }, { "at_bats": 35, "avg_exit_velocity_mph": 92, "avg_launch_angle_deg": -0.4, "avg_spin_rate_rpm": 2203, "avg_velocity_mph": 94.3, "ba": 0.4, "babip": 0.423, "barrel_percent_bbe": 17.24137931034483, "barrels": 5, "bb_percent": 21.3, "doubles": 2, "fouls": 31, "hard_hit_percent": 58.620689655172406, "hit_by_pitch": 0, "hits": 14, "home_runs": 3, "iso": 0.314, "k_percent": 12.8, "obp": 0.533, "pitch_name": "Sinker", "pitch_percent": 15.4, "pitch_type": "SI", "pitches": 188, "plate_appearances": 47, "run_value": 7.084, "run_value_per_100": 3.768085106, "singles": 9, "slg": 0.714, "strikeouts": 6, "swings": 69, "takes": 119, "triples": 0, "walks": 10, "whiff_percent": 13, "whiffs": 9, "woba": 0.526, "xba": 0.388, "xobp": 0.524, "xslg": 0.731, "xwoba": 0.524 }, { "at_bats": 33, "avg_exit_velocity_mph": 88.2, "avg_launch_angle_deg": 5.4, "avg_spin_rate_rpm": 1760, "avg_velocity_mph": 84.7, "ba": 0.121, "babip": 0.143, "barrel_percent_bbe": 13.636363636363637, "barrels": 3, "bb_percent": 17.5, "doubles": 1, "fouls": 22, "hard_hit_percent": 36.36363636363637, "hit_by_pitch": 0, "hits": 4, "home_runs": 1, "iso": 0.121, "k_percent": 27.5, "obp": 0.275, "pitch_name": "Changeup", "pitch_percent": 13.7, "pitch_type": "CH", "pitches": 167, "plate_appearances": 40, "run_value": 0.26, "run_value_per_100": 0.155688623, "singles": 2, "slg": 0.242, "strikeouts": 11, "swings": 71, "takes": 96, "triples": 0, "walks": 7, "whiff_percent": 38, "whiffs": 27, "woba": 0.249, "xba": 0.19, "xobp": 0.332, "xslg": 0.378, "xwoba": 0.32 }, { "at_bats": 24, "avg_exit_velocity_mph": 93.3, "avg_launch_angle_deg": 23.7, "avg_spin_rate_rpm": 2436, "avg_velocity_mph": 90, "ba": 0.333, "babip": 0.5, "barrel_percent_bbe": 14.285714285714285, "barrels": 2, "bb_percent": 7.7, "doubles": 1, "fouls": 17, "hard_hit_percent": 57.14285714285714, "hit_by_pitch": 0, "hits": 8, "home_runs": 2, "iso": 0.292, "k_percent": 38.5, "obp": 0.385, "pitch_name": "Cutter", "pitch_percent": 9.1, "pitch_type": "FC", "pitches": 111, "plate_appearances": 26, "run_value": 2.55, "run_value_per_100": 2.297297297, "singles": 5, "slg": 0.625, "strikeouts": 10, "swings": 55, "takes": 56, "triples": 0, "walks": 2, "whiff_percent": 43.6, "whiffs": 24, "woba": 0.431, "xba": 0.216, "xobp": 0.276, "xslg": 0.428, "xwoba": 0.303 }, { "at_bats": 23, "avg_exit_velocity_mph": 95.2, "avg_launch_angle_deg": 25.5, "avg_spin_rate_rpm": 2570, "avg_velocity_mph": 82.9, "ba": 0.174, "babip": 0.176, "barrel_percent_bbe": 11.11111111111111, "barrels": 2, "bb_percent": 14.8, "doubles": 2, "fouls": 9, "hard_hit_percent": 50, "hit_by_pitch": 0, "hits": 4, "home_runs": 1, "iso": 0.217, "k_percent": 18.5, "obp": 0.296, "pitch_name": "Sweeper", "pitch_percent": 8.2, "pitch_type": "ST", "pitches": 100, "plate_appearances": 27, "run_value": 1.559, "run_value_per_100": 1.559, "singles": 1, "slg": 0.391, "strikeouts": 5, "swings": 37, "takes": 63, "triples": 0, "walks": 4, "whiff_percent": 27, "whiffs": 10, "woba": 0.306, "xba": 0.253, "xobp": 0.363, "xslg": 0.548, "xwoba": 0.389 }, { "at_bats": 16, "avg_exit_velocity_mph": 98.9, "avg_launch_angle_deg": 33.1, "avg_spin_rate_rpm": 2566, "avg_velocity_mph": 80.1, "ba": 0.25, "babip": 0.4, "barrel_percent_bbe": 42.857142857142854, "barrels": 3, "bb_percent": 11.1, "doubles": 0, "fouls": 10, "hard_hit_percent": 71.42857142857143, "hit_by_pitch": 0, "hits": 4, "home_runs": 2, "iso": 0.375, "k_percent": 50, "obp": 0.333, "pitch_name": "Curveball", "pitch_percent": 6, "pitch_type": "CU", "pitches": 73, "plate_appearances": 18, "run_value": 2.624, "run_value_per_100": 3.594520548, "singles": 2, "slg": 0.625, "strikeouts": 9, "swings": 32, "takes": 41, "triples": 0, "walks": 2, "whiff_percent": 46.9, "whiffs": 15, "woba": 0.404, "xba": 0.248, "xobp": 0.332, "xslg": 0.604, "xwoba": 0.393 }, { "at_bats": 12, "avg_exit_velocity_mph": 96.7, "avg_launch_angle_deg": 21.7, "avg_spin_rate_rpm": 1403, "avg_velocity_mph": 86.1, "ba": 0.333, "babip": 0.5, "barrel_percent_bbe": 50, "barrels": 3, "bb_percent": 0, "doubles": 0, "fouls": 4, "hard_hit_percent": 50, "hit_by_pitch": 0, "hits": 4, "home_runs": 2, "iso": 0.5, "k_percent": 50, "obp": 0.333, "pitch_name": "Split-Finger", "pitch_percent": 3.5, "pitch_type": "FS", "pitches": 43, "plate_appearances": 12, "run_value": 1.706, "run_value_per_100": 3.96744186, "singles": 2, "slg": 0.833, "strikeouts": 6, "swings": 25, "takes": 18, "triples": 0, "walks": 0, "whiff_percent": 60, "whiffs": 15, "woba": 0.49, "xba": 0.316, "xobp": 0.316, "xslg": 0.881, "xwoba": 0.493 }, { "at_bats": 3, "avg_exit_velocity_mph": 109.8, "avg_launch_angle_deg": 25.7, "avg_spin_rate_rpm": 2559, "avg_velocity_mph": 84.6, "ba": 0.667, "babip": 0, "barrel_percent_bbe": 100, "barrels": 3, "bb_percent": 0, "doubles": 0, "fouls": 1, "hard_hit_percent": 100, "hit_by_pitch": 0, "hits": 2, "home_runs": 2, "iso": 2, "k_percent": 0, "obp": 0.667, "pitch_name": "Knuckle Curve", "pitch_percent": 0.5, "pitch_type": "KC", "pitches": 6, "plate_appearances": 3, "run_value": 1.925, "run_value_per_100": 32.083333333, "singles": 0, "slg": 2.667, "strikeouts": 0, "swings": 4, "takes": 2, "triples": 0, "walks": 0, "whiff_percent": 0, "whiffs": 0, "woba": 1.366, "xba": 0.91, "xobp": 0.91, "xslg": 3.27, "xwoba": 1.715 }, { "at_bats": 1, "avg_exit_velocity_mph": null, "avg_launch_angle_deg": null, "avg_spin_rate_rpm": 2245, "avg_velocity_mph": 83, "ba": 0, "babip": null, "barrel_percent_bbe": null, "barrels": null, "bb_percent": 0, "doubles": 0, "fouls": 1, "hard_hit_percent": null, "hit_by_pitch": 0, "hits": 0, "home_runs": 0, "iso": 0, "k_percent": 100, "obp": 0, "pitch_name": "Slurve", "pitch_percent": 0.4, "pitch_type": "SV", "pitches": 5, "plate_appearances": 1, "run_value": -0.188, "run_value_per_100": -3.76, "singles": 0, "slg": 0, "strikeouts": 1, "swings": 2, "takes": 3, "triples": 0, "walks": 0, "whiff_percent": 50, "whiffs": 1, "woba": 0, "xba": null, "xobp": null, "xslg": null, "xwoba": 0 } ], "player_id": 592450, "player_name": "Judge, Aaron", "player_type": "batter", "season": 2026, "source_url": "https://baseballsavant.mlb.com/player/pitch_types?warehouse=true&hfPT=&hfGT=R%7C&hfSea=2026%7C&player_type=batter&batters_lookup%5B%5D=592450&hfTeam=&game_date_gt=&game_date_lt=&group_by=name-event&min_pitches=0&min_results=0&min_pas=0&player_event_sort=api_p_release_speed&sort_order=desc&player_id=592450&minors=false&wbc=false", "start_date": null, "total_pitches": 1217 } ``` ### Get player - Capability: `baseball-statcast/get_player` - Description: One player's biographical record by MLBAM id from the MLB Stats API that Baseball Savant is built on (`statsapi.mlb.com/api/v1/people/{id}?hydrate=currentTeam`): names, number, birth date and place, height/weight, bats/throws, position, current team, debut and draft year, plus the Savant player-page URL. - Instructions: After `search_players`, to confirm identity and get bio fields before pulling Statcast data for the id. - Cost: 5 credits per call - Capability file: [Get player](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_player) Accepted options: - `player_id` (number, required): MLBAM player id (the `player_id` returned by `search_players`, also used by MLB.com and statsapi.mlb.com). Example: `10` Response schema example: ```json { "active": true, "age": 34, "bat_side": "R", "birth_city": "Linden", "birth_country": "USA", "birth_date": "1992-04-26", "birth_state_province": "CA", "current_team": { "name": "New York Yankees", "team_id": 147 }, "draft_year": 2013, "first_name": "Aaron", "full_name": "Aaron Judge", "height": "6' 7\"", "last_name": "Judge", "mlb_debut_date": "2016-08-13", "name_slug": "aaron-judge-592450", "observed_at_ms": 1791156847515, "pitch_hand": "R", "player_id": 592450, "primary_number": "99", "primary_position": { "abbreviation": "RF", "code": "9", "name": "Outfielder" }, "source_url": "https://baseballsavant.mlb.com/savant-player/aaron-judge-592450", "stats_api_url": "https://statsapi.mlb.com/api/v1/people/592450?hydrate=currentTeam", "weight_lb": 282 } ``` ### Get player gamelogs - Capability: `baseball-statcast/get_player_gamelogs` - Description: Every plate appearance of one player in one season from Baseball Savant's game logs (`/player-services/gamelogs`): date, game, result, final pitch, and Statcast batted-ball metrics (exit velocity, launch angle, distance, barrel, xBA) with the play id. Newest first; paged with `limit`/`cursor`. An id that exists but has no data for the season returns an empty list; an unknown id is `not_found`. - Instructions: Per-plate-appearance detail for a known `player_id` and season; take `play_id` or `game_pk` into further lookups. - Cost: 5 credits per call - Capability file: [Get player gamelogs](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_player_gamelogs) Accepted options: - `cursor` (string): Continuation cursor from a previous response's `next_cursor`; send it with the same other inputs to get the next page. Example: `next_cursor` - `limit` (number): Maximum rows per page (default 100, max 500). Example: `100` - `player_id` (number, required): MLBAM player id (the `player_id` returned by `search_players`, also used by MLB.com and statsapi.mlb.com). Example: `10` - `season` (number, required): Season year. Statcast pitch tracking starts in 2015; the pitch-level search covers 2008 onward. Example: `2008` Response schema example: ```json { "count": 5, "next_cursor": "5", "observed_at_ms": 1791156852469, "plate_appearances": [ { "at_bat_number": 22, "ball_in_play": false, "barrel": null, "batting_team_id": 147, "event": "strikeout", "event_label": "Strikeout", "exit_velocity_mph": null, "fielding_team_id": 142, "game_date": "2026-09-16", "game_pk": 823655, "hard_hit": false, "hit_distance_ft": null, "launch_angle_deg": null, "opponent_pitcher": "Matthews, Zebby", "pitch_name": "4-Seam Fastball", "pitch_type": "FF", "pitch_velocity_mph": 96.6, "play_id": "c3d764a7-9199-3756-987a-c4d7b0bf6d8a", "pull_direction": null, "video_url": "https://baseballsavant.mlb.com/sporty-videos?playId=c3d764a7-9199-3756-987a-c4d7b0bf6d8a", "xba": null }, { "at_bat_number": 3, "ball_in_play": false, "barrel": null, "batting_team_id": 147, "event": "strikeout", "event_label": "Strikeout", "exit_velocity_mph": null, "fielding_team_id": 142, "game_date": "2026-09-16", "game_pk": 823655, "hard_hit": false, "hit_distance_ft": null, "launch_angle_deg": null, "opponent_pitcher": "Matthews, Zebby", "pitch_name": "Slider", "pitch_type": "SL", "pitch_velocity_mph": 88.2, "play_id": "a9fb81ca-254c-3ed8-96e6-e832a596fb42", "pull_direction": null, "video_url": "https://baseballsavant.mlb.com/sporty-videos?playId=a9fb81ca-254c-3ed8-96e6-e832a596fb42", "xba": null }, { "at_bat_number": 59, "ball_in_play": true, "barrel": true, "batting_team_id": 147, "event": "home_run", "event_label": "Home Run", "exit_velocity_mph": 104.2, "fielding_team_id": 142, "game_date": "2026-09-14", "game_pk": 823656, "hard_hit": true, "hit_distance_ft": 415, "launch_angle_deg": 36, "opponent_pitcher": "Minter, A.J.", "pitch_name": "Cutter", "pitch_type": "FC", "pitch_velocity_mph": 88.6, "play_id": "e38adf60-925c-3f22-a931-17c9e76b5f6a", "pull_direction": "Pull", "video_url": "https://baseballsavant.mlb.com/sporty-videos?playId=e38adf60-925c-3f22-a931-17c9e76b5f6a", "xba": 0.586 }, { "at_bat_number": 46, "ball_in_play": false, "barrel": null, "batting_team_id": 147, "event": "strikeout", "event_label": "Strikeout", "exit_velocity_mph": null, "fielding_team_id": 142, "game_date": "2026-09-14", "game_pk": 823656, "hard_hit": false, "hit_distance_ft": null, "launch_angle_deg": null, "opponent_pitcher": "Hoffman, Jeff", "pitch_name": "Slider", "pitch_type": "SL", "pitch_velocity_mph": 86.6, "play_id": "69547a9e-7be5-3476-96c0-24fefeadb505", "pull_direction": null, "video_url": "https://baseballsavant.mlb.com/sporty-videos?playId=69547a9e-7be5-3476-96c0-24fefeadb505", "xba": null }, { "at_bat_number": 24, "ball_in_play": false, "barrel": null, "batting_team_id": 147, "event": "strikeout", "event_label": "Strikeout", "exit_velocity_mph": null, "fielding_team_id": 142, "game_date": "2026-09-14", "game_pk": 823656, "hard_hit": false, "hit_distance_ft": null, "launch_angle_deg": null, "opponent_pitcher": "Kremer, Dean", "pitch_name": "Cutter", "pitch_type": "FC", "pitch_velocity_mph": 91.3, "play_id": "c8607f01-76b8-3bfb-8e91-5461b44be381", "pull_direction": null, "video_url": "https://baseballsavant.mlb.com/sporty-videos?playId=c8607f01-76b8-3bfb-8e91-5461b44be381", "xba": null } ], "player_id": 592450, "season": 2026, "source_url": "https://baseballsavant.mlb.com/player-services/gamelogs?playerId=592450&season=2026", "total": 285 } ``` ### Get schedule - Capability: `baseball-statcast/get_schedule` - Description: All MLB games on one date from Baseball Savant's schedule feed (`/schedule?date=`): game id, type, first-pitch time, status, teams with scores and records, probable pitchers, venue, linescore and Savant's latest win-probability point. A date with no games returns an empty list. - Instructions: Find `game_pk` values and scores for a day; a date in the off-season legitimately has zero games. - Cost: 5 credits per call - Capability file: [Get schedule](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/get_schedule) Accepted options: - `date` (string, required): Game date, YYYY-MM-DD (US Eastern game day). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` Response schema example: ```json { "date": "2026-05-08", "games": [ { "away": { "abbreviation": "HOU", "is_winner": true, "losses": 23, "name": "Houston Astros", "probable_pitcher": { "name": "Mike Burrows", "player_id": 681347 }, "score": 10, "team_id": 117, "wins": 16 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T18:10:00-04:00", "game_pk": 824522, "game_type": "R", "home": { "abbreviation": "CIN", "is_winner": false, "losses": 19, "name": "Cincinnati Reds", "probable_pitcher": { "name": "Nick Lodolo", "player_id": 666157 }, "score": 0, "team_id": 113, "wins": 20 }, "linescore": { "away_errors": 0, "away_hits": 13, "away_runs": 10, "current_inning": 9, "home_errors": 0, "home_hits": 5, "home_runs": 0, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=824522", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Great American Ball Park", "venue_id": 2602 }, "win_probability": { "at_bat_index": 72, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "COL", "is_winner": true, "losses": 23, "name": "Colorado Rockies", "probable_pitcher": { "name": "Chase Dollander", "player_id": 801403 }, "score": 9, "team_id": 115, "wins": 16 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T18:40:00-04:00", "game_pk": 823466, "game_type": "R", "home": { "abbreviation": "PHI", "is_winner": false, "losses": 22, "name": "Philadelphia Phillies", "probable_pitcher": { "name": "Jesús Luzardo", "player_id": 666200 }, "score": 7, "team_id": 143, "wins": 17 }, "linescore": { "away_errors": 0, "away_hits": 13, "away_runs": 9, "current_inning": 11, "home_errors": 0, "home_hits": 9, "home_runs": 7, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=823466", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Citizens Bank Park", "venue_id": 2681 }, "win_probability": { "at_bat_index": 96, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "ATH", "is_winner": true, "losses": 18, "name": "Athletics", "probable_pitcher": { "name": "Jacob Lopez", "player_id": 682052 }, "score": 4, "team_id": 133, "wins": 20 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:05:00-04:00", "game_pk": 824846, "game_type": "R", "home": { "abbreviation": "BAL", "is_winner": false, "losses": 22, "name": "Baltimore Orioles", "probable_pitcher": { "name": "Kyle Bradish", "player_id": 680694 }, "score": 3, "team_id": 110, "wins": 17 }, "linescore": { "away_errors": 0, "away_hits": 8, "away_runs": 4, "current_inning": 9, "home_errors": 0, "home_hits": 4, "home_runs": 3, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=824846", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Oriole Park at Camden Yards", "venue_id": 2 }, "win_probability": { "at_bat_index": 72, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "LAA", "is_winner": false, "losses": 24, "name": "Los Angeles Angels", "probable_pitcher": { "name": "Reid Detmers", "player_id": 672282 }, "score": 0, "team_id": 108, "wins": 15 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:07:00-04:00", "game_pk": 822822, "game_type": "R", "home": { "abbreviation": "TOR", "is_winner": true, "losses": 21, "name": "Toronto Blue Jays", "probable_pitcher": { "name": "Dylan Cease", "player_id": 656302 }, "score": 2, "team_id": 141, "wins": 17 }, "linescore": { "away_errors": 0, "away_hits": 6, "away_runs": 0, "current_inning": 9, "home_errors": 1, "home_hits": 3, "home_runs": 2, "inning_state": "Top" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=822822", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Rogers Centre", "venue_id": 14 }, "win_probability": { "at_bat_index": 65, "away_percent": 0, "home_percent": 100 } }, { "away": { "abbreviation": "TB", "is_winner": false, "losses": 13, "name": "Tampa Bay Rays", "probable_pitcher": { "name": "Jesse Scholtens", "player_id": 669947 }, "score": 0, "team_id": 139, "wins": 25 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:10:00-04:00", "game_pk": 824768, "game_type": "R", "home": { "abbreviation": "BOS", "is_winner": true, "losses": 22, "name": "Boston Red Sox", "probable_pitcher": { "name": "Connelly Early", "player_id": 813349 }, "score": 2, "team_id": 111, "wins": 17 }, "linescore": { "away_errors": 1, "away_hits": 4, "away_runs": 0, "current_inning": 9, "home_errors": 0, "home_hits": 5, "home_runs": 2, "inning_state": "Top" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=824768", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Fenway Park", "venue_id": 3 }, "win_probability": { "at_bat_index": 65, "away_percent": 0, "home_percent": 100 } }, { "away": { "abbreviation": "WSH", "is_winner": true, "losses": 20, "name": "Washington Nationals", "probable_pitcher": { "name": "Foster Griffin", "player_id": 656492 }, "score": 3, "team_id": 120, "wins": 19 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:10:00-04:00", "game_pk": 823871, "game_type": "R", "home": { "abbreviation": "MIA", "is_winner": false, "losses": 22, "name": "Miami Marlins", "probable_pitcher": { "name": "Robby Snelling", "player_id": 702281 }, "score": 2, "team_id": 146, "wins": 17 }, "linescore": { "away_errors": 2, "away_hits": 6, "away_runs": 3, "current_inning": 9, "home_errors": 0, "home_hits": 5, "home_runs": 2, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=823871", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "loanDepot park", "venue_id": 4169 }, "win_probability": { "at_bat_index": 71, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "MIN", "is_winner": false, "losses": 23, "name": "Minnesota Twins", "probable_pitcher": { "name": "Connor Prielipp", "player_id": 687570 }, "score": 4, "team_id": 142, "wins": 16 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:15:00-04:00", "game_pk": 824443, "game_type": "R", "home": { "abbreviation": "CLE", "is_winner": true, "losses": 19, "name": "Cleveland Guardians", "probable_pitcher": { "name": "Parker Messick", "player_id": 800048 }, "score": 6, "team_id": 114, "wins": 21 }, "linescore": { "away_errors": 1, "away_hits": 13, "away_runs": 4, "current_inning": 9, "home_errors": 0, "home_hits": 8, "home_runs": 6, "inning_state": "Top" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=824443", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Progressive Field", "venue_id": 5 }, "win_probability": { "at_bat_index": 77, "away_percent": 0, "home_percent": 100 } }, { "away": { "abbreviation": "DET", "is_winner": false, "losses": 21, "name": "Detroit Tigers", "probable_pitcher": { "name": "Keider Montero", "player_id": 672456 }, "score": 3, "team_id": 116, "wins": 18 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:40:00-04:00", "game_pk": 824116, "game_type": "R", "home": { "abbreviation": "KC", "is_winner": true, "losses": 21, "name": "Kansas City Royals", "probable_pitcher": { "name": "Kris Bubic", "player_id": 663460 }, "score": 4, "team_id": 118, "wins": 18 }, "linescore": { "away_errors": 1, "away_hits": 8, "away_runs": 3, "current_inning": 9, "home_errors": 0, "home_hits": 8, "home_runs": 4, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=824116", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Kauffman Stadium", "venue_id": 7 }, "win_probability": { "at_bat_index": 74, "away_percent": 0, "home_percent": 100 } }, { "away": { "abbreviation": "SEA", "is_winner": true, "losses": 20, "name": "Seattle Mariners", "probable_pitcher": { "name": "Emerson Hancock", "player_id": 676106 }, "score": 12, "team_id": 136, "wins": 19 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:40:00-04:00", "game_pk": 824607, "game_type": "R", "home": { "abbreviation": "CWS", "is_winner": false, "losses": 21, "name": "Chicago White Sox", "probable_pitcher": { "name": "Sean Burke", "player_id": 680732 }, "score": 8, "team_id": 145, "wins": 17 }, "linescore": { "away_errors": 0, "away_hits": 12, "away_runs": 12, "current_inning": 9, "home_errors": 1, "home_hits": 10, "home_runs": 8, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=824607", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Rate Field", "venue_id": 4 }, "win_probability": { "at_bat_index": 83, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "NYY", "is_winner": false, "losses": 13, "name": "New York Yankees", "probable_pitcher": { "name": "Max Fried", "player_id": 608331 }, "score": 0, "team_id": 147, "wins": 26 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T19:40:00-04:00", "game_pk": 823794, "game_type": "R", "home": { "abbreviation": "MIL", "is_winner": true, "losses": 16, "name": "Milwaukee Brewers", "probable_pitcher": { "name": "Jacob Misiorowski", "player_id": 694819 }, "score": 6, "team_id": 158, "wins": 20 }, "linescore": { "away_errors": 0, "away_hits": 3, "away_runs": 0, "current_inning": 9, "home_errors": 0, "home_hits": 8, "home_runs": 6, "inning_state": "Top" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=823794", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "American Family Field", "venue_id": 32 }, "win_probability": { "at_bat_index": 65, "away_percent": 0, "home_percent": 100 } }, { "away": { "abbreviation": "CHC", "is_winner": true, "losses": 12, "name": "Chicago Cubs", "probable_pitcher": { "name": "Ben Brown", "player_id": 676962 }, "score": 7, "team_id": 112, "wins": 27 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T20:05:00-04:00", "game_pk": 822904, "game_type": "R", "home": { "abbreviation": "TEX", "is_winner": false, "losses": 21, "name": "Texas Rangers", "probable_pitcher": { "name": "Kumar Rocker", "player_id": 677958 }, "score": 1, "team_id": 140, "wins": 17 }, "linescore": { "away_errors": 0, "away_hits": 9, "away_runs": 7, "current_inning": 9, "home_errors": 1, "home_hits": 2, "home_runs": 1, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=822904", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Globe Life Field", "venue_id": 5325 }, "win_probability": { "at_bat_index": 74, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "NYM", "is_winner": true, "losses": 23, "name": "New York Mets", "probable_pitcher": { "name": "Nolan McLean", "player_id": 690997 }, "score": 3, "team_id": 121, "wins": 15 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T21:40:00-04:00", "game_pk": 825088, "game_type": "R", "home": { "abbreviation": "AZ", "is_winner": false, "losses": 20, "name": "Arizona Diamondbacks", "probable_pitcher": { "name": "Ryne Nelson", "player_id": 669194 }, "score": 1, "team_id": 109, "wins": 17 }, "linescore": { "away_errors": 0, "away_hits": 5, "away_runs": 3, "current_inning": 10, "home_errors": 0, "home_hits": 5, "home_runs": 1, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=825088", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Chase Field", "venue_id": 15 }, "win_probability": { "at_bat_index": 73, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "STL", "is_winner": true, "losses": 15, "name": "St. Louis Cardinals", "probable_pitcher": { "name": "Michael McGreevy", "player_id": 700241 }, "score": 6, "team_id": 138, "wins": 23 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T21:45:00-04:00", "game_pk": 823303, "game_type": "R", "home": { "abbreviation": "SD", "is_winner": false, "losses": 16, "name": "San Diego Padres", "probable_pitcher": { "name": "Griffin Canning", "player_id": 656288 }, "score": 0, "team_id": 135, "wins": 22 }, "linescore": { "away_errors": 0, "away_hits": 11, "away_runs": 6, "current_inning": 9, "home_errors": 2, "home_hits": 1, "home_runs": 0, "inning_state": "Bottom" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=823303", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Petco Park", "venue_id": 2680 }, "win_probability": { "at_bat_index": 70, "away_percent": 100, "home_percent": 0 } }, { "away": { "abbreviation": "ATL", "is_winner": false, "losses": 13, "name": "Atlanta Braves", "probable_pitcher": { "name": "Chris Sale", "player_id": 519242 }, "score": 1, "team_id": 144, "wins": 26 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T22:10:00-04:00", "game_pk": 823957, "game_type": "R", "home": { "abbreviation": "LAD", "is_winner": true, "losses": 14, "name": "Los Angeles Dodgers", "probable_pitcher": { "name": "Emmet Sheehan", "player_id": 686218 }, "score": 3, "team_id": 119, "wins": 24 }, "linescore": { "away_errors": 1, "away_hits": 9, "away_runs": 1, "current_inning": 9, "home_errors": 0, "home_hits": 5, "home_runs": 3, "inning_state": "Top" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=823957", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "UNIQLO Field at Dodger Stadium", "venue_id": 22 }, "win_probability": { "at_bat_index": 67, "away_percent": 0, "home_percent": 100 } }, { "away": { "abbreviation": "PIT", "is_winner": false, "losses": 18, "name": "Pittsburgh Pirates", "probable_pitcher": { "name": "Carmen Mlodzinski", "player_id": 669387 }, "score": 2, "team_id": 134, "wins": 21 }, "day_night": "night", "double_header": "N", "game_datetime": "2026-05-08T22:15:00-04:00", "game_pk": 823225, "game_type": "R", "home": { "abbreviation": "SF", "is_winner": true, "losses": 23, "name": "San Francisco Giants", "probable_pitcher": { "name": "Robbie Ray", "player_id": 592662 }, "score": 5, "team_id": 137, "wins": 15 }, "linescore": { "away_errors": 0, "away_hits": 5, "away_runs": 2, "current_inning": 9, "home_errors": 0, "home_hits": 12, "home_runs": 5, "inning_state": "Top" }, "official_date": "2026-05-08", "scheduled_innings": 9, "season": 2026, "series_description": "Regular Season", "source_url": "https://baseballsavant.mlb.com/gamefeed?gamePk=823225", "status": { "abstract_state": "Final", "code": "F", "detailed_state": "Final" }, "venue": { "name": "Oracle Park", "venue_id": 2395 }, "win_probability": { "at_bat_index": 70, "away_percent": 0, "home_percent": 100 } } ], "observed_at_ms": 1791156872594, "source_url": "https://baseballsavant.mlb.com/schedule?date=2026-05-08", "total_games": 15 } ``` ### Search players - Capability: `baseball-statcast/search_players` - Description: Player name autocomplete from Baseball Savant (`/player/search-all`). Returns MLBAM player ids with name, position, club and league. An unknown name returns an empty list (not an error). - Instructions: Resolve a player's name to the MLBAM `player_id` needed by `get_player`, `get_player_gamelogs`, `get_pitch_type_summary` and `search_statcast`. - Cost: 5 credits per call - Capability file: [Search players](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/search_players) Accepted options: - `query` (string, required): Full or partial player name, e.g. `Aaron Judge` or `ohtani`. Example: `Aaron Judge` Response schema example: ```json { "count": 1, "observed_at_ms": 1791156837593, "query": "Aaron Judge", "results": [ { "is_mlb": true, "is_prospect": false, "last_season": 2026, "league": "MLB", "name": "Aaron Judge", "player_id": 592450, "position": "RF", "source_url": "https://baseballsavant.mlb.com/savant-player/592450", "team": "Yankees" } ], "source_url": "https://baseballsavant.mlb.com/player/search-all?search=Aaron+Judge" } ``` ### Search statcast - Capability: `baseball-statcast/search_statcast` - Description: Pitch-by-pitch Statcast search (`/statcast_search/csv`, the site's CSV export) for one batter or pitcher, or one team, over a date window of at most 31 days in one season: pitch type, velocity, spin, movement, location, count, result, and batted-ball metrics (exit velocity, launch angle, distance, xBA/xwOBA, bat speed). Rows are returned as the site orders them and paged with `limit`/`cursor`. The export has no play UUID; use `get_player_gamelogs` for `play_id`. - Instructions: Statcast pitch-level data for a known `player_id` (or team abbreviation) in a date window; narrow the window or add `pitch_types` to keep results small. - Cost: 5 credits per call - Capability file: [Search statcast](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/search_statcast) Accepted options: - `cursor` (string): Continuation cursor from a previous response's `next_cursor`; send it with the same other inputs to get the next page. Example: `next_cursor` - `end_date` (string, required): Last game date, YYYY-MM-DD; same season as `start_date`, at most 31 days later. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `start_date` - `game_type` (string): `R` regular season (default), `F` wild card, `D` division series, `L` league championship, `W` World Series, `S` spring training. Example: `R` - `limit` (number): Maximum rows per page (default 200, max 1000). Example: `200` - `pitch_types` (string[]): Statcast pitch codes to keep (FF, SI, FC, SL, ST, SV, CU, KC, CH, FS, KN, ...). Example: `[]` - `player_id` (number): MLBAM player id (the `player_id` returned by `search_players`, also used by MLB.com and statsapi.mlb.com). Example: `10` - `player_type` (string): `batter` searches by the batter, `pitcher` by the pitcher (default `batter`). Example: `batter` - `start_date` (string, required): First game date, YYYY-MM-DD. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `team` (string): Team abbreviation as Savant uses it (e.g. `NYY`); filters the batting or fielding team per `player_type`. Pattern: ^[A-Z]{2,3}$. Example: `` Response schema example: ```json { "count": 5, "next_cursor": "5", "observed_at_ms": 1791156857514, "pitches": [ { "arm_angle_deg": 29.6, "at_bat_number": 3, "away_score": 0, "away_team": "NYY", "balls": 1, "bat_speed_mph": 78.3, "batter_id": 592450, "bb_type": "line_drive", "delta_home_win_exp": 0.007, "delta_run_exp": -0.184, "description": "hit_into_play", "estimated_ba": 0.331, "estimated_slg": 0.619, "estimated_woba": 0.401, "events": "field_out", "game_date": "2026-05-08", "game_pk": 823794, "game_year": 2026, "hit_distance_ft": 309, "home_score": 0, "home_team": "MIL", "inning": 1, "inning_half": "Top", "launch_angle_deg": 20, "launch_speed_mph": 99.2, "outs_when_up": 2, "p_throws": "R", "pfx_x_ft": -1.07, "pfx_z_ft": 1.34, "pitch_name": "4-Seam Fastball", "pitch_number": 4, "pitch_type": "FF", "pitcher_id": 694819, "plate_x_ft": -0.35794275582673185, "plate_z_ft": 2.093973646259121, "play_description": "Aaron Judge lines out to right fielder Sal Frelick.", "player_name": "Judge, Aaron", "release_extension_ft": 7.4, "release_speed_mph": 103.6, "release_spin_rate_rpm": 2703, "result_type": "X", "stand": "R", "strikes": 2, "sv_id": null, "swing_length_ft": 8.1, "woba_value": 0, "zone": 7 }, { "arm_angle_deg": 28.7, "at_bat_number": 3, "away_score": 0, "away_team": "NYY", "balls": 0, "bat_speed_mph": 77.6, "batter_id": 592450, "bb_type": null, "delta_home_win_exp": 0.002, "delta_run_exp": -0.062, "description": "foul", "estimated_ba": null, "estimated_slg": null, "estimated_woba": null, "events": null, "game_date": "2026-05-08", "game_pk": 823794, "game_year": 2026, "hit_distance_ft": 220, "home_score": 0, "home_team": "MIL", "inning": 1, "inning_half": "Top", "launch_angle_deg": 43, "launch_speed_mph": 74.3, "outs_when_up": 2, "p_throws": "R", "pfx_x_ft": -1.05, "pfx_z_ft": 1.23, "pitch_name": "4-Seam Fastball", "pitch_number": 2, "pitch_type": "FF", "pitcher_id": 694819, "plate_x_ft": -0.30442126217486654, "plate_z_ft": 2.6396527197019664, "play_description": null, "player_name": "Judge, Aaron", "release_extension_ft": 7.6, "release_speed_mph": 103.5, "release_spin_rate_rpm": 2640, "result_type": "S", "stand": "R", "strikes": 1, "sv_id": null, "swing_length_ft": 7.7, "woba_value": null, "zone": 4 }, { "arm_angle_deg": 29.5, "at_bat_number": 3, "away_score": 0, "away_team": "NYY", "balls": 0, "bat_speed_mph": null, "batter_id": 592450, "bb_type": null, "delta_home_win_exp": 0.002, "delta_run_exp": -0.046, "description": "called_strike", "estimated_ba": null, "estimated_slg": null, "estimated_woba": null, "events": null, "game_date": "2026-05-08", "game_pk": 823794, "game_year": 2026, "hit_distance_ft": null, "home_score": 0, "home_team": "MIL", "inning": 1, "inning_half": "Top", "launch_angle_deg": null, "launch_speed_mph": null, "outs_when_up": 2, "p_throws": "R", "pfx_x_ft": -0.97, "pfx_z_ft": 1.21, "pitch_name": "4-Seam Fastball", "pitch_number": 1, "pitch_type": "FF", "pitcher_id": 694819, "plate_x_ft": -0.655273179372026, "plate_z_ft": 2.1942968523895026, "play_description": null, "player_name": "Judge, Aaron", "release_extension_ft": 7.6, "release_speed_mph": 103.3, "release_spin_rate_rpm": 2667, "result_type": "S", "stand": "R", "strikes": 0, "sv_id": null, "swing_length_ft": null, "woba_value": null, "zone": 7 }, { "arm_angle_deg": 31.2, "at_bat_number": 3, "away_score": 0, "away_team": "NYY", "balls": 0, "bat_speed_mph": null, "batter_id": 592450, "bb_type": null, "delta_home_win_exp": -0.001, "delta_run_exp": 0.029, "description": "ball", "estimated_ba": null, "estimated_slg": null, "estimated_woba": null, "events": null, "game_date": "2026-05-08", "game_pk": 823794, "game_year": 2026, "hit_distance_ft": null, "home_score": 0, "home_team": "MIL", "inning": 1, "inning_half": "Top", "launch_angle_deg": null, "launch_speed_mph": null, "outs_when_up": 2, "p_throws": "R", "pfx_x_ft": -0.88, "pfx_z_ft": 1.45, "pitch_name": "4-Seam Fastball", "pitch_number": 3, "pitch_type": "FF", "pitcher_id": 694819, "plate_x_ft": 0.7647939847092927, "plate_z_ft": 1.5864706073251795, "play_description": null, "player_name": "Judge, Aaron", "release_extension_ft": 7.8, "release_speed_mph": 103.1, "release_spin_rate_rpm": 2754, "result_type": "B", "stand": "R", "strikes": 2, "sv_id": null, "swing_length_ft": null, "woba_value": null, "zone": 14 }, { "arm_angle_deg": 31.2, "at_bat_number": 44, "away_score": 0, "away_team": "NYY", "balls": 1, "bat_speed_mph": 70.5, "batter_id": 592450, "bb_type": null, "delta_home_win_exp": 0.01, "delta_run_exp": -0.179, "description": "swinging_strike", "estimated_ba": null, "estimated_slg": null, "estimated_woba": 0, "events": "strikeout", "game_date": "2026-05-08", "game_pk": 823794, "game_year": 2026, "hit_distance_ft": null, "home_score": 5, "home_team": "MIL", "inning": 6, "inning_half": "Top", "launch_angle_deg": null, "launch_speed_mph": null, "outs_when_up": 1, "p_throws": "R", "pfx_x_ft": -0.99, "pfx_z_ft": 1.25, "pitch_name": "4-Seam Fastball", "pitch_number": 4, "pitch_type": "FF", "pitcher_id": 694819, "plate_x_ft": 0.8239812581726247, "plate_z_ft": 2.649560513634593, "play_description": "Aaron Judge strikes out swinging.", "player_name": "Judge, Aaron", "release_extension_ft": 7.7, "release_speed_mph": 102.4, "release_spin_rate_rpm": 2736, "result_type": "S", "stand": "R", "strikes": 2, "sv_id": null, "swing_length_ft": 6.7, "woba_value": 0, "zone": 6 } ], "query": { "end_date": "2026-05-08", "game_type": "R", "pitch_types": [], "player_id": 592450, "player_type": "batter", "season": 2026, "start_date": "2026-05-08", "team": null }, "source_url": "https://baseballsavant.mlb.com/statcast_search/csv?hfPT=&hfGT=R%7C&hfSea=2026%7C&player_type=batter&batters_lookup%5B%5D=592450&hfTeam=&game_date_gt=2026-05-08&game_date_lt=2026-05-08&group_by=name-event&min_pitches=0&min_results=0&min_pas=0&player_event_sort=api_p_release_speed&sort_order=desc&type=details&all=true&minors=false&wbc=false", "total": 13 } ``` ### Trending players - Capability: `baseball-statcast/trending_players` - Description: The players Baseball Savant currently lists as trending (`/savant/api/v1/trending-players`): a short list of MLBAM ids with name, position, club and a page-view trend label. - Instructions: Discover who is being looked up on Baseball Savant right now; feed `player_id` into the detail functions. - Cost: 5 credits per call - Capability file: [Trending players](https://firecrawl.dev/alexandria/agents/providers/baseballsavant-mlb-com/baseball-statcast/trending_players) Accepted options: Response schema example: ```json { "count": 6, "observed_at_ms": 1791156842546, "players": [ { "league": "MLB", "name": "Shohei Ohtani", "player_id": 660271, "position": null, "source_url": "https://baseballsavant.mlb.com/savant-player/660271", "team": "Dodgers", "team_abbreviation": "LAD", "trend": "↓ 2%" }, { "league": "MLB", "name": "Ty France", "player_id": 664034, "position": "1B", "source_url": "https://baseballsavant.mlb.com/savant-player/664034", "team": "Padres", "team_abbreviation": "SD", "trend": "↑ 242%" }, { "league": "MLB", "name": "Jacob Misiorowski", "player_id": 694819, "position": "RHP", "source_url": "https://baseballsavant.mlb.com/savant-player/694819", "team": "Brewers", "team_abbreviation": "MIL", "trend": "↑ 3%" }, { "league": "MLB", "name": "Munetaka Murakami", "player_id": 808959, "position": "1B", "source_url": "https://baseballsavant.mlb.com/savant-player/808959", "team": "White Sox", "team_abbreviation": "CWS", "trend": null }, { "league": "MLB", "name": "Jackson Chourio", "player_id": 694192, "position": "LF", "source_url": "https://baseballsavant.mlb.com/savant-player/694192", "team": "Brewers", "team_abbreviation": "MIL", "trend": "↑ 24%" }, { "league": "MLB", "name": "Drew Rasmussen", "player_id": 656876, "position": "RHP", "source_url": "https://baseballsavant.mlb.com/savant-player/656876", "team": "Rays", "team_abbreviation": "TB", "trend": "↑ 21%" } ], "source_url": "https://baseballsavant.mlb.com/savant/api/v1/trending-players" } ```