Logo
Twitter API Documentation

Full-archive Tweet counts

GET https://api.twitter.com/2/tweets/counts/all?query=

Search across the complete history of public Tweets matching a search query; since the first Tweet was created in March 2006.

For full details, see the API reference for this endpoint.

NOTE this endpoint requires access via the Academic Research product track

 

Body PARAM

Key Datatype Required Description 
query
null Required. Query for matching Tweets. Up to 1024 characters.
start_time
null The oldest UTC timestamp from which the Tweets will be provided. YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339).
end_time
null The newest, most recent UTC timestamp to which the Tweets will be provided. YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339).
since_id
null Returns results with a Tweet ID greater than (that is, more recent than) the specified ID. The ID specified is exclusive and responses will not include it.
until_id
null Returns results with a Tweet ID less than (that is, older than) the specified ID. The ID specified is exclusive and responses will not include it.
next_token
null This parameter is used to get the next 'page' of results. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified.
granularity
null This is the granularity that you want the timeseries count data to be grouped by. Possible values are day, hour or minute. The default granularity, if not specified is hour.



HEADERS

Key Datatype Required Description 




RESPONSES

status





Curl
curl -X GET 'https://api.twitter.com/2/tweets/counts/all?query=?query=&start_time=&end_time=&since_id=&until_id=&next_token=&granularity='

ENDPOINTS