Most Added v2.0

Summary
Most Added
Resource
Most AddedA list of the pro players who have been added most often within a fantasy league.
HTTP Methods
GETRetrieve a list of most-added players.
Example
Get the four most added players
XML field definitions
/most_addedA container element for the most added players.
/most_added/playersA container element for the list of players.
/most_added/players/playerContainer element for a player in the list of most added players.
/most_added/players/player/@idThe ID of the player.
/most_added/players/player/current_periodPercentage of leagues that have the player on a roster for the upcoming week (updated several times a day), as an integer.
/most_added/players/player/diffThe percentage difference between the number of leagues that have the player on a roster for the upcoming week and the current week, as a positive or negative integer.
/most_added/players/player/firstnameThe first name of the player.
/most_added/players/player/fullnameThe full name of the player.
/most_added/players/player/last_periodThe percentage of leagues that have the player on a roster for this week, as an integer.
/most_added/players/player/lastnameThe last name of the player.
/most_added/players/player/on_waiversA boolean to denote if a player is on waivers in a fantasy league or no.
/most_added/players/player/positionAn abbreviation for the primary position of the player.
/most_added/players/player/pro_statusSpecifies the roster status of the player on the player’s pro team.
/most_added/players/player/pro_teamAn abbreviation for the player’s pro team.
/most_added/players/player/profile_linkA snippet of HTML code containing a link to the player’s profile.
/most_added/players/player/profile_urlThe absolute URL for the CBSSports.com profile for a player.
/most_added/players/player/iconsA container element for the player’s update and injury icons.
/most_added/players/player/icons/headlineThe headline of the player’s latest news update.
/most_added/players/player/bye_weekA number to denote the bye-week for a pro team (only applicable to football).
/most_added/players/player/is_lockedA 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).
/most_added/players/player/opponentPlayer’s opponent (only available for football).
/most_added/players/player/icons/injuryIf the player is injured, this field will exist and indicate the injury in the format: {injury}: {expected time of return}.

Resource

Most Added

Description

A list of the pro players who have been added most often within a fantasy league.  The list is in order, with the most added at the top.

Player information includes the player’s name, ID, pro team, position, roster status, number of times added, and a link to their profile.

HTTP Methods

GET

Retrieve a list of most-added players.

URL

http://api.cbssports.com/fantasy/players/roster-trends/most-added?version=2.0

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.
position(optional, can only be used in league context) - Limits the players returned to ones that are eligible at the specified position
player_status(optional, can only be used in league context) - Limits the players returned to ones that match the player_status (defaults to all, other valid values are free_agents and owned)
limit(optional) Return only this number of players.

Example

Get the four most added players

Sample URL

http://api.cbssports.com/fantasy/players/roster-trends/most-added?version=2.0&limit=4

XML Response

