Stats

View stats from search

get/api/v1/stats/search

Request

Base URL: https://statsapi.mlb.com
URL: https://statsapi.mlb.com/api/v1/stats/search
Auth: none declared

Query parameters

groupStatGroup[] required

Category of statistic to return. Available types in /api/v1/statGroups

gamePksinteger[]

Comma delimited list of unique primary keys

playIdsstring[]

Comma delimited list of unique play identifiers

seasonsstring[]

Comma delimited list of Seasons of play

gameTypesGameTypeEnum[]

Type of Game. Available types in /api/v1/gameTypes

datestring date

Date of Game. Format: YYYY-MM-DD

startDatestring date

Date of Game. Format: YYYY-MM-DD

endDatestring date

Date of Game. Format: YYYY-MM-DD

teamIdsinteger[]

Unique Team Identifier. Format: 141, 147, etc

pitcherTeamIdsinteger[]

Unique Team Identifier. Format: 141, 147, etc

batterTeamIdsinteger[]

Unique Team Identifier. Format: 141, 147, etc

sportIdsinteger[]

Comma delimited list of top level organizations of a sport

pitcherSportIdsinteger[]

Comma delimited list of top level organizations of a sport

batterSportIdsinteger[]

Comma delimited list of top level organizations of a sport

leagueIdsinteger[]

Comma delimited list of Unique league identifiers

pitcherLeagueIdsinteger[]

Comma delimited list of Unique league identifiers

batterLeagueIdsinteger[]

Comma delimited list of Unique league identifiers

divisionIdsinteger[]

Comma delimited list of Unique League Identifiers

pitcherDivisionIdsinteger[]

Comma delimited list of Unique League Identifiers

batterDivisionIdsinteger[]

Comma delimited list of Unique League Identifiers

pitchersOnTeamIdsinteger[]

Unique Team Identifier. Format: 141, 147, etc

battersOnTeamIdsinteger[]

Unique Team Identifier. Format: 141, 147, etc

playerIdsinteger[]

A unique identifier for a player

playerPool'ALL' | 'QUALIFIED' | 'ROOKIES' | 'QUALIFIED_ROOKIES' | 'ORGANIZATION' | 'ORGANIZATION_NO_MLB' | 'CURRENT' | 'ALL_CURRENT' | 'QUALIFIED_CURRENT'

Return "ALL" or only "QUALIFIED" players based on plate appearances.

pitcherIdsinteger[]

A unique identifier for a player

batterIdsinteger[]

A unique identifier for a player

catcherIdsinteger[]

A unique identifier for a player

firstBasemanIdsinteger[]

A unique identifier for a player

secondBasemanIdsinteger[]

A unique identifier for a player

thirdBasemanIdsinteger[]

A unique identifier for a player

shortstopIdsinteger[]

A unique identifier for a player

leftFielderIdsinteger[]

A unique identifier for a player

centerFielderIdsinteger[]

A unique identifier for a player

rightFielderIdsinteger[]

A unique identifier for a player

runnerFirstIdsinteger[]

A unique identifier for a player

runnerSecondIdsinteger[]

A unique identifier for a player

runnerThirdIdsinteger[]

A unique identifier for a player

venueIdsinteger[]

Unique Venue Identifier

pitchHandstring

Handedness of pitcher

batSidestring

Bat side of hitter

pitchTypesPitchType[]

Classification of pitch (fastball, curveball, etc...)

pitchCodesPitchCode[]

Result of the pitch (ball, called strike, etc...)

eventTypesEventType[]

Type of event

positionsBaseballPosition[]

All of the details of a player's position

primaryPositionsBaseballPosition[]

All of the details of a player's position

minPitchSpeednumber double

Minimum value to filter on

maxPitchSpeednumber double

Maximum value to filter on

minSpinRatenumber double

Minimum value to filter on

maxSpinRatenumber double

Maximum value to filter on

minExtensionnumber double

Minimum value to filter on

maxExtensionnumber double

Maximum value to filter on

minExitVelocityAgainstnumber double

Minimum value to filter on

maxExitVelocityAgainstnumber double

Maximum value to filter on

minLaunchAngleAgainstnumber double

Minimum value to filter on

maxLaunchAngleAgainstnumber double

Maximum value to filter on

minExitVelocitynumber double

Minimum value to filter on

maxExitVelocitynumber double

Maximum value to filter on

minLaunchAnglenumber double

Minimum value to filter on

maxLaunchAnglenumber double

Maximum value to filter on

minHomeRunDistancenumber double

Minimum value to filter on

maxHomeRunDistancenumber double

Maximum value to filter on

minHitDistancenumber double

Minimum value to filter on

maxHitDistancenumber double

Maximum value to filter on

minHangTimenumber double

Minimum value to filter on

maxHangTimenumber double

Maximum value to filter on

minHitProbabilitynumber double

Minimum value to filter on

maxHitProbabilitynumber double

