Skip to main content

Matches At Bats​

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

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 at-bats from a specific match_id
https://baseball.sportmicro.com/matches-at-bats?match_id=eq.{match_id}

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

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

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

Query Parameters
  • id integer

    The id of the at-bat

    Example: eq.1
  • match_id integer

    The id of the match

    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
  • incident_type text

    The incident type

    Example: eq.baseballAtBat
  • 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 at-bat

    Note: This is a Primary Key.

  • match_id integer

    The id of the match

    Note: This is a Foreign Key to matches.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 at-bat 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 at-bat 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

  • inning integer

    The inning number

  • inning_half text

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

  • home_team_winning_probability_start numeric

    The home team winning probability before the at-bat

  • away_team_winning_probability_start numeric

    The away team winning probability before the at-bat

  • home_team_winning_probability numeric

    The home team winning probability after the at-bat

  • away_team_winning_probability numeric

    The away team winning probability after the at-bat

  • time timestamp with time zone

    The timestamp of the at-bat

  • incident_type text

    The incident type

Loading...