Skip to main content

Matches At Bats Pitches​

This endpoint allows you to retrieve the pitches from baseball at-bats.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every minute. Recommended Calls: Limit calls to 1 per minute.

Use Cases​

Get pitches from a specific match_id
https://baseball.sportmicro.com/matches-at-bats-pitches?match_id=eq.{match_id}

Get pitches from a specific match_id and at_bat_id
https://baseball.sportmicro.com/matches-at-bats-pitches?match_id=eq.{match_id}&at_bat_id=eq.{at_bat_id}

Get pitches from a specific match_id and pitcher_id
https://baseball.sportmicro.com/matches-at-bats-pitches?match_id=eq.{match_id}&pitcher_id=eq.{pitcher_id}

Get pitches from a specific match_id and hitter_id
https://baseball.sportmicro.com/matches-at-bats-pitches?match_id=eq.{match_id}&hitter_id=eq.{hitter_id}

Query Parameters
  • id integer

    The id of the pitch

    Example: eq.1
  • match_id integer

    The id of the match

    Example: eq.1
  • at_bat_id integer

    The id of the at-bat

    Example: eq.1
  • pitcher_id integer

    The id of the pitcher

    Example: eq.1
  • pitcher_team_id integer

    The id of the pitcher's team

    Example: eq.1
  • hitter_id integer

    The id of the hitter

    Example: eq.2
  • hitter_team_id integer

    The id of the hitter's team

    Example: eq.2
  • inning integer

    The inning number

    Example: eq.1
  • inning_half text

    The inning half (T for top, B for bottom)

    Example: eq.T
  • pitch_count integer

    The pitch count inside the at-bat

    Example: eq.1
  • sequence integer

    The sequence number of the pitch within the at-bat

    Example: eq.1
  • outcome text

    The outcome of the pitch

    Example: eq.ball
  • incident_type text

    The incident type

    Example: eq.baseballPitch
  • offset string

    Default value: 0

    Limiting and Pagination

    Example: 0
  • limit string

    Default value: 50

    Limiting and Pagination

    Example: 50
  • lang string

    Default value: en

    Multi-language

    Example: en
Responses

OK

Schema array
  • id integer

    The id of the pitch

    Note: This is a Primary Key.

  • match_id integer

    The id of the match

    Note: This is a Foreign Key to matches.id.

  • at_bat_id integer

    The id of the at-bat

    Note: This is a Foreign Key to matches-at-bats.id.

  • pitcher_id integer

    The id of the pitcher

    Note: This is a Foreign Key to players.id.

  • pitcher_name text

    The name of the pitcher

  • pitcher_hash_image character varying

    The hash image of the pitcher

  • pitcher_position text

    The position of the pitcher from the pitch feed

  • pitcher_jersey_number text

    The jersey number of the pitcher

  • pitcher_team_id integer

    The id of the pitcher's team

    Note: This is a Foreign Key to teams.id.

  • pitcher_team_name text

    The name of the pitcher's team

  • pitcher_team_hash_image character varying

    The hash image of the pitcher's team

  • hitter_id integer

    The id of the hitter

    Note: This is a Foreign Key to players.id.

  • hitter_name text

    The name of the hitter

  • hitter_hash_image character varying

    The hash image of the hitter

  • hitter_position text

    The position of the hitter from the pitch feed

  • hitter_jersey_number text

    The jersey number of the hitter

  • hitter_team_id integer

    The id of the hitter's team

    Note: This is a Foreign Key to teams.id.

  • hitter_team_name text

    The name of the hitter's team

  • hitter_team_hash_image character varying

    The hash image of the hitter's team

  • status text

    The status of the pitch

  • outcome text

    The outcome of the pitch

  • type text

    The type of the pitch

  • start_time timestamp with time zone

    The start timestamp of the pitch

  • end_time timestamp with time zone

    The end timestamp of the pitch

  • is_ab_over boolean

    If the at-bat is over after the pitch

  • is_bunt boolean

    If the pitch resulted in a bunt

  • is_hit boolean

    If the pitch resulted in a hit

  • is_wild_pitch boolean

    If the pitch was a wild pitch

  • is_passed_ball boolean

    If the pitch resulted in a passed ball

  • is_double_play boolean

    If the pitch resulted in a double play

  • is_triple_play boolean

    If the pitch resulted in a triple play

  • balls integer

    The number of balls after the pitch

  • strikes integer

    The number of strikes after the pitch

  • outs integer

    The number of outs after the pitch

  • pitch_count integer

    The pitch count inside the at-bat

  • pitch_type text

    The type of the pitch from the tracking feed

  • pitch_speed numeric

    The speed of the pitch

  • pitch_zone integer

    The zone of the pitch

  • pitcher_hand text

    The throwing hand of the pitcher

  • hitter_hand text

    The batting hand of the hitter

  • pitch_x numeric

    The x coordinate of the pitch

  • pitch_y numeric

    The y coordinate of the pitch

  • home_team_runs integer

    The home team runs after the pitch

  • away_team_runs integer

    The away team runs after the pitch

  • mlb_speed numeric

    The MLB speed value of the pitch

  • strike_zone_top numeric

    The top of the strike zone

  • strike_zone_bottom numeric

    The bottom of the strike zone

  • mlb_zone integer

    The MLB zone of the pitch

  • pitch_code text

    The MLB pitch code

  • pitch_description text

    The description of the pitch

  • mlb_x numeric

    The MLB x coordinate of the pitch

  • mlb_y numeric

    The MLB y coordinate of the pitch

  • sequence integer

    The sequence number of the pitch within the at-bat

  • inning integer

    The inning number

  • inning_half text

    The inning half (T for top, B for bottom)

  • time integer

    The time marker of the pitch

  • incident_type text

    The incident type

  • fielders text

    The fielders involved in the pitch as JSON text

Loading...