Maximum value to filter on

minCatchProbabilitynumber double

Minimum value to filter on

maxCatchProbabilitynumber double

Maximum value to filter on

isBarrelboolean

Whether or not a play resulted in a barreled ball

hitTrajectoriesHitTrajectory[]

Trajectory of hit (line drive, fly ball, etc...)

limitinteger

Number of results to return

offsetinteger

The pointer to start for a return set; used for pagination

groupByGroupByEnum[]

Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP

compareOverGroupByEnum[]

Group stats by PLAYER, TEAM, SEASON, VENUE, SPORT or STAT_GROUP

sortStat'AIROUTS' | 'ASSISTS' | 'AT_BATS' | 'AT_BATS_PER_HOMERUN' | 'BALK' | 'BATTING_AVERAGE' | 'BATTING_AVERAGE_BALLS_IN_PLAY' | 'QUALITY_STARTS' | 'BEQUEATHED_RUNNERS' | 'BEQUEATHED_RUNNERS_SCORED' | 'BLOWN_SAVES' | 'CATCHER_ERA' | 'CATCHERS_INTERFERENCE' | 'CAUGHT_STEALING' | 'CHANCES' | 'COMPLETE_GAME' | 'DOUBLE_PLAYS' | 'DOUBLES' | 'EARNED_RUN' | 'EARNED_RUN_AVERAGE' | 'ERRORS' | 'EXIT_VELOCITY' | 'EXTRA_BASE_HITS' | 'FIELDING_PERCENTAGE' | 'FLYOUTS' | 'GAMES_FINISHED' | 'GAMES_PLAYED' | 'GAMES_STARTED' | 'GROUND_INTO_DOUBLE_PLAYS' | 'GROUND_INTO_DOUBLE_PLAY_OPPORTUNITIES' | 'GROUND_INTO_TRIPLE_PLAYS' | 'GROUNDOUTS' | 'GROUNDOUT_TO_FLYOUT_RATIO' | 'HITS' | 'HITS_RISP' | 'HIT_BATSMAN' | 'HIT_BY_PITCHES' | 'HITS_PER_9_INN' | 'HOLDS' | 'HOME_RUNS' | 'HOME_RUNS_PER_PLATE_APPEARANCE' | 'INHERITED_RUNNER' | 'INHERITED_RUNNER_SCORED' | 'INNINGS' | 'OUTS_PITCHED' | 'INNINGS_PITCHED' | 'INTENTIONAL_WALKS' | 'ISO' | 'LEFT_ON_BASE' | 'LEFT_ON_BASE_RISP' | 'LOSSES' | 'NUMBER_OF_STRIKES' | 'NUMBER_OF_BALLS' | 'NUMBER_OF_PITCHES' | 'ON_BASE_PERCENTAGE' | 'ON_BASE_PLUS_SLUGGING' | 'OUTFIELD_ASSISTS' | 'UZR' | 'PASSED_BALLS' | 'PICKOFFS' | 'PITCHES_PER_INNING' | 'PITCHES_PER_PLATE_APPEARANCE' | 'PUT_OUTS' | 'RANGE_FACTOR_PER_GAME' | 'RANGE_FACTOR_PER_9_INN' | 'REACHED_ON_ERROR' | 'RUNS' | 'RUNS_BATTED_IN' | 'SACRIFICE_BUNTS' | 'SACRIFICE_FLIES' | 'SAVES' | 'SAVE_OPPORTUNITIES' | 'SHUTOUTS' | 'SLUGGING_PERCENTAGE' | 'STOLEN_BASES' | 'STOLEN_BASE_PERCENTAGE' | 'STRIKEOUTS' | 'STRIKEOUTS_PER_9_INN' | 'STRIKEOUTS_PER_PLATE_APPEARANCE' | 'STRIKEOUT_WALK_RATIO' | 'THROWING_ERRORS' | 'TOTAL_BASES' | 'TOTAL_BATTERS_FACED' | 'TOTAL_PLATE_APPEARANCES' | 'TRIPLE_PLAYS' | 'TRIPLES' | 'WALKS_PER_STRIKEOUT' | 'WALKS_PER_PLATE_APPEARANCE' | 'WALKS_HITS_PER_INNING_PITCHED' | 'WALKS' | 'WALKS_PER_9_INN' | 'WALKOFFS' | 'WILD_PITCH' | 'WINS' | 'WIN_PERCENTAGE' | 'ATTENDANCE' | 'DURATION' | 'WIN_STREAK' | 'LOSS_STREAK' | 'WOBA' | 'XWOBA' | 'XWOBACON' | 'XAVG' | 'XSLG' | 'LAUNCH_ANGLE' | 'HOME_RUN_DISTANCE' | 'HIT_DISTANCE' | 'HANG_TIME' | 'MAX_HEIGHT' | 'HIT_PROBABILITY' | 'CATCH_PROBABILITY' | 'BARRELS' | 'PITCH_SPEED' | 'SPIN_RATE' | 'EXTENSION' | 'HORIZONTAL_BREAK' | 'ARM_STRENGTH' | 'DISTANCE_COVERED' | 'EXCHANGE' | 'FIELDER_BURST_DISTANCE' | 'FIELDER_JUMP_DISTANCE' | 'FIELDER_REACTION_DISTANCE' | 'FIRST_STEP' | 'FIRST_STEP_EFFICIENCY' | 'POP_TIME_1B' | 'POP_TIME_2B' | 'POP_TIME_3B' | 'ROUTE_EFFICIENCY' | 'SPRINT_SPEED' | 'THROW_ACCURACY' | 'THROW_DISTANCE' | 'THROW_DISTANCE_WITH_BOUNCES' | 'ACCELERATION' | 'BURST' | 'FIRST_TO_HOME' | 'FIRST_TO_SECOND' | 'FIRST_TO_THIRD' | 'HOME_RUN_TROT' | 'HOME_TO_FIRST' | 'HOME_TO_SECOND' | 'HOME_TO_THIRD' | 'LEAD_DISTANCE' | 'OUT_OF_BOX' | 'SECOND_TO_HOME' | 'SECOND_TO_THIRD' | 'SECONDARY_LEAD_DISTANCE' | 'STEAL_FIRST_TO_SECOND' | 'STEAL_SECOND_TO_THIRD' | 'STEAL_THIRD_TO_HOME' | 'TAG_FIRST_STEP' | 'TAG_FIRST_TO_SECOND' | 'TAG_SECOND_TO_THIRD' | 'TAG_THIRD_TO_HOME' | 'THIRD_TO_HOME' | 'OUTS_ABOVE_AVERAGE' | 'FIELDING_RUNS_PREVENTED' | 'STREAK' | 'WINS_ABOVE_REPLACEMENT' | 'GAME_DATE' | 'VERTICAL_BREAK' | 'BURST_DISTANCE' | 'WEIGHTED_RUNS_ABOVE_AVERAGE' | 'WEIGHTED_RUNS_CREATED' | 'WEIGHTED_RUNS_CREATED_PLUS' | 'RUNS_ABOVE_REPLACEMENT' | 'BATTING_RUNS_ABOVE_AVG' | 'FIELDING_RUNS_ABOVE_AVG' | 'POSITIONAL_RUNS_ABOVE_AVG' | 'BASE_RUNNING_RUNS_ABOVE_AVG' | 'WEIGHTED_LEAGUE_ADJUST' | 'REPLACEMENT_RUNS' | 'SPEED_SCORE' | 'ULTIMATE_BASE_RUNNING' | 'WEIGHTED_NOT_GROUND_INTO_DP_RUNS' | 'WEIGHTED_STOLEN_BASE_RUNS' | 'FIELDING_INDEPENDENT_PITCHING' | 'EXPECTED_FIELDING_INDEPENDENT_PITCHING' | 'FIELDING_INDEPENDENT_PITCHING_MINUS' | 'RUNS_ALLOWED_BASED_WAR' | 'SHUTDOWNS' | 'MELTDOWNS' | 'PITCHER_AVERAGE_LEVERAGE_INDEX' | 'INNING_AVERAGE_LEVERAGE_INDEX' | 'GAME_AVERAGE_LEVERAGE_INDEX' | 'END_OF_APPEARANCE_AVERAGE_LEVERAGE_INDEX' | 'ERA_MINUS' | 'JUMP_DISTANCE'

