Scoring Categories v2.0

Summary
Scoring Categories
Resource
Scoring CategoriesA list of categories a fantasy league uses in its scoring system.
HTTP Methods
GETRetrieve all scoring categories
Example
Retrieve All Scoring Categories
XML field definitions
/categoriesA container element for the list of scoring categories.
/categories/groupsA container element for a list of groups.
/categories/groups/groupA container element for a group of statistics in a particular category.
/categories/groups/group/catsA container element for the list of categories in this group.
/categories/groups/group/cats/catA container element for the data on a category.
/categories/groups/group/cats/cat/abbrAn abbreviation for the category.
/categories/groups/group/cats/cat/descThe name of the category.
/categories/groups/group/cats/cat/formulaThe formula for the category if it is derived from other categories.
/categories/groups/group/cats/cat/pct_useThe percentage of CBSSports.com leagues that use this category as part of their scoring system.
/categories/groups/group/cats/cat/scores_liveSpecifies whether the category is updated live as part of the Fantasy Live Scoring API.
/categories/groups/group/cats/cat/typeThe type of the stats category.
/categories/groups/group/nameThe name of a statistics group.
/categories/groups/group/typeThe type of a statistics group.

Resource

Scoring Categories

Description

A list of categories a fantasy league uses in its scoring system.

Categories are arranged into groups.  There are two groups in Baseball (Batting and Pitching).

HTTP Methods

GET

Retrieve all scoring categories

URL

http://api.cbssports.com/fantasy/league/scoring/categories?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.

Example

Retrieve All Scoring Categories

Sample URL

http://api.cbssports.com/fantasy/league/scoring/categories?version=2.0

XML Response

<?xml version="1.0"?>
<result uriAlias="/league/scoring/categories" uri="/league/scoring/categories" statusCode="200" statusMessage="OK">
  <body>
    <categories>
      <groups>
        <group>
          <cats>
            <cat>
              <pct_use> 51</pct_use>
              <abbr>BA</abbr>
              <formula>H / AB</formula>
              <scores_live>Yes</scores_live>
              <desc>Batting Average</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 98</pct_use>
              <abbr>HR</abbr>
              <scores_live>Yes</scores_live>
              <desc>Home Runs</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 86</pct_use>
              <abbr>R</abbr>
              <scores_live>Yes</scores_live>
              <desc>Runs</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 99</pct_use>
              <abbr>RBI</abbr>
              <scores_live>Yes</scores_live>
              <desc>Runs Batted In</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 97</pct_use>
              <abbr>SB</abbr>
              <scores_live>Yes</scores_live>
              <desc>Stolen Bases</desc>
              <type>good</type>
            </cat>
          </cats>
          <name>Batting</name>
          <type>ocats</type>
        </group>
        <group>
          <cats>
            <cat>
              <pct_use> 55</pct_use>
              <abbr>ERA</abbr>
              <formula>ER * 9 / INN</formula>
              <scores_live>Yes</scores_live>
              <desc>Earned Run Average</desc>
              <type>bad</type>
            </cat>
            <cat>
              <pct_use> 85</pct_use>
              <abbr>K</abbr>
              <scores_live>Yes</scores_live>
              <desc>Strikeouts (Pitcher)</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 96</pct_use>
              <abbr>S</abbr>
              <scores_live>Yes</scores_live>
              <desc>Saves</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 95</pct_use>
              <abbr>W</abbr>
              <scores_live>Yes</scores_live>
              <desc>Wins</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 52</pct_use>
              <abbr>WHIP</abbr>
              <formula>(BBI + HA) / INN</formula>
              <scores_live>Yes</scores_live>
              <desc>Walks + Hits / Inning</desc>
              <type>bad</type>
            </cat>
          </cats>
          <name>Pitching</name>
          <type>dcats</type>
        </group>
      </groups>
    </categories>
  </body>
</result>

JSON Response