<?xml version="1.0"?>
<result uriAlias="/players/roster-trends/most-added" uri="/players/roster-trends/most-added" statusCode="200" statusMessage="OK">
  <body>
    <most_added>
      <players>
        <player id="1660445">
          <firstname>Gordon</firstname>
          <current_period>73</current_period>
          <on_waivers>0</on_waivers>
          <position>2B</position>
          <lastname>Beckham</lastname>
          <pro_status>A</pro_status>
          <profile_url>http://<league_id>.baseball.cbssports.com/players/playerpage/1660445</profile_url>
          <diff>28</diff>
          <fullname>Gordon Beckham</fullname>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1660445'&gt;Beckham, Gordon&lt;/a&gt; 2B CHW</profile_link>
          <last_period>45</last_period>
          <pro_team>CHW</pro_team>
        </player>
        <player id="1663024">
          <firstname>Wilin</firstname>
          <current_period>50</current_period>
          <on_waivers>0</on_waivers>
          <position>C</position>
          <icons>
            <headline>Rosario hits another one out</headline>
          </icons>
          <lastname>Rosario</lastname>
          <pro_status>A</pro_status>
          <profile_url>http://<league_id>.baseball.cbssports.com/players/playerpage/1663024</profile_url>
          <diff>21</diff>
          <fullname>Wilin Rosario</fullname>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1663024'&gt;Rosario, Wilin&lt;/a&gt; C COL &lt;span title="Rosario hits another one out"&gt;&lt;a href="http://<league_id>.baseball.cbssports.com/players/playerpage/1663024" class="playerLink" subtab="Update"&gt;&lt;img border="0" width="7" height="7" src="http://sports.cbsimg.net/images/news-note-hot.gif"/&gt;&lt;/a&gt;&lt;/span&gt;&lt;img src='http://sports.cbsimg.net/images/spacer.gif' height=1 width=2&gt;&lt;span title="Rosario's RBI single"&gt;&lt;a href="javascript:openPopup('/media/game-day/video?player_id=501647','mlbvideo', 990, 750);"&gt;&lt;img src="http://sports.cbsimg.net/images/video.gif" border="0"&gt;&lt;/a&gt;&lt;/span&gt;</profile_link>
          <last_period>29</last_period>
          <pro_team>COL</pro_team>
        </player>
        <player id="1390885">
          <firstname>Ernesto</firstname>
          <current_period>66</current_period>
          <on_waivers>0</on_waivers>
          <position>RP</position>
          <lastname>Frieri</lastname>
          <pro_status>A</pro_status>
          <profile_url>http://<league_id>.baseball.cbssports.com/players/playerpage/1390885</profile_url>
          <diff>17</diff>
          <fullname>Ernesto Frieri</fullname>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1390885'&gt;Frieri, Ernesto&lt;/a&gt; RP LAA</profile_link>
          <last_period>49</last_period>
          <pro_team>LAA</pro_team>
        </player>
        <player id="1208709">
          <firstname>Dexter</firstname>
          <current_period>90</current_period>
          <on_waivers>0</on_waivers>
          <position>CF</position>
          <icons>
            <headline>Fowler finally meeting expectations</headline>
          </icons>
          <lastname>Fowler</lastname>
          <pro_status>A</pro_status>
          <profile_url>http://<league_id>.baseball.cbssports.com/players/playerpage/1208709</profile_url>
          <diff>17</diff>
          <fullname>Dexter Fowler</fullname>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1208709'&gt;Fowler, Dexter&lt;/a&gt; CF COL &lt;span title="Fowler finally meeting expectations"&gt;&lt;a href="http://<league_id>.baseball.cbssports.com/players/playerpage/1208709" class="playerLink" subtab="Update"&gt;&lt;img border="0" width="7" height="7" src="http://sports.cbsimg.net/images/news-note-hot.gif"/&gt;&lt;/a&gt;&lt;/span&gt;</profile_link>
          <last_period>73</last_period>
          <pro_team>COL</pro_team>
        </player>
      </players>
    </most_added>
  </body>
</result>

JSON Response

