Players
Player List
Player List v2.0
Summary
| Player List | |
| Resource | |
| Player List | Retrieve a list of all professional players for a sport. |
| HTTP Methods | |
| GET | Retrieve a list of players. |
| Example | |
| Retrieve All Players | |
| XML field definitions | |
| /players | A container element for the players. |
| /players/ | A container for a player’s data. |
| /players/ | ID of a player. |
| /players/ | The player’s first name. |
| /players/ | The player’s full name. |
| /players/ | A container element for the player’s update and injury icons. |
| /players/ | The headline of the player’s latest news update. |
| /players/ | If the player is injured, this field will exist and indicate the injury in the format: {injury}: {expected time of return} |
| /players/ | The player’s last name. |
| /players/ | A boolean to denote if a player is on waivers in a fantasy league or no. |
| /players/ | An abbreviation for the primary position of the player. |
| /players/ | Specifies the roster status of the player on the player’s pro team. |
| /players/ | An abbreviation for the player’s pro team. |
| /players/ | A number to denote the bye-week for a pro team (only applicable to football). |
| /players/ | A boolean to denote if a player is locked (can not be involved in any add/drops, trades, and lineup moves as the player’s team’s game has already started). |
| /players/ | Player’s opponent (only available for football). |
GET
Retrieve a list of players.
URL
http://api.cbssports.com
Parameters
| response_format | (optional) Specifies the format in which the requested resource should be returned. Valid values are XML and JSON. The default is XML. |
Retrieve All Players
Sample URL
http://api.cbssports.com/fantasy/players/list?version=2.0&SPORT=baseball
XML Response
<?xml version="1.0"?>
<result uriAlias="/players/list" uri="/players/list" statusCode="200" statusMessage="OK">
<body>
<players>
<player id="479025">
<firstname>David</firstname>
<on_waivers>0</on_waivers>
<position>RP</position>
<icons>
<injury>Elbow: 60-day DL. Out until at least early July</injury>
<headline>Aardsma advancing in rehab</headline>
</icons>
<lastname>Aardsma</lastname>
<pro_status>DL</pro_status>
<fullname>David Aardsma</fullname>
<pro_team>NYY</pro_team>
</player>
<player id="213961">
<pro_status>N</pro_status>
<firstname>Andy A.</firstname>
<on_waivers>0</on_waivers>
<position>LF</position>
<fullname>Andy A. Abad</fullname>
<lastname>Abad</lastname>
<pro_team>MIL</pro_team>
</player>
<player id="1723564">
<firstname>Fernando</firstname>
<on_waivers>1</on_waivers>
<position>RP</position>
<icons>
<injury>Side: 15-day DL. Out until at least mid-June</injury>
</icons>
<lastname>Abad</lastname>
<pro_status>DL</pro_status>
<fullname>Fernando Abad</fullname>
<pro_team>HOU</pro_team>
</player>
<player id="1102954">
<pro_status>M</pro_status>
<firstname>James</firstname>
<on_waivers>0</on_waivers>
<position>RP</position>
<fullname>James Abbott</fullname>
<lastname>Abbott</lastname>
<pro_team>MIN</pro_team>
</player>
<player id="292335">
<pro_status>M</pro_status>
<firstname>Reggie</firstname>
<on_waivers>0</on_waivers>
<position>LF</position>
<fullname>Reggie Abercrombie</fullname>
<lastname>Abercrombie</lastname>
<pro_team>HOU</pro_team>
</player>
</players>
</body>
</result>JSON Response
{
"body" : {
"players" : [
{
"firstname" : "David",
"on_waivers" : 0,
"position" : "RP",
"icons" : {
"injury" : "Elbow: 60-day DL. Out until at least early July",
"headline" : "Aardsma advancing in rehab"
},
"lastname" : "Aardsma",
"pro_status" : "DL",
"fullname" : "David Aardsma",
"id" : "479025",
"pro_team" : "NYY"
},
{
"pro_status" : "N",
"firstname" : "Andy A.",
"on_waivers" : 0,
"position" : "LF",
"fullname" : "Andy A. Abad",
"lastname" : "Abad",
"id" : "213961",
"pro_team" : "MIL"
},
{
"firstname" : "Fernando",
"on_waivers" : 1,
"position" : "RP",
"icons" : {
"injury" : "Side: 15-day DL. Out until at least mid-June"
},
"lastname" : "Abad",
"pro_status" : "DL",
"fullname" : "Fernando Abad",
"id" : "1723564",
"pro_team" : "HOU"
},
{
"pro_status" : "M",
"firstname" : "James",
"on_waivers" : 0,
"position" : "RP",
"fullname" : "James Abbott",
"lastname" : "Abbott",
"id" : "1102954",
"pro_team" : "MIN"
},
{
"pro_status" : "M",
"firstname" : "Reggie",
"on_waivers" : 0,
"position" : "LF",
"fullname" : "Reggie Abercrombie",
"lastname" : "Abercrombie",
"id" : "292335",
"pro_team" : "HOU"
}
]
},
"uriAlias" : "/players/list",
"statusMessage" : "OK",
"uri" : "/players/list",
"statusCode" : 200
}Sample URL
http://api.cbssports.com/fantasy/players/list?version=2.0&SPORT=football
XML Response
<?xml version="1.0"?>
<result uriAlias="/players/list" uri="/players/list" statusCode="200" statusMessage="OK">
<body>
<players>
<player id="1905948">
<bye_week>7</bye_week>
<firstname>Isaako</firstname>
<on_waivers>1</on_waivers>
<position>DL</position>
<lastname>Aaitui</lastname>
<is_locked>0</is_locked>
<opponent>@HOU</opponent>
<pro_status>A</pro_status>
<fullname>Isaako Aaitui</fullname>
<pro_team>MIA</pro_team>
</player>
<player id="1891893">
<bye_week>6</bye_week>
<firstname>Isa</firstname>
<on_waivers>1</on_waivers>
<position>DB</position>
<lastname>Abdul-Quddus</lastname>
<is_locked>0</is_locked>
<opponent>WAS</opponent>
<pro_status>A</pro_status>
<fullname>Isa Abdul-Quddus</fullname>
<pro_team>NO</pro_team>
</player>
<player id="541373">
<bye_week>10</bye_week>
<firstname>Hamza</firstname>
<on_waivers>1</on_waivers>
<position>DB</position>
<lastname>Abdullah</lastname>
<is_locked>0</is_locked>
<opponent>SEA</opponent>
<pro_status>A</pro_status>
<fullname>Hamza Abdullah</fullname>
<pro_team>ARI</pro_team>
</player>
<player id="405198">
<bye_week>11</bye_week>
<firstname>Husain</firstname>
<on_waivers>1</on_waivers>
<position>DB</position>
<lastname>Abdullah</lastname>
<is_locked>0</is_locked>
<opponent>JAC</opponent>
<pro_status>A</pro_status>
<fullname>Husain Abdullah</fullname>
<pro_team>MIN</pro_team>
</player>
<player id="405208">
<bye_week>7</bye_week>
<firstname>Victor</firstname>
<on_waivers>1</on_waivers>
<position>DL</position>
<lastname>Abiamiri</lastname>
<is_locked>0</is_locked>
<opponent>@CLE</opponent>
<pro_status>A</pro_status>
<fullname>Victor Abiamiri</fullname>
<pro_team>PHI</pro_team>
</player>
</players>
</body>
</result>JSON Response
{
"body" : {
"players" : [
{
"bye_week" : "7",
"firstname" : "Isaako",
"on_waivers" : 1,
"position" : "DL",
"lastname" : "Aaitui",
"is_locked" : 0,
"opponent" : "@HOU",
"pro_status" : "A",
"fullname" : "Isaako Aaitui",
"id" : "1905948",
"pro_team" : "MIA"
},
{
"bye_week" : "6",
"firstname" : "Isa",
"on_waivers" : 1,
"position" : "DB",
"lastname" : "Abdul-Quddus",
"is_locked" : 0,
"opponent" : "WAS",
"pro_status" : "A",
"fullname" : "Isa Abdul-Quddus",
"id" : "1891893",
"pro_team" : "NO"
},
{
"bye_week" : "10",
"firstname" : "Hamza",
"on_waivers" : 1,
"position" : "DB",
"lastname" : "Abdullah",
"is_locked" : 0,
"opponent" : "SEA",
"pro_status" : "A",
"fullname" : "Hamza Abdullah",
"id" : "541373",
"pro_team" : "ARI"
},
{
"bye_week" : "11",
"firstname" : "Husain",
"on_waivers" : 1,
"position" : "DB",
"lastname" : "Abdullah",
"is_locked" : 0,
"opponent" : "JAC",
"pro_status" : "A",
"fullname" : "Husain Abdullah",
"id" : "405198",
"pro_team" : "MIN"
},
{
"bye_week" : "7",
"firstname" : "Victor",
"on_waivers" : 1,
"position" : "DL",
"lastname" : "Abiamiri",
"is_locked" : 0,
"opponent" : "@CLE",
"pro_status" : "A",
"fullname" : "Victor Abiamiri",
"id" : "405208",
"pro_team" : "PHI"
}
]
},
"uriAlias" : "/players/list",
"statusMessage" : "OK",
"uri" : "/players/list",
"statusCode" : 200
}/players/player/@id
ID of a player. You can use this ID to get more information about a player by requesting the Player Outlook and Player Updates resources.
/players/player/position
An abbreviation for the primary position of the player. You can get a list of the abbreviations and their expansions by requesting the Positions resource.
