GET players

Description

Returns a list of players for a team/season.

Resource URL

http://clutchwin.com/api/v1/players.json

Parameters

Field Default Description

season

optional
Specify the year.

team_abbr

optional
Specify the team.

game_type

optional
regular Filters the list for a particular type of game. Valid values: asg, post, regular.

last_name

optional
Specify a last name.

first_name

optional
Specify a last name.

max_entries

optional
100 Number of players to return per request.

start_index

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

Example Requests

Show all players who played in 2013 and had the last name 'Robinson'.

GET

http://clutchwin.com/api/v1/players.json?season=2013&last_name=robinson&access_token=[token]

Response:

[
  {
    "game_type": "regular",
    "season": 2013,
    "team_abbr": "SDN",
    "player_retro_id": "robic002",
    "last_name": "Robinson",
    "first_name": "Chris",
    "bat_hand": "R",
    "pit_hand": "R",
    "rep_team_id": "SDN",
    "pos_tx": "C",
    "team_id": 1948
  },
  {
    "game_type": "regular",
    "season": 2013,
    "team_abbr": "CIN",
    "player_retro_id": "robid002",
    "last_name": "Robinson",
    "first_name": "Derrick",
    "bat_hand": "B",
    "pit_hand": "L",
    "rep_team_id": "CIN",
    "pos_tx": "OF",
    "team_id": 1940
  },
  {
    "game_type": "regular",
    "season": 2013,
    "team_abbr": "SLN",
    "player_retro_id": "robis001",
    "last_name": "Robinson",
    "first_name": "Shane",
    "bat_hand": "R",
    "pit_hand": "R",
    "rep_team_id": "SLN",
    "pos_tx": "OF",
    "team_id": 1950
  }
]
              
Show the first four players from the 1969 Orioles.

GET

http://clutchwin.com/api/v1/players.json?team_abbr=bal&season=1969&max_entries=4&access_token=[token]

Response:

[
  {
    "game_type": "regular",
    "season": 1969,
    "team_abbr": "BAL",
    "player_retro_id": "adamm101",
    "last_name": "Adamson",
    "first_name": "Mike",
    "bat_hand": "R",
    "pit_hand": "R",
    "rep_team_id": "BAL",
    "pos_tx": "X",
    "team_id": 392
  },
  {
    "game_type": "regular",
    "season": 1969,
    "team_abbr": "BAL",
    "player_retro_id": "beenf101",
    "last_name": "Beene",
    "first_name": "Fred",
    "bat_hand": "B",
    "pit_hand": "R",
    "rep_team_id": "BAL",
    "pos_tx": "X",
    "team_id": 392
  },
  {
    "game_type": "regular",
    "season": 1969,
    "team_abbr": "BAL",
    "player_retro_id": "belam101",
    "last_name": "Belanger",
    "first_name": "Mark",
    "bat_hand": "R",
    "pit_hand": "R",
    "rep_team_id": "BAL",
    "pos_tx": "X",
    "team_id": 392
  },
  {
    "game_type": "regular",
    "season": 1969,
    "team_abbr": "BAL",
    "player_retro_id": "bertf101",
    "last_name": "Bertaina",
    "first_name": "Frank",
    "bat_hand": "L",
    "pit_hand": "L",
    "rep_team_id": "BAL",
    "pos_tx": "X",
    "team_id": 392
  }
]
              

Resource Information

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