API v2 Documentation

Endpoints Code Lookup

← All endpoints

videos

team,player All data services

A query to this endpoint will return all YouTube and Twitter videos in reverse chronological order of last post. Results can be filtered by search. Results can be filtered by date or date range (start-end; last).

WNBA New York Liberty Recent Videos
https://api.natstat.com/v2/videos/WNBA/?key=XXXX-XXXXXX&format=xml&team=974 Download sample

Parameters

Path

NameRequiredTypeDescription
level required string The competition level to retrieve information for. A full glossary can be found in the Path Parameters section

Query

NameRequiredTypeDescription
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
team optional number A valid team ID code. A list of teams can be retrieved from the teams endpoint
limit optional string The two valid values for this filter are =team and =player, to show only videos media accounts for either type
search optional string For general search of endpoint contents. Queries of four characters or less will be ignored
game optional number A valid game ID code. A list of games can be retrieved from the games endpoint
date optional string The date to limit matched results to. The API will attempt to translate the date, but YYYYMMDD or YYYY-MM-DD are preferred
start optional string The start date from which to include matched results (inclusive). The API will attempt to translate the date, but YYYYMMDD or YYYY-MM-DD are preferred
end optional string The end date to which to include matched results (inclusive). The API will attempt to translate the date, but YYYYMMDD or YYYY-MM-DD are preferred

Response

NameRequiredTypeDescription
Video_URL string The direct URL of the video
Video_Type string The format of the video content
Post_Text object The tweet content, for video context
Twitter_URL number The original tweet URL
Post_Time string The timestamp of the video post
Season_ID string The seasons id of the season
Source string The source of the post [team/player]
Team string The team name if applicable
Team_ID number The teams id if applicable
Game_ID string The games id if applicable
Game_Text string The game matchup if applicable