GET opponents/batters

Description

Returns a list of the batters that the specified pitcher/team has faced.

Resource URL

http://clutchwin.com/api/v1/opponents/batters.json

Parameters

Field Default Description

season

optional
Only batters for the specified season will be returned.

start_date

optional
Specifies the beginning of the time period for which batters should be returned. Format: YYYY-MM-DD

end_date

optional
Specifies the end of the time period for which batters should be returned. Format: YYYY-MM-DD

game_type

optional
regular Filters the list for a particular type of game (regular, all-star, or post-season). Valid values: asg, post, regular.

away_team_id

optional
Return only batters where the specified team is the visiting team.

home_team_id

optional
Return only batters where the specified team is the home team.

bat_team_id

optional
Return only batters where the specified team is batting.

fld_team_id

optional
Return only batters where the specified team is in the field.

pit_id

optional
Return only batters where the specified player was pitching.

bat_hand_cd

optional
Return only batters where the batter was batting from the left/right side. Valid values: r, l.

pit_hand_cd

optional
Return only batters where the batter threw from the left/right side. Valid values: r, l.

fieldset

optional
Return a limited set of fields. Valid values: basic.

max_entries

optional
100 Number of entries to return per request.

start_index

optional
1 The index of the first entry to be returned (used for paging).

Example Requests

Return a list of batters that Matt Moore faced in 2013 (limited to five results).

GET

http://clutchwin.com/api/v1/opponents/batters.json?season=2013&bat_id=davic003&pit_hand_cd=l&max_entries=5&access_token=[token]

Response:

[
  {
    "player_id": "montm001",
    "last_name": "Montero",
    "first_name": "Miguel",
    "debut_date": "2006-09-06",
    "date_of_birth": null,
    "birth_country": null,
    "birth_state": null,
    "birth_city": null,
    "date_of_death": null,
    "death_country": null,
    "death_state": null,
    "death_city": null,
    "given_name": null,
    "weight": null,
    "height": null,
    "bats": null,
    "throws": null,
    "last_game_date": null
  },
  {
    "player_id": "goldp001",
    "last_name": "Goldschmidt",
    "first_name": "Paul",
    "debut_date": "2011-08-01",
    "date_of_birth": null,
    "birth_country": null,
    "birth_state": null,
    "birth_city": null,
    "date_of_death": null,
    "death_country": null,
    "death_state": null,
    "death_city": null,
    "given_name": null,
    "weight": null,
    "height": null,
    "bats": null,
    "throws": null,
    "last_game_date": null
  },
  {
    "player_id": "kubej002",
    "last_name": "Kubel",
    "first_name": "Jason",
    "debut_date": "2004-08-31",
    "date_of_birth": null,
    "birth_country": null,
    "birth_state": null,
    "birth_city": null,
    "date_of_death": null,
    "death_country": null,
    "death_state": null,
    "death_city": null,
    "given_name": null,
    "weight": null,
    "height": null,
    "bats": null,
    "throws": null,
    "last_game_date": null
  },
  {
    "player_id": "polla001",
    "last_name": "Pollock",
    "first_name": "A.J.",
    "debut_date": "2012-04-18",
    "date_of_birth": null,
    "birth_country": null,
    "birth_state": null,
    "birth_city": null,
    "date_of_death": null,
    "death_country": null,
    "death_state": null,
    "death_city": null,
    "given_name": null,
    "weight": null,
    "height": null,
    "bats": null,
    "throws": null,
    "last_game_date": null
  },
  {
    "player_id": "heywj001",
    "last_name": "Heyward",
    "first_name": "Jason",
    "debut_date": "2010-04-05",
    "date_of_birth": null,
    "birth_country": null,
    "birth_state": null,
    "birth_city": null,
    "date_of_death": null,
    "death_country": null,
    "death_state": null,
    "death_city": null,
    "given_name": null,
    "weight": null,
    "height": null,
    "bats": null,
    "throws": null,
    "last_game_date": null
  }
]
              

Resource Information

Rate Limited? No
Requests per rate limit window N/A
Response Formats json, xml
HTTP Methods GET
Resource family opponents
API Version API v1.0