GET opponents/pitchers

Description

Returns a list of the pitchers that the specified batter/team has faced.

Resource URL

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

Parameters

Field Default Description

season

optional
Only pitchers for the specified season will be returned.

start_date

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

end_date

optional
Specifies the end of the time period for which pitchers 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 pitchers where the specified team is the visiting team.

home_team_id

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

bat_team_id

optional
Return only pitchers where the specified team is batting.

fld_team_id

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

bat_id

optional
Return only pitchers where the specified player was batting.

bat_hand_cd

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

pit_hand_cd

optional
Return only pitchers where the pitcher 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 the left-handed pitchers that Chris Davis faced in 2013 (limited to five results).

GET

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

Response:

[
  {
    "player_id": "duenb001",
    "last_name": "Duensing",
    "first_name": "Brian",
    "debut_date": "2009-04-10",
    "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": "robet001",
    "last_name": "Robertson",
    "first_name": "Tyler",
    "debut_date": "2012-06-26",
    "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": "hernp001",
    "last_name": "Hernandez",
    "first_name": "Pedro",
    "debut_date": "2012-07-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": "ramoc001",
    "last_name": "Ramos",
    "first_name": "Cesar",
    "debut_date": "2009-09-16",
    "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": "moorm003",
    "last_name": "Moore",
    "first_name": "Matt",
    "debut_date": "2011-09-14",
    "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