{
   "body" : {
      "categories" : {
         "groups" : [
            {
               "cats" : [
                  {
                     "pct_use" : " 51",
                     "abbr" : "BA",
                     "formula" : "H / AB",
                     "scores_live" : "Yes",
                     "desc" : "Batting Average",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 98",
                     "abbr" : "HR",
                     "scores_live" : "Yes",
                     "desc" : "Home Runs",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 86",
                     "abbr" : "R",
                     "scores_live" : "Yes",
                     "desc" : "Runs",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 99",
                     "abbr" : "RBI",
                     "scores_live" : "Yes",
                     "desc" : "Runs Batted In",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 97",
                     "abbr" : "SB",
                     "scores_live" : "Yes",
                     "desc" : "Stolen Bases",
                     "type" : "good"
                  }
               ],
               "name" : "Batting",
               "type" : "ocats"
            },
            {
               "cats" : [
                  {
                     "pct_use" : " 55",
                     "abbr" : "ERA",
                     "formula" : "ER * 9 / INN",
                     "scores_live" : "Yes",
                     "desc" : "Earned Run Average",
                     "type" : "bad"
                  },
                  {
                     "pct_use" : " 85",
                     "abbr" : "K",
                     "scores_live" : "Yes",
                     "desc" : "Strikeouts (Pitcher)",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 96",
                     "abbr" : "S",
                     "scores_live" : "Yes",
                     "desc" : "Saves",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 95",
                     "abbr" : "W",
                     "scores_live" : "Yes",
                     "desc" : "Wins",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 52",
                     "abbr" : "WHIP",
                     "formula" : "(BBI + HA) / INN",
                     "scores_live" : "Yes",
                     "desc" : "Walks + Hits / Inning",
                     "type" : "bad"
                  }
               ],
               "name" : "Pitching",
               "type" : "dcats"
            }
         ]
      }
   },
   "uriAlias" : "/league/scoring/categories",
   "statusMessage" : "OK",
   "uri" : "/league/scoring/categories",
   "statusCode" : 200
}

Sample URL

http://api.cbssports.com/fantasy/league/scoring/categories?version=2.0

XML Response

<?xml version="1.0"?>
<result uriAlias="/league/scoring/categories" uri="/league/scoring/categories" statusCode="200" statusMessage="OK">
  <body>
    <categories>
      <groups>
        <group>
          <cats>
            <cat>
              <pct_use>100</pct_use>
              <abbr>FG</abbr>
              <scores_live>Yes</scores_live>
              <desc>Field Goals</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 65</pct_use>
              <abbr>FL</abbr>
              <scores_live>Yes</scores_live>
              <desc>Fumble Lost, Including ST plays</desc>
              <type>bad</type>
            </cat>
            <cat>
              <pct_use> 24</pct_use>
              <abbr>MFG</abbr>
              <formula>FGA - FG</formula>
              <scores_live>Yes</scores_live>
              <desc>Missed Field Goal</desc>
              <type>bad</type>
            </cat>
            <cat>
              <pct_use> 19</pct_use>
              <abbr>MXP</abbr>
              <formula>XPAtt - XP</formula>
              <scores_live>Yes</scores_live>
              <desc>Missed Extra Point</desc>
              <type>bad</type>
            </cat>
            <cat>
              <pct_use> 97</pct_use>
              <abbr>Pa2P</abbr>
              <scores_live>Yes</scores_live>
              <desc>Passing Two-point Conversion</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 77</pct_use>
              <abbr>PaInt</abbr>
              <scores_live>Yes</scores_live>
              <desc>Passing Interception</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use>100</pct_use>
              <abbr>PaTD</abbr>
              <scores_live>Yes</scores_live>
              <desc>Passing TD</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 93</pct_use>
              <abbr>PaYd</abbr>
              <scores_live>Yes</scores_live>
              <desc>Passing Yards</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 97</pct_use>
              <abbr>Re2P</abbr>
              <scores_live>Yes</scores_live>
              <desc>Receiving Two-point Conversion</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use>100</pct_use>
              <abbr>ReTD</abbr>
              <scores_live>Yes</scores_live>
              <desc>Receiving TD</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 87</pct_use>
              <abbr>ReYd</abbr>
              <scores_live>Yes</scores_live>
              <desc>Receiving Yards</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 28</pct_use>
              <abbr>Recpt</abbr>
              <scores_live>Yes</scores_live>
              <desc>Reception</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 97</pct_use>
              <abbr>Ru2P</abbr>
              <scores_live>Yes</scores_live>
              <desc>Rushing Two-point Conversion</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use>100</pct_use>
              <abbr>RuTD</abbr>
              <scores_live>Yes</scores_live>
              <desc>Rushing TD</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 87</pct_use>
              <abbr>RuYd</abbr>
              <scores_live>Yes</scores_live>
              <desc>Rushing Yards</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 99</pct_use>
              <abbr>XP</abbr>
              <scores_live>Yes</scores_live>
              <desc>Extra Points</desc>
              <type>good</type>
            </cat>
          </cats>
          <name>Offensive</name>
          <type>ocats</type>
        </group>
        <group>
          <cats>
            <cat>
              <pct_use> 23</pct_use>
              <abbr>BFB</abbr>
              <scores_live>Yes</scores_live>
              <desc>Blocked Field Goals (ID/ST/DST)</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 22</pct_use>
              <abbr>BP</abbr>
              <scores_live>Yes</scores_live>
              <desc>Blocked Punts (ID/ST/DST)</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 90</pct_use>
              <abbr>DFR</abbr>
              <scores_live>Yes</scores_live>
              <desc>Defensive/ST Fumble Recovered (ID/DT/DST)</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use>  5</pct_use>
              <abbr>DSTPA</abbr>
              <scores_live>Yes</scores_live>
              <desc>Points Against Defense/ST</desc>
              <type>bad</type>
            </cat>
            <cat>
              <pct_use> 94</pct_use>
              <abbr>DTD</abbr>
              <formula>IntTD + PRTD + KRTD + DFRTD + BFTD + BPTD + SFRTD</formula>
              <scores_live>Yes</scores_live>
              <desc>Total Defensive and Special Teams TD</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 93</pct_use>
              <abbr>Int</abbr>
              <scores_live>Yes</scores_live>
              <desc>Interceptions</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 93</pct_use>
              <abbr>SACK</abbr>
              <scores_live>Yes</scores_live>
              <desc>Sack</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 96</pct_use>
              <abbr>STY</abbr>
              <scores_live>Yes</scores_live>
              <desc>Safety</desc>
              <type>good</type>
            </cat>
            <cat>
              <pct_use> 49</pct_use>
              <abbr>YDS</abbr>
              <formula>PaNetA + RuYdA</formula>
              <scores_live>Yes</scores_live>
              <desc>Yards Allowed</desc>
              <type>bad</type>
            </cat>
          </cats>
          <name>Defensive</name>
          <type>dcats</type>
        </group>
      </groups>
    </categories>
  </body>