Baseball stat to sort splits by.

sortModifier'avg' | 'max' | 'min' | 'num' | 'p50' | 'p75' | 'p90' | 'comp' | 'num_comp'

The prefix modifier for the sort stat. avg, min, max. I.E minExitVelocity, maxLaunchAngle, avgHitDistance

sortOrder'ASC' | 'DESC'

The order of sorting, ascending or descending

percentileinteger

Only return averages above this percentile. used for best effort plays

minOccurrencesinteger

Minimum occurrences to filter upon

minPlateAppearancesinteger

Minimum occurrences to filter upon

minInningsinteger

Minimum occurrences to filter upon

qualifierRatenumber double

Minimum occurrences to filter upon

sitCodesstring[]

Situation code for a given stat split.

showTotalsboolean

Columns to return totals

includeNullMetricsboolean

Show events with null metrics

statFieldsStatField[]

Baseball stat fields to populate

atBatNumbersinteger[]

The at bat number of a given game. Format: 1, 2, 3, etc

pitchNumbersinteger[]

The pitch number of a given game. Format: 1, 2, 3, etc

fieldsstring[]

Comma delimited list of specific fields to be returned. Format: topLevelNode, childNode, attribute

debugboolean

activeStatus'ACTIVE' | 'INACTIVE' | 'PENDING' | 'BOTH'

Whether or not a player is active

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.