{
   "body" : {
      "most_added" : {
         "players" : [
            {
               "firstname" : "Gordon",
               "current_period" : 73,
               "on_waivers" : 0,
               "position" : "2B",
               "lastname" : "Beckham",
               "pro_status" : "A",
               "profile_url" : "http://<league_id>.baseball.cbssports.com/players/playerpage/1660445",
               "diff" : 28,
               "fullname" : "Gordon Beckham",
               "id" : "1660445",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1660445'>Beckham, Gordon</a> 2B CHW",
               "last_period" : 45,
               "pro_team" : "CHW"
            },
            {
               "firstname" : "Wilin",
               "current_period" : 50,
               "on_waivers" : 0,
               "position" : "C",
               "icons" : {
                  "headline" : "Rosario hits another one out"
               },
               "lastname" : "Rosario",
               "pro_status" : "A",
               "profile_url" : "http://<league_id>.baseball.cbssports.com/players/playerpage/1663024",
               "diff" : 21,
               "fullname" : "Wilin Rosario",
               "id" : "1663024",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1663024'>Rosario, Wilin</a> C COL <span title=\"Rosario hits another one out\"><a href=\"http://<league_id>.baseball.cbssports.com/players/playerpage/1663024\" class=\"playerLink\" subtab=\"Update\"><img border=\"0\" width=\"7\" height=\"7\" src=\"http://sports.cbsimg.net/images/news-note-hot.gif\"/></a></span><img src='http://sports.cbsimg.net/images/spacer.gif' height=1 width=2><span title=\"Rosario's RBI single\"><a href=\"javascript:openPopup('/media/game-day/video?player_id=501647','mlbvideo', 990, 750);\"><img src=\"http://sports.cbsimg.net/images/video.gif\" border=\"0\"></a></span>",
               "last_period" : 29,
               "pro_team" : "COL"
            },
            {
               "firstname" : "Ernesto",
               "current_period" : 66,
               "on_waivers" : 0,
               "position" : "RP",
               "lastname" : "Frieri",
               "pro_status" : "A",
               "profile_url" : "http://<league_id>.baseball.cbssports.com/players/playerpage/1390885",
               "diff" : 17,
               "fullname" : "Ernesto Frieri",
               "id" : "1390885",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1390885'>Frieri, Ernesto</a> RP LAA",
               "last_period" : 49,
               "pro_team" : "LAA"
            },
            {
               "firstname" : "Dexter",
               "current_period" : 90,
               "on_waivers" : 0,
               "position" : "CF",
               "icons" : {
                  "headline" : "Fowler finally meeting expectations"
               },
               "lastname" : "Fowler",
               "pro_status" : "A",
               "profile_url" : "http://<league_id>.baseball.cbssports.com/players/playerpage/1208709",
               "diff" : 17,
               "fullname" : "Dexter Fowler",
               "id" : "1208709",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.baseball.cbssports.com/players/playerpage/1208709'>Fowler, Dexter</a> CF COL <span title=\"Fowler finally meeting expectations\"><a href=\"http://<league_id>.baseball.cbssports.com/players/playerpage/1208709\" class=\"playerLink\" subtab=\"Update\"><img border=\"0\" width=\"7\" height=\"7\" src=\"http://sports.cbsimg.net/images/news-note-hot.gif\"/></a></span>",
               "last_period" : 73,
               "pro_team" : "COL"
            }
         ]
      }
   },
   "uriAlias" : "/players/roster-trends/most-added",
   "statusMessage" : "OK",
   "uri" : "/players/roster-trends/most-added",
   "statusCode" : 200
}

Sample URL

http://api.cbssports.com/fantasy/players/roster-trends/most-added?version=2.0&limit=4

XML Response

