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

Sign up for the Twitter API

Request Params

KeyDatatypeRequiredDescription
querynullRequired. Query for matching Tweets. Up to 1024 characters.
start_timenullThe oldest UTC timestamp from which the Tweets will be provided. YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339).
end_timenullThe newest, most recent UTC timestamp to which the Tweets will be provided. YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339).
since_idnullReturns 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_idnullReturns 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_tokennullThis 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.
granularitynullThis 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.