stats
A query to this endpoint with a valid type and stat parameter will return a table of statistics, in descending ranking order. Results can be filtered by season, sublevel, team or player, with an option of placing a limit on qualifiers only for player stats. Player and team stats and rankings are re-tabulated at approximately 3 am ET every night during the season.
Please note that this endpoint can be used synonymously as stat.
MBB Teams Free Throws Attempted
https://api.natstat.com/v1/stats/MBB/team/?key=XXXX-XXXXXX&format=xml&stat=FTA
Download sample
Parameters
Path
| Name | Required | Type | Description |
|---|---|---|---|
optional |
optional | string | Limit results to =player or =team |
level |
required | string | The competition level to retrieve information for. A full glossary can be found in the Path Parameters section |
Response
| Name | Required | Type | Description |
|---|---|---|---|
Stat |
string | The name of the statistic | |
StatName |
string | The name of the statistic | |
Season |
number | The seasons ID of the season, in YYYY format | |
Team |
string | The teams name of the relevant team | |
Team_ID |
number | The teams ID of the relevant team | |
Team_Abbrev |
string | The teams abbreviation of the relevant team | |
Sublevel |
string | The teams sublevel of the team, e.g A or AAA | |
Value |
string | The number or text string containing the statistical value | |
Ranking |
number | The ranking of the team or player | |
RankingOf |
number | The contextual number of teams or players | |
LastUpdated |
date | The last updated date of this record |
Query
| Name | Required | Type | Description |
|---|---|---|---|
key |
required | string | A valid API key in XXXX-XXXXXX format |
format |
optional | string | The preferred data format: xml, json or php (presented as a SimpleXML object). The default is json |
max |
optional | number | The number of results per page to return. The default value is 100, and the maximum allowed parameter value is 1000. This value is echoed back as Max_Results in the meta block |
page |
optional | number | The pagination page number. This value is echoed back as Page in the meta block. The meta block also contains the Total_Results of the query. If there are further results, a fully-formed Next_Page URI containing a pre-filled &page=X value will be returned |
stat |
required | string | A valid stat type code. A list of codes can be retrieved from the glossary endpoint |
limit |
optional | string | The only valid value for this filter is =qualifiers, when used with the player type |
sublevel |
optional | string | A valid sublevel (leagues, conferences) ID code. A list of sublevels can be retrieved from the glossary endpoint |
team |
optional | number | A valid team ID code. A list of teams can be retrieved from the teams endpoint |
season |
optional | number | A valid season ID code, formatted as the year that a season completes, in YYYY format. A list of available seasons can be retrieved from the seasons endpoint. The default value is the current season |
player |
optional | string | A valid player ID code. A list of teams can be retrieved from the players endpoint |