<?xml version="1.0"?>
<result uriAlias="/players/roster-trends/most-added" uri="/players/roster-trends/most-added" statusCode="200" statusMessage="OK">
  <body>
    <most_added>
      <players>
        <player id="407">
          <bye_week>6</bye_week>
          <firstname/>
          <current_period>54</current_period>
          <on_waivers>1</on_waivers>
          <position>DST</position>
          <lastname>Saints</lastname>
          <is_locked>0</is_locked>
          <opponent>WAS</opponent>
          <pro_status/>
          <profile_url>http://<league_id>.football.cbssports.com/players/playerpage/407</profile_url>
          <diff>1</diff>
          <fullname>Saints</fullname>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/407'&gt;Saints&lt;/a&gt; DST NO</profile_link>
          <last_period>53</last_period>
          <pro_team>NO</pro_team>
        </player>
        <player id="1123691">
          <firstname>DeMarco</firstname>
          <current_period>75</current_period>
          <on_waivers>1</on_waivers>
          <position>RB</position>
          <icons>
            <injury>Ankle: Probable for start of training camp</injury>
            <headline>Murray cleared to practice</headline>
          </icons>
          <lastname>Murray</lastname>
          <is_locked>0</is_locked>
          <opponent>@NYG</opponent>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/1123691'&gt;Murray, DeMarco&lt;/a&gt; RB DAL &lt;span title="Murray cleared to practice"&gt;&lt;a href="http://<league_id>.football.cbssports.com/players/playerpage/1123691" class="playerLink" subtab="Update"&gt;&lt;img border="0" width="7" height="7" src="http://sports.cbsimg.net/images/news-note-hot.gif"/&gt;&lt;/a&gt;&lt;/span&gt;&lt;img src='http://sports.cbsimg.net/images/spacer.gif' height=1 width=2&gt;&lt;span title="Ankle: Probable for start of training camp"&gt;&lt;a href="http://<league_id>.football.cbssports.com/players/playerpage/1123691" subtab="Injury Report" class="playerLink"&gt;&lt;img border="0" width="7" height="7" src="http://sports.cbsimg.net/images/red_cross.gif"/&gt;&lt;/a&gt;&lt;/span&gt;</profile_link>
          <bye_week>5</bye_week>
          <pro_status>A</pro_status>
          <profile_url>http://<league_id>.football.cbssports.com/players/playerpage/1123691</profile_url>
          <fullname>DeMarco Murray</fullname>
          <diff>1</diff>
          <last_period>74</last_period>
          <pro_team>DAL</pro_team>
        </player>
        <player id="302211">
          <bye_week>5</bye_week>
          <firstname>Maurice</firstname>
          <current_period>73</current_period>
          <on_waivers>1</on_waivers>
          <position>RB</position>
          <lastname>Morris</lastname>
          <is_locked>0</is_locked>
          <opponent>STL</opponent>
          <pro_status>A</pro_status>
          <profile_url>http://<league_id>.football.cbssports.com/players/playerpage/302211</profile_url>
          <diff>1</diff>
          <fullname>Maurice Morris</fullname>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/302211'&gt;Morris, Maurice&lt;/a&gt; RB DET </profile_link>
          <last_period>72</last_period>
          <pro_team>DET</pro_team>
        </player>
        <player id="396159">
          <bye_week>10</bye_week>
          <firstname>Rex</firstname>
          <current_period>41</current_period>
          <on_waivers>1</on_waivers>
          <position>QB</position>
          <lastname>Grossman</lastname>
          <is_locked>0</is_locked>
          <opponent>@NO</opponent>
          <pro_status>A</pro_status>
          <profile_url>http://<league_id>.football.cbssports.com/players/playerpage/396159</profile_url>
          <diff>1</diff>
          <fullname>Rex Grossman</fullname>
          <profile_link>&lt;a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/396159'&gt;Grossman, Rex&lt;/a&gt; QB WAS</profile_link>
          <last_period>40</last_period>
          <pro_team>WAS</pro_team>
        </player>
      </players>
    </most_added>
  </body>
</result>

JSON Response

{
   "body" : {
      "most_added" : {
         "players" : [
            {
               "bye_week" : "6",
               "firstname" : "",
               "current_period" : 54,
               "on_waivers" : 1,
               "position" : "DST",
               "lastname" : "Saints",
               "is_locked" : 0,
               "opponent" : "WAS",
               "pro_status" : null,
               "profile_url" : "http://<league_id>.football.cbssports.com/players/playerpage/407",
               "diff" : 1,
               "fullname" : "Saints",
               "id" : "407",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/407'>Saints</a> DST NO",
               "last_period" : 53,
               "pro_team" : "NO"
            },
            {
               "firstname" : "DeMarco",
               "current_period" : 75,
               "on_waivers" : 1,
               "position" : "RB",
               "icons" : {
                  "injury" : "Ankle: Probable for start of training camp",
                  "headline" : "Murray cleared to practice"
               },
               "lastname" : "Murray",
               "is_locked" : 0,
               "opponent" : "@NYG",
               "id" : "1123691",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/1123691'>Murray, DeMarco</a> RB DAL <span title=\"Murray cleared to practice\"><a href=\"http://<league_id>.football.cbssports.com/players/playerpage/1123691\" class=\"playerLink\" subtab=\"Update\"><img border=\"0\" width=\"7\" height=\"7\" src=\"http://sports.cbsimg.net/images/news-note-hot.gif\"/></a></span><img src='http://sports.cbsimg.net/images/spacer.gif' height=1 width=2><span title=\"Ankle: Probable for start of training camp\"><a href=\"http://<league_id>.football.cbssports.com/players/playerpage/1123691\" 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" : "5",
               "pro_status" : "A",
               "profile_url" : "http://<league_id>.football.cbssports.com/players/playerpage/1123691",
               "fullname" : "DeMarco Murray",
               "diff" : 1,
               "last_period" : 74,
               "pro_team" : "DAL"
            },
            {
               "bye_week" : "5",
               "firstname" : "Maurice",
               "current_period" : 73,
               "on_waivers" : 1,
               "position" : "RB",
               "lastname" : "Morris",
               "is_locked" : 0,
               "opponent" : "STL",
               "pro_status" : "A",
               "profile_url" : "http://<league_id>.football.cbssports.com/players/playerpage/302211",
               "diff" : 1,
               "fullname" : "Maurice Morris",
               "id" : "302211",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/302211'>Morris, Maurice</a> RB DET ",
               "last_period" : 72,
               "pro_team" : "DET"
            },
            {
               "bye_week" : "10",
               "firstname" : "Rex",
               "current_period" : 41,
               "on_waivers" : 1,
               "position" : "QB",
               "lastname" : "Grossman",
               "is_locked" : 0,
               "opponent" : "@NO",
               "pro_status" : "A",
               "profile_url" : "http://<league_id>.football.cbssports.com/players/playerpage/396159",
               "diff" : 1,
               "fullname" : "Rex Grossman",
               "id" : "396159",
               "profile_link" : "<a class='playerLink' href='http://<league_id>.football.cbssports.com/players/playerpage/396159'>Grossman, Rex</a> QB WAS",
               "last_period" : 40,
               "pro_team" : "WAS"
            }
         ]
      }
   },
   "uriAlias" : "/players/roster-trends/most-added",
   "statusMessage" : "OK",
   "uri" : "/players/roster-trends/most-added",
   "statusCode" : 200
}