</result>

JSON Response

{
   "body" : {
      "categories" : {
         "groups" : [
            {
               "cats" : [
                  {
                     "pct_use" : 100,
                     "abbr" : "FG",
                     "scores_live" : "Yes",
                     "desc" : "Field Goals",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 65",
                     "abbr" : "FL",
                     "scores_live" : "Yes",
                     "desc" : "Fumble Lost, Including ST plays",
                     "type" : "bad"
                  },
                  {
                     "pct_use" : " 24",
                     "abbr" : "MFG",
                     "formula" : "FGA - FG",
                     "scores_live" : "Yes",
                     "desc" : "Missed Field Goal",
                     "type" : "bad"
                  },
                  {
                     "pct_use" : " 19",
                     "abbr" : "MXP",
                     "formula" : "XPAtt - XP",
                     "scores_live" : "Yes",
                     "desc" : "Missed Extra Point",
                     "type" : "bad"
                  },
                  {
                     "pct_use" : " 97",
                     "abbr" : "Pa2P",
                     "scores_live" : "Yes",
                     "desc" : "Passing Two-point Conversion",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 77",
                     "abbr" : "PaInt",
                     "scores_live" : "Yes",
                     "desc" : "Passing Interception",
                     "type" : "good"
                  },
                  {
                     "pct_use" : 100,
                     "abbr" : "PaTD",
                     "scores_live" : "Yes",
                     "desc" : "Passing TD",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 93",
                     "abbr" : "PaYd",
                     "scores_live" : "Yes",
                     "desc" : "Passing Yards",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 97",
                     "abbr" : "Re2P",
                     "scores_live" : "Yes",
                     "desc" : "Receiving Two-point Conversion",
                     "type" : "good"
                  },
                  {
                     "pct_use" : 100,
                     "abbr" : "ReTD",
                     "scores_live" : "Yes",
                     "desc" : "Receiving TD",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 87",
                     "abbr" : "ReYd",
                     "scores_live" : "Yes",
                     "desc" : "Receiving Yards",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 28",
                     "abbr" : "Recpt",
                     "scores_live" : "Yes",
                     "desc" : "Reception",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 97",
                     "abbr" : "Ru2P",
                     "scores_live" : "Yes",
                     "desc" : "Rushing Two-point Conversion",
                     "type" : "good"
                  },
                  {
                     "pct_use" : 100,
                     "abbr" : "RuTD",
                     "scores_live" : "Yes",
                     "desc" : "Rushing TD",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 87",
                     "abbr" : "RuYd",
                     "scores_live" : "Yes",
                     "desc" : "Rushing Yards",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 99",
                     "abbr" : "XP",
                     "scores_live" : "Yes",
                     "desc" : "Extra Points",
                     "type" : "good"
                  }
               ],
               "name" : "Offensive",
               "type" : "ocats"
            },
            {
               "cats" : [
                  {
                     "pct_use" : " 23",
                     "abbr" : "BFB",
                     "scores_live" : "Yes",
                     "desc" : "Blocked Field Goals (ID/ST/DST)",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 22",
                     "abbr" : "BP",
                     "scores_live" : "Yes",
                     "desc" : "Blocked Punts (ID/ST/DST)",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 90",
                     "abbr" : "DFR",
                     "scores_live" : "Yes",
                     "desc" : "Defensive/ST Fumble Recovered (ID/DT/DST)",
                     "type" : "good"
                  },
                  {
                     "pct_use" : "  5",
                     "abbr" : "DSTPA",
                     "scores_live" : "Yes",
                     "desc" : "Points Against Defense/ST",
                     "type" : "bad"
                  },
                  {
                     "pct_use" : " 94",
                     "abbr" : "DTD",
                     "formula" : "IntTD + PRTD + KRTD + DFRTD + BFTD + BPTD + SFRTD",
                     "scores_live" : "Yes",
                     "desc" : "Total Defensive and Special Teams TD",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 93",
                     "abbr" : "Int",
                     "scores_live" : "Yes",
                     "desc" : "Interceptions",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 93",
                     "abbr" : "SACK",
                     "scores_live" : "Yes",
                     "desc" : "Sack",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 96",
                     "abbr" : "STY",
                     "scores_live" : "Yes",
                     "desc" : "Safety",
                     "type" : "good"
                  },
                  {
                     "pct_use" : " 49",
                     "abbr" : "YDS",
                     "formula" : "PaNetA + RuYdA",
                     "scores_live" : "Yes",
                     "desc" : "Yards Allowed",
                     "type" : "bad"
                  }
               ],
               "name" : "Defensive",
               "type" : "dcats"
            }
         ]
      }
   },
   "uriAlias" : "/league/scoring/categories",
   "statusMessage" : "OK",
   "uri" : "/league/scoring/categories",
   "statusCode" : 200
}

