A query to this endpoint will return all Twitter posts in reverse chronological order of last post. Results can be filtered by team, limit (team accounts only) and search. Results can be filtered by date or date range (start-end; last).
The competition level to retrieve information for. A full glossary can be found in the Path Parameters section
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
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 tweets 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
Name
Required
Type
Description
Video_URL
string
The direct URL of the video
Video_Type
string
The format of the video content
Post_Text
node
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
Tweet_ID
number
The Twitter ID of the relevant tweet
Post
string
The text of the relevant post
Game_ID
string
The games id if applicable
Game_Text
string
The game matchup if applicable
Post_URL
string
The full URL of the relevant post
Media_URL
string
The URL of the piece of media attached to the tweet