XML field definitions

/most_added

A container element for the most added players.

/most_added/players

A container element for the list of players.

/most_added/players/player

Container element for a player in the list of most added players.

/most_added/players/player/@id

The ID of the player.  You can use this ID to get more information about the player by requesting the Player Outlook resource or the Player Updates resource.

/most_added/players/player/current_period

Percentage of leagues that have the player on a roster for the upcoming week (updated several times a day), as an integer.

/most_added/players/player/diff

The percentage difference between the number of leagues that have the player on a roster for the upcoming week and the current week, as a positive or negative integer.  This value is equivalent to the value obtained by subtracting /most_added/players/player/last_period from /most_added/players/player/current_period.

/most_added/players/player/firstname

The first name of the player.

/most_added/players/player/fullname

The full name of the player.  The value is equivlent to the values of /most_added/players/player/firstname and /most_added/players/player/lastname joined with a space.

/most_added/players/player/last_period

The percentage of leagues that have the player on a roster for this week, as an integer.

/most_added/players/player/lastname

The last name of the player.

/most_added/players/player/on_waivers

A boolean to denote if a player is on waivers in a fantasy league or no.

/most_added/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.

/most_added/players/player/pro_status

Specifies the roster status of the player on the player’s pro team.  Possible values are A (Active), M (Minors), U (Unaffiliated), N (Not With Team), DL (Disabled List), and S (Suspended).

/most_added/players/player/pro_team

An abbreviation for the player’s pro team.

/most_added/players/player/profile_link

A snippet of HTML code containing a link to the player’s profile.

/most_added/players/player/profile_url

The absolute URL for the CBSSports.com profile for a player.  This URL should be used to link to the page outside of the iframe in which your app resides.

/most_added/players/player/icons

A container element for the player’s update and injury icons.

/most_added/players/player/icons/headline

The headline of the player’s latest news update.

/most_added/players/player/bye_week

A number to denote the bye-week for a pro team (only applicable to football).

/most_added/players/player/is_locked

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).

/most_added/players/player/opponent

Player’s opponent (only available for football).

/most_added/players/player/icons/injury

If the player is injured, this field will exist and indicate the injury in the format: {injury}: {expected time of return}.

The percentage of leagues that have the player on a roster for this week, as an integer.
Percentage of leagues that have the player on a roster for the upcoming week (updated several times a day), as an integer.
The first name of the player.
The last name of the player.