XML field definitions

/categories

A container element for the list of scoring categories.

/categories/groups

A container element for a list of groups.

/categories/groups/group

A container element for a group of statistics in a particular category.

/categories/groups/group/cats

A container element for the list of categories in this group.

/categories/groups/group/cats/cat

A container element for the data on a category.

/categories/groups/group/cats/cat/abbr

An abbreviation for the category.  You can get a list of stats category abbreviations by requesting the Stats Categories resource.

/categories/groups/group/cats/cat/desc

The name of the category.

/categories/groups/group/cats/cat/formula

The formula for the category if it is derived from other categories.

/categories/groups/group/cats/cat/pct_use

The percentage of CBSSports.com leagues that use this category as part of their scoring system.

/categories/groups/group/cats/cat/scores_live

Specifies whether the category is updated live as part of the Fantasy Live Scoring API.  Possible values are Yes (scores are updated live) or No (scores are updated at the end of the day).

/categories/groups/group/cats/cat/type

The type of the stats category.  Possible values are good and bad.  A good stat is one in which a higher number increases a player’s value (for instance, Wins).  A bad stat is one in which a higher number reduces a player’s value (for example, Earned Run Average).

/categories/groups/group/name

The name of a statistics group.

  • For baseball, the groups are Batting and Pitching.  For example, Saves is a statistic in the Pitching group.
  • For football, the groups are Offensive and Defensive.  For example, Passing TD is a statistic in the Offensive group.

/categories/groups/group/type

The type of a statistics group.  The value may be ocats (offensive categories) or dcats (defensive categories).