Players
Player Profile
Player Profile v2.0
Summary
| Player Profile | |
| Resource | |
| Player Profile | Retrieve a player’s profile data including the player’s name, season outlook, eligible positions, owned and started percentage in a fantasy league, latest update etc. |
| Change Log | |
| January 15, 2013 | |
| HTTP Methods | |
| GET | Retrieve a player’s profile. |
| Exceptions | |
| Following list of exceptions will be returned. | |
| Example | |
| Retrieve Player Profile | |
| XML field definitions | |
| /player_profile | A container for a player’s profile data. |
| /player_profile/ | A container for a player’s data. |
| /player_profile/ | ID of a player. |
| /player_profile/ | A container for a list of positions the player is eligible at in a fantasy league. |
| /player_profile/ | A player’s eligible position. |
| /player_profile/ | The player’s first name. |
| /player_profile/ | A boolean to indicate if a player is a free agent in a fantasy league. |
| /player_profile/ | The player’s full name. |
| /player_profile/ | The player’s last name. |
| /player_profile/ | A container for the player’s latest update |
| /player_profile/ | Expert analysis of the update. |
| /player_profile/ | The news item containing the update on the player. |
| /player_profile/ | The timestamp of the player update, in UNIX timestamp format. |
| /player_profile/ | The title of the news story containing the player update. |
| /player_profile/ | The type of the update as determined by the author of the update. |
| /player_profile/ | A boolean to indicate if a player is on waivers in a fantasy league. |
| /player_profile/ | A container for a fantasy team that owns a player a fantasy league. |
| /player_profile/ | ID of a fantasy team that owns a player in a fantasy league. |
| /player_profile/ | Abbreviation of a fantasy team that owns a player in a fantasy league. |
| /player_profile/ | The URL of the logo of the team that owns the player in a fantasy league. |
| /player_profile/ | An abbreviation of the team’s name that owns the player in a fantasy league, as a string with a maximum length of 10 characters. |
| /player_profile/ | The full name for the team that owns the player in a fantasy league. |
| /player_profile/ | An abbreviation of the team’s name that owns the player in a fantasy league, as a string with a maximum length of 6 characters. |
| /player_profile/ | An abbreviation for the primary position of the player. |
| /player_profile/ | Specifies the roster status of the player on the player’s pro team. |
| /player_profile/ | An abbreviation for the player’s pro team. |
| /player_profile/ | A snippet of HTML code containing a link to the player’s profile. |
| /player_profile/ | The absolute URL for the CBSSports.com profile for a player. |
| /player_profile/ | A container for the fantasy roster trends of the player. |
| /player_profile/ | The percentage of fantasy leagues the player is owned in. |
| /player_profile/ | The percentage of fantasy leagues the player is started in. |
| /player_profile/ | A container for the season outlook of a player. |
| /player_profile/ | The timestamp of when the outlook was created in UNIX timestamp format. |
| /player_profile/ | The timestamp of when the outlook was modified in UNIX timestamp format. |
| /player_profile/ | The outlook for a player. |
| /player_profile/ | A number to denote the bye-week for a pro team (only applicable to football). |
| /player_profile/ | A container element for the player’s update, injury, suspension, and inactive icons. |
| /player_profile/ | The headline of the player’s latest news update. |
| /player_profile/ | If the player is injured, this field will exist and indicate the injury in the format: {injury}: {expected time of return}. |
| /player_profile/ | A container element for a player injury. |
| /player_profile/ | The expected return for a player (e.g. |
| /player_profile/ | The type of injury (e.g. |
| /player_profile/ | Status of the player as related to the injury. |
| /player_profile/ | Timestamp of when the injury was added to the list in UNIX timestamp format. |
| /player_profile/ | 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). |
| /player_profile/ | The date in YYYYMMDD format until when a player is going to stay on waivers if the player is on waivers. |
| /player_profile/ | Player’s opponent (only available for football). |
GET
Retrieve a player’s profile.
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. |
| player_id | (required) The ID of the player whose profile is being requested. |
Retrieve Player Profile
Sample URL
http://api.cbssports.com/fantasy/players/profile?version=2.0&player_id=223571
XML Response
<?xml version="1.0"?>
<result uriAlias="/players/profile" uri="/players/profile" statusCode="200" statusMessage="OK">
<body>
<player_profile>
<player id="223571">
<season_outlook>
<created>1328735801</created>
<outlook>Albert Pujols endured a down campaign -- by his standards -- in St. Louis last season as he failed to bat over .300 and post at least 100 RBI for the first time in his career. He hit just .279 over his first 73 games before a fracture in his wrist forced him to miss time in late June. He would come back in early July -- ahead of schedule -- and returned to familiar form. He sported a .579 slugging percentage and hit 20 homers while driving in 54 runs over his final 74 games, finishing the regular season with a .299 average and 99 RBI. Pujols then had a torrid postseason to help lead the Cardinals to the World Series title. After flirting with a couple of teams in the offseason, the 31-year-old signed a 10-year deal with the Angels and is expected to continue to post huge numbers in his first season in the American League. Los Angeles won’t give him the lineup protection St. Louis would have offered, but he’ll have the luxury of the DH to help him rest throughout the season. The three-time NL MVP has averaged 40 homers with 120 RBI a .328 average through his first 11 years in the majors and should remain an elite option in Fantasy heading into 2012. Pujols will be one of the first two or three players off the board in just about every draft this season.</outlook>
<modified>1328735801</modified>
</season_outlook>
<firstname>Albert</firstname>
<free_agent>0</free_agent>
<on_waivers>0</on_waivers>
<position>1B</position>
<lastname>Pujols</lastname>
<eligible_positions>
<eligible_position>1B</eligible_position>
<eligible_position>CI</eligible_position>
<eligible_position>U</eligible_position>
</eligible_positions>
<roster_trends>
<start_pct>99</start_pct>
<owned_pct>100</owned_pct>
</roster_trends>
<profile_link><a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/223571'>Pujols, Albert</a> 1B LAA <span title="Albert Pujols doubles (13) on a fly ball to left fielder Mike Carp."><a href="javascript:openPopup('/media/game-day/video?player_id=405395','mlbvideo', 990, 750);"><img src="http://sports.cbsimg.net/images/video.gif" border="0"></a></span></profile_link>
<owned_by_team id="6">
<logo>http://sports.cbsimg.net/images/splash/baseball/md-mgmtgold.gif</logo>
<long_abbr>Team6</long_abbr>
<abbr>T6</abbr>
<short_name>Team 6</short_name>
<name>Team 6</name>
</owned_by_team>
<latest_update>
<timestamp>1338747829</timestamp>
<news>Angels manager Mike Sciscoia said Saturday that <a class="playerLink" href="/players/playerpage/223571/albert-pujols">Albert Pujols</a> will play some games at third base during interleague play in NL parks to get <a class="playerLink" href="/players/playerpage/534114/kendrys-morales">Kendrys Morales</a> bat in the lineup at first base. "It's not something I'll do all year, but I feel pretty comfortable doing it," Pujols said. "Whatever we can do to keep Morales in the lineup would be huge. It's about what I can do every day to help the club win." Morales, who has been limited to DH duties this year after sitting out 1 1/2 years because of a broken left ankle, could start three or four times at first base in interleague play. "Kendrys has been working out at first, and we feel much more comfortable with how he's moving, how he feels," Scioscia said. "His mobility is much better."</news>
<type>normal</type>
<title>Pujols to play 3B in NL parks</title>
<analysis>This could be very big news for Fantasy owners if Pujols gets at least four more games at third base this season. That would give him third-base eligibility in Fantasy, which would of course make him that much more valuable. After a slow start to the season, Pujols has been himself again for the last month. He is batting .284 with eight homers and 24 RBI in his last 26 games. Continue to roll with him in all Fantasy formats.</analysis>
</latest_update>
<pro_status>A</pro_status>
<profile_url>http://<league_id>.baseball.cbssports.com/players/playerpage/223571</profile_url>
<fullname>Albert Pujols</fullname>
<pro_team>LAA</pro_team>
</player>
</player_profile>
</body>
</result>JSON Response
{
"body" : {
"player_profile" : {
"player" : {
"season_outlook" : {
"created" : "1328735801",
"outlook" : "Albert Pujols endured a down campaign -- by his standards -- in St. Louis last season as he failed to bat over .300 and post at least 100 RBI for the first time in his career. He hit just .279 over his first 73 games before a fracture in his wrist forced him to miss time in late June. He would come back in early July -- ahead of schedule -- and returned to familiar form. He sported a .579 slugging percentage and hit 20 homers while driving in 54 runs over his final 74 games, finishing the regular season with a .299 average and 99 RBI. Pujols then had a torrid postseason to help lead the Cardinals to the World Series title. After flirting with a couple of teams in the offseason, the 31-year-old signed a 10-year deal with the Angels and is expected to continue to post huge numbers in his first season in the American League. Los Angeles wont give him the lineup protection St. Louis would have offered, but hell have the luxury of the DH to help him rest throughout the season. The three-time NL MVP has averaged 40 homers with 120 RBI a .328 average through his first 11 years in the majors and should remain an elite option in Fantasy heading into 2012. Pujols will be one of the first two or three players off the board in just about every draft this season.",
"modified" : "1328735801"
},
"firstname" : "Albert",
"free_agent" : 0,
"on_waivers" : 0,
"position" : "1B",
"lastname" : "Pujols",
"eligible_positions" : [
"1B",
"CI",
"U"
],
"roster_trends" : {
"start_pct" : 99,
"owned_pct" : 100
},
"id" : "223571",
"profile_link" : "<a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/223571'>Pujols, Albert</a> 1B LAA <span title=\"Albert Pujols doubles (13) on a fly ball to left fielder Mike Carp.\"><a href=\"javascript:openPopup('/media/game-day/video?player_id=405395','mlbvideo', 990, 750);\"><img src=\"http://sports.cbsimg.net/images/video.gif\" border=\"0\"></a></span>",
"owned_by_team" : {
"logo" : "http://sports.cbsimg.net/images/splash/baseball/md-mgmtgold.gif",
"long_abbr" : "Team6",
"abbr" : "T6",
"short_name" : "Team 6",
"name" : "Team 6",
"id" : 6
},
"latest_update" : {
"timestamp" : "1338747829",
"news" : "Angels manager Mike Sciscoia said Saturday that <a class=\"playerLink\" href=\"/players/playerpage/223571/albert-pujols\">Albert Pujols</a> will play some games at third base during interleague play in NL parks to get <a class=\"playerLink\" href=\"/players/playerpage/534114/kendrys-morales\">Kendrys Morales</a> bat in the lineup at first base. \"It's not something I'll do all year, but I feel pretty comfortable doing it,\" Pujols said. \"Whatever we can do to keep Morales in the lineup would be huge. It's about what I can do every day to help the club win.\" Morales, who has been limited to DH duties this year after sitting out 1 1/2 years because of a broken left ankle, could start three or four times at first base in interleague play. \"Kendrys has been working out at first, and we feel much more comfortable with how he's moving, how he feels,\" Scioscia said. \"His mobility is much better.\"",
"type" : "normal",
"title" : "Pujols to play 3B in NL parks",
"analysis" : "This could be very big news for Fantasy owners if Pujols gets at least four more games at third base this season. That would give him third-base eligibility in Fantasy, which would of course make him that much more valuable. After a slow start to the season, Pujols has been himself again for the last month. He is batting .284 with eight homers and 24 RBI in his last 26 games. Continue to roll with him in all Fantasy formats."
},
"pro_status" : "A",
"profile_url" : "http://<league_id>.baseball.cbssports.com/players/playerpage/223571",
"fullname" : "Albert Pujols",
"pro_team" : "LAA"
}
}
},
"uriAlias" : "/players/profile",
"statusMessage" : "OK",
"uri" : "/players/profile",
"statusCode" : 200
}Sample URL
http://api.cbssports.com/fantasy/players/profile?version=2.0&player_id=187741
XML Response
<?xml version="1.0"?>
<result uriAlias="/players/profile" uri="/players/profile" statusCode="200" statusMessage="OK">
<body>
<player_profile>
<player id="187741">
<season_outlook>
<created>1337865523</created>
<outlook>The last time Tom Brady lost a Super Bowl to the New York Giants in 2007, he spent the following season on injured reserve after suffering a torn ACL in Week 1. So obviously, Brady can't do much worse than that in 2012. What's funny is that for a guy coming off a career-high 5,235 passing yards in 2011 with 39 touchdown passes and three touchdown runs, expectations are higher than ever before because he has what is arguably the best receiving corps of his career. His top three weapons of Wes Welker, Rob Gronkowski and Aaron Hernandez are all expected back, and the Patriots also added Brandon Lloyd, Donte Stallworth and Anthony Gonzalez while retaining Deion Branch and Chad Ochocinco. We doubt all these guys make the team, but Brady will clearly be surrounded by some great talent. Even with the loss of left tackle Matt Light, he should remain well protected and should pick apart most of the defenses he'll face. You can make an argument that Brady is the No. 1 Fantasy quarterback, but he's easily a Top 3 option among the group of Aaron Rodgers and Drew Brees. Brady should be drafted toward the end of Round 1 or beginning of Round 2 in all leagues.</outlook>
<modified>1337865523</modified>
</season_outlook>
<firstname>Tom</firstname>
<free_agent>0</free_agent>
<on_waivers>1</on_waivers>
<position>QB</position>
<icons>
<injury>Shoulder: Probable for start of 2012 training camp</injury>
<headline>Slight changes for Brady</headline>
</icons>
<lastname>Brady</lastname>
<eligible_positions>
<eligible_position>QB</eligible_position>
</eligible_positions>
<is_locked>0</is_locked>
<opponent>@TEN</opponent>
<roster_trends>
<start_pct>98</start_pct>
<owned_pct>100</owned_pct>
</roster_trends>
<profile_link><a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/187741'>Brady, Tom</a> QB NE <span title="Slight changes for Brady"><a href="http://<league_id>.football.cbssports.com/players/playerpage/187741" class="playerLink" subtab="Update"><img border="0" width="7" height="7" src="http://sports.cbsimg.net/images/news-note.gif"/></a></span><img src='http://sports.cbsimg.net/images/spacer.gif' height=1 width=2><span title="Shoulder: Probable for start of 2012 training camp"><a href="http://<league_id>.football.cbssports.com/players/playerpage/187741" subtab="Injury Report" class="playerLink"><img border="0" width="7" height="7" src="http://sports.cbsimg.net/images/red_cross.gif"/></a></span></profile_link>
<bye_week>9</bye_week>
<owned_by_team id="13">
<logo>http://<league_id>.football.cbssports.com/images/team-logo/sentamc-senta_logo-36x36.gif</logo>
<long_abbr>Smash</long_abbr>
<abbr>Sma</abbr>
<short_name>Smashm</short_name>
<name>Smashmouths</name>
</owned_by_team>
<latest_update>
<timestamp>1338495593</timestamp>
<news>Patriots quarterback <a class="playerLink" href="/players/playerpage/187741/tom-brady">Tom Brady</a> has some new things to get used to this year. First is the return of offensive coordinator Josh McDaniels, who is back in New England after being a head coach in Denver and the offensive coordinator in St. Louis. "There&#146;s always getting up to speed when certain things have changed &#150; what he&#146;s done the last three or four years and certainly things we&#146;ve changed," Brady said. "But his competitiveness is still there, his willingness to do whatever it takes to win is still there and he loves football. I think that&#146;s why we get along so well." Brady also has a new left tackle with Matt Light retiring this offseason. Nate Solder is now in charge with protecting Brady's blind side. "Matt was an incredible player for this team and organization," Brady said. "It&#146;s sad when you see guys move on to other parts of their life." He also appears a little lighter. "I feel like I can go out there and hang with the guys in conditioning," he said. "I&#146;m feeling pretty good."</news>
<type>normal</type>
<title>Slight changes for Brady</title>
<analysis>Brady also has an improved receiving corps with the additions of Brandon Lloyd, Jabar Gaffney and Donte Stallworth. Add them to Wes Welker, Deion Branch, Rob Gronkowski and Aaron Hernandez, and Brady might have the best receiving corps of his career. We consider Brady a No. 1 Fantasy quarterback in all leagues, and he should be drafted toward the end of Round 1 or beginning of Round 2 in all formats.</analysis>
</latest_update>
<pro_status>A</pro_status>
<on_waivers_until>20991231</on_waivers_until>
<profile_url>http://<league_id>.football.cbssports.com/players/playerpage/187741</profile_url>
<injury>
<expected_return>Probable for start of 2012 training camp</expected_return>
<injury_type>Shoulder</injury_type>
<timestamp>1329316832</timestamp>
<status>Probable</status>
</injury>
<fullname>Tom Brady</fullname>
<pro_team>NE</pro_team>
</player>
</player_profile>
</body>
</result>JSON Response
{
"body" : {
"player_profile" : {
"player" : {
"season_outlook" : {
"created" : "1337865523",
"outlook" : "The last time Tom Brady lost a Super Bowl to the New York Giants in 2007, he spent the following season on injured reserve after suffering a torn ACL in Week 1. So obviously, Brady can't do much worse than that in 2012. What's funny is that for a guy coming off a career-high 5,235 passing yards in 2011 with 39 touchdown passes and three touchdown runs, expectations are higher than ever before because he has what is arguably the best receiving corps of his career. His top three weapons of Wes Welker, Rob Gronkowski and Aaron Hernandez are all expected back, and the Patriots also added Brandon Lloyd, Donte Stallworth and Anthony Gonzalez while retaining Deion Branch and Chad Ochocinco. We doubt all these guys make the team, but Brady will clearly be surrounded by some great talent. Even with the loss of left tackle Matt Light, he should remain well protected and should pick apart most of the defenses he'll face. You can make an argument that Brady is the No. 1 Fantasy quarterback, but he's easily a Top 3 option among the group of Aaron Rodgers and Drew Brees. Brady should be drafted toward the end of Round 1 or beginning of Round 2 in all leagues.",
"modified" : "1337865523"
},
"firstname" : "Tom",
"free_agent" : 0,
"on_waivers" : 1,
"position" : "QB",
"icons" : {
"injury" : "Shoulder: Probable for start of 2012 training camp",
"headline" : "Slight changes for Brady"
},
"lastname" : "Brady",
"eligible_positions" : [
"QB"
],
"is_locked" : 0,
"opponent" : "@TEN",
"roster_trends" : {
"start_pct" : 98,
"owned_pct" : 100
},
"id" : "187741",
"profile_link" : "<a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/187741'>Brady, Tom</a> QB NE <span title=\"Slight changes for Brady\"><a href=\"http://<league_id>.football.cbssports.com/players/playerpage/187741\" class=\"playerLink\" subtab=\"Update\"><img border=\"0\" width=\"7\" height=\"7\" src=\"http://sports.cbsimg.net/images/news-note.gif\"/></a></span><img src='http://sports.cbsimg.net/images/spacer.gif' height=1 width=2><span title=\"Shoulder: Probable for start of 2012 training camp\"><a href=\"http://<league_id>.football.cbssports.com/players/playerpage/187741\" subtab=\"Injury Report\" class=\"playerLink\"><img border=\"0\" width=\"7\" height=\"7\" src=\"http://sports.cbsimg.net/images/red_cross.gif\"/></a></span>",
"bye_week" : "9",
"owned_by_team" : {
"logo" : "http://<league_id>.football.cbssports.com/images/team-logo/sentamc-senta_logo-36x36.gif",
"long_abbr" : "Smash",
"abbr" : "Sma",
"short_name" : "Smashm",
"name" : "Smashmouths",
"id" : "13"
},
"latest_update" : {
"timestamp" : "1338495593",
"news" : "Patriots quarterback <a class=\"playerLink\" href=\"/players/playerpage/187741/tom-brady\">Tom Brady</a> has some new things to get used to this year. First is the return of offensive coordinator Josh McDaniels, who is back in New England after being a head coach in Denver and the offensive coordinator in St. Louis. \"There’s always getting up to speed when certain things have changed – what he’s done the last three or four years and certainly things we’ve changed,\" Brady said. \"But his competitiveness is still there, his willingness to do whatever it takes to win is still there and he loves football. I think that’s why we get along so well.\" Brady also has a new left tackle with Matt Light retiring this offseason. Nate Solder is now in charge with protecting Brady's blind side. \"Matt was an incredible player for this team and organization,\" Brady said. \"It’s sad when you see guys move on to other parts of their life.\" He also appears a little lighter. \"I feel like I can go out there and hang with the guys in conditioning,\" he said. \"I’m feeling pretty good.\"",
"type" : "normal",
"title" : "Slight changes for Brady",
"analysis" : "Brady also has an improved receiving corps with the additions of Brandon Lloyd, Jabar Gaffney and Donte Stallworth. Add them to Wes Welker, Deion Branch, Rob Gronkowski and Aaron Hernandez, and Brady might have the best receiving corps of his career. We consider Brady a No. 1 Fantasy quarterback in all leagues, and he should be drafted toward the end of Round 1 or beginning of Round 2 in all formats."
},
"pro_status" : "A",
"on_waivers_until" : "20991231",
"profile_url" : "http://<league_id>.football.cbssports.com/players/playerpage/187741",
"injury" : {
"expected_return" : "Probable for start of 2012 training camp",
"injury_type" : "Shoulder",
"timestamp" : 1329316832,
"status" : "Probable"
},
"fullname" : "Tom Brady",
"pro_team" : "NE"
}
}
},
"uriAlias" : "/players/profile",
"statusMessage" : "OK",
"uri" : "/players/profile",
"statusCode" : 200
}/player_profile/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.
/player_profile/player/injury/status
Status of the player as related to the injury. Possbile values are Out, OK, Probable, Doubtful, Questionable, DL (Disabled List), IL (Injured List), PUP (Physically Unable to Perform List), IR (Injured Reserve), Suspended, Not With Team, Retired, Gametime (Game-time decision whether the player will play in the game or not).
