GET /2/tweets/counts/recent

The recent Tweet counts endpoint returns count of Tweets from the last seven days that match a query.

Endpoint URL

https://api.twitter.com/2/tweets/counts/recent

Authentication and rate limits

Authentication methods
supported by this endpoint

OAuth 2.0 App-only

Rate limit

App rate limit (OAuth 2.0 App Access Token): 300 requests per 15-minute window shared among all users of your app

Query parameters

NameTypeDescription
query
 Required 
stringOne query for matching Tweets. You can learn how to build this query by reading our build a query guide.

If you have Essential or Elevated access, you can use the Basic operators when building your query and can make queries up to 512 characters long. If you have been approved for Academic Research access, you can use all available operators and can make queries up to 1,024 characters long.

Learn more about our access levels on the about Twitter API page.
end_time
 Optional 
date (ISO 8601)YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). The newest, most recent UTC timestamp to which the Tweet counts will be provided. Timestamp is in second granularity and is exclusive (for example, 12:00:01 excludes the first second of the minute). By default, a request will return Tweet counts from as recent as 30 seconds ago if you do not include this parameter.
granularity
 Optional 
stringThis is the granularity that you want the timeseries count data to be grouped by. You can requeset minute, hour, or day granularity. The default granularity, if not specified is hour.
since_id
 Optional 
stringReturns 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. If included with the same request as a start_time parameter, only since_id will be used.
start_time
 Optional 
date (ISO 8601)YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). The oldest UTC timestamp (from most recent seven days) from which the Tweet counts will be provided. Timestamp is in second granularity and is inclusive (for example, 12:00:01 includes the first second of the minute). If included with the same request as a since_id parameter, only since_id will be used. By default, a request will return Tweet counts from up to seven days ago if you do not include this parameter.
until_id
 Optional 
stringReturns 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.


Example requests

      curl https://api.twitter.com/2/tweets/counts/recent?query=lakers -H "Authorization: Bearer $ACCESS_TOKEN"
    
      curl "https://api.twitter.com/2/tweets/counts/recent?query=lakers&granularity=day&start_time=2020-05-28T00%3A00%3A00Z&end_time=2020-06-01T00%3A00%3A00Z" -H "Authorization: Bearer $ACCESS_TOKEN"
    

Example responses

      {
  "data": [
    {
      "end": "2021-05-27T00:00:00.000Z",
      "start": "2021-05-26T23:00:00.000Z",
      "tweet_count": 345
    },
    {
      "end": "2021-05-27T01:00:00.000Z",
      "start": "2021-05-27T00:00:00.000Z",
      "tweet_count": 2183
    },
    {
      "end": "2021-05-27T02:00:00.000Z",
      "start": "2021-05-27T01:00:00.000Z",
      "tweet_count": 2168
    },
    {
      "end": "2021-05-27T03:00:00.000Z",
      "start": "2021-05-27T02:00:00.000Z",
      "tweet_count": 1973
    },
    {
      "end": "2021-05-27T04:00:00.000Z",
      "start": "2021-05-27T03:00:00.000Z",
      "tweet_count": 1575
    },
    {
      "end": "2021-05-27T05:00:00.000Z",
      "start": "2021-05-27T04:00:00.000Z",
      "tweet_count": 1348
    },
    {
      "end": "2021-05-27T06:00:00.000Z",
      "start": "2021-05-27T05:00:00.000Z",
      "tweet_count": 1086
    },
    {
      "end": "2021-05-27T07:00:00.000Z",
      "start": "2021-05-27T06:00:00.000Z",
      "tweet_count": 746
    },
    {
      "end": "2021-05-27T08:00:00.000Z",
      "start": "2021-05-27T07:00:00.000Z",
      "tweet_count": 627
    },
    {
      "end": "2021-05-27T09:00:00.000Z",
      "start": "2021-05-27T08:00:00.000Z",
      "tweet_count": 611
    },
    {
      "end": "2021-05-27T10:00:00.000Z",
      "start": "2021-05-27T09:00:00.000Z",
      "tweet_count": 502
    },
    {
      "end": "2021-05-27T11:00:00.000Z",
      "start": "2021-05-27T10:00:00.000Z",
      "tweet_count": 570
    },
    {
      "end": "2021-05-27T12:00:00.000Z",
      "start": "2021-05-27T11:00:00.000Z",
      "tweet_count": 637
    },
    {
      "end": "2021-05-27T13:00:00.000Z",
      "start": "2021-05-27T12:00:00.000Z",
      "tweet_count": 787
    },
    {
      "end": "2021-05-27T14:00:00.000Z",
      "start": "2021-05-27T13:00:00.000Z",
      "tweet_count": 1278
    },
    {
      "end": "2021-05-27T15:00:00.000Z",
      "start": "2021-05-27T14:00:00.000Z",
      "tweet_count": 1442
    },
    {
      "end": "2021-05-27T16:00:00.000Z",
      "start": "2021-05-27T15:00:00.000Z",
      "tweet_count": 3056
    },
    {
      "end": "2021-05-27T17:00:00.000Z",
      "start": "2021-05-27T16:00:00.000Z",
      "tweet_count": 2393
    },
    {
      "end": "2021-05-27T18:00:00.000Z",
      "start": "2021-05-27T17:00:00.000Z",
      "tweet_count": 3226
    },
    {
      "end": "2021-05-27T19:00:00.000Z",
      "start": "2021-05-27T18:00:00.000Z",
      "tweet_count": 3514
    },
    {
      "end": "2021-05-27T20:00:00.000Z",
      "start": "2021-05-27T19:00:00.000Z",
      "tweet_count": 2750
    },
    {
      "end": "2021-05-27T21:00:00.000Z",
      "start": "2021-05-27T20:00:00.000Z",
      "tweet_count": 2452
    },
    {
      "end": "2021-05-27T22:00:00.000Z",
      "start": "2021-05-27T21:00:00.000Z",
      "tweet_count": 2646
    },
    {
      "end": "2021-05-27T23:00:00.000Z",
      "start": "2021-05-27T22:00:00.000Z",
      "tweet_count": 2475
    },
    {
      "end": "2021-05-28T00:00:00.000Z",
      "start": "2021-05-27T23:00:00.000Z",
      "tweet_count": 3082
    },
    {
      "end": "2021-05-28T01:00:00.000Z",
      "start": "2021-05-28T00:00:00.000Z",
      "tweet_count": 3003
    },
    {
      "end": "2021-05-28T02:00:00.000Z",
      "start": "2021-05-28T01:00:00.000Z",
      "tweet_count": 5866
    },
    {
      "end": "2021-05-28T03:00:00.000Z",
      "start": "2021-05-28T02:00:00.000Z",
      "tweet_count": 15463
    },
    {
      "end": "2021-05-28T04:00:00.000Z",
      "start": "2021-05-28T03:00:00.000Z",
      "tweet_count": 19577
    },
    {
      "end": "2021-05-28T05:00:00.000Z",
      "start": "2021-05-28T04:00:00.000Z",
      "tweet_count": 49621
    },
    {
      "end": "2021-05-28T06:00:00.000Z",
      "start": "2021-05-28T05:00:00.000Z",
      "tweet_count": 20826
    },
    {
      "end": "2021-05-28T07:00:00.000Z",
      "start": "2021-05-28T06:00:00.000Z",
      "tweet_count": 7951
    },
    {
      "end": "2021-05-28T08:00:00.000Z",
      "start": "2021-05-28T07:00:00.000Z",
      "tweet_count": 4791
    },
    {
      "end": "2021-05-28T09:00:00.000Z",
      "start": "2021-05-28T08:00:00.000Z",
      "tweet_count": 2965
    },
    {
      "end": "2021-05-28T10:00:00.000Z",
      "start": "2021-05-28T09:00:00.000Z",
      "tweet_count": 2481
    },
    {
      "end": "2021-05-28T11:00:00.000Z",
      "start": "2021-05-28T10:00:00.000Z",
      "tweet_count": 2721
    },
    {
      "end": "2021-05-28T12:00:00.000Z",
      "start": "2021-05-28T11:00:00.000Z",
      "tweet_count": 3140
    },
    {
      "end": "2021-05-28T13:00:00.000Z",
      "start": "2021-05-28T12:00:00.000Z",
      "tweet_count": 3742
    },
    {
      "end": "2021-05-28T14:00:00.000Z",
      "start": "2021-05-28T13:00:00.000Z",
      "tweet_count": 3978
    },
    {
      "end": "2021-05-28T15:00:00.000Z",
      "start": "2021-05-28T14:00:00.000Z",
      "tweet_count": 4028
    },
    {
      "end": "2021-05-28T16:00:00.000Z",
      "start": "2021-05-28T15:00:00.000Z",
      "tweet_count": 3758
    },
    {
      "end": "2021-05-28T17:00:00.000Z",
      "start": "2021-05-28T16:00:00.000Z",
      "tweet_count": 4207
    },
    {
      "end": "2021-05-28T18:00:00.000Z",
      "start": "2021-05-28T17:00:00.000Z",
      "tweet_count": 3932
    },
    {
      "end": "2021-05-28T19:00:00.000Z",
      "start": "2021-05-28T18:00:00.000Z",
      "tweet_count": 3340
    },
    {
      "end": "2021-05-28T20:00:00.000Z",
      "start": "2021-05-28T19:00:00.000Z",
      "tweet_count": 3306
    },
    {
      "end": "2021-05-28T21:00:00.000Z",
      "start": "2021-05-28T20:00:00.000Z",
      "tweet_count": 3244
    },
    {
      "end": "2021-05-28T22:00:00.000Z",
      "start": "2021-05-28T21:00:00.000Z",
      "tweet_count": 2416
    },
    {
      "end": "2021-05-28T23:00:00.000Z",
      "start": "2021-05-28T22:00:00.000Z",
      "tweet_count": 2184
    },
    {
      "end": "2021-05-29T00:00:00.000Z",
      "start": "2021-05-28T23:00:00.000Z",
      "tweet_count": 2383
    },
    {
      "end": "2021-05-29T01:00:00.000Z",
      "start": "2021-05-29T00:00:00.000Z",
      "tweet_count": 2171
    },
    {
      "end": "2021-05-29T02:00:00.000Z",
      "start": "2021-05-29T01:00:00.000Z",
      "tweet_count": 2431
    },
    {
      "end": "2021-05-29T03:00:00.000Z",
      "start": "2021-05-29T02:00:00.000Z",
      "tweet_count": 3092
    },
    {
      "end": "2021-05-29T04:00:00.000Z",
      "start": "2021-05-29T03:00:00.000Z",
      "tweet_count": 2278
    },
    {
      "end": "2021-05-29T05:00:00.000Z",
      "start": "2021-05-29T04:00:00.000Z",
      "tweet_count": 1760
    },
    {
      "end": "2021-05-29T06:00:00.000Z",
      "start": "2021-05-29T05:00:00.000Z",
      "tweet_count": 1075
    },
    {
      "end": "2021-05-29T07:00:00.000Z",
      "start": "2021-05-29T06:00:00.000Z",
      "tweet_count": 793
    },
    {
      "end": "2021-05-29T08:00:00.000Z",
      "start": "2021-05-29T07:00:00.000Z",
      "tweet_count": 747
    },
    {
      "end": "2021-05-29T09:00:00.000Z",
      "start": "2021-05-29T08:00:00.000Z",
      "tweet_count": 601
    },
    {
      "end": "2021-05-29T10:00:00.000Z",
      "start": "2021-05-29T09:00:00.000Z",
      "tweet_count": 494
    },
    {
      "end": "2021-05-29T11:00:00.000Z",
      "start": "2021-05-29T10:00:00.000Z",
      "tweet_count": 582
    },
    {
      "end": "2021-05-29T12:00:00.000Z",
      "start": "2021-05-29T11:00:00.000Z",
      "tweet_count": 473
    },
    {
      "end": "2021-05-29T13:00:00.000Z",
      "start": "2021-05-29T12:00:00.000Z",
      "tweet_count": 610
    },
    {
      "end": "2021-05-29T14:00:00.000Z",
      "start": "2021-05-29T13:00:00.000Z",
      "tweet_count": 828
    },
    {
      "end": "2021-05-29T15:00:00.000Z",
      "start": "2021-05-29T14:00:00.000Z",
      "tweet_count": 912
    },
    {
      "end": "2021-05-29T16:00:00.000Z",
      "start": "2021-05-29T15:00:00.000Z",
      "tweet_count": 1026
    },
    {
      "end": "2021-05-29T17:00:00.000Z",
      "start": "2021-05-29T16:00:00.000Z",
      "tweet_count": 1466
    },
    {
      "end": "2021-05-29T18:00:00.000Z",
      "start": "2021-05-29T17:00:00.000Z",
      "tweet_count": 1373
    },
    {
      "end": "2021-05-29T19:00:00.000Z",
      "start": "2021-05-29T18:00:00.000Z",
      "tweet_count": 1093
    },
    {
      "end": "2021-05-29T20:00:00.000Z",
      "start": "2021-05-29T19:00:00.000Z",
      "tweet_count": 1525
    },
    {
      "end": "2021-05-29T21:00:00.000Z",
      "start": "2021-05-29T20:00:00.000Z",
      "tweet_count": 2513
    },
    {
      "end": "2021-05-29T22:00:00.000Z",
      "start": "2021-05-29T21:00:00.000Z",
      "tweet_count": 2602
    },
    {
      "end": "2021-05-29T23:00:00.000Z",
      "start": "2021-05-29T22:00:00.000Z",
      "tweet_count": 3211
    },
    {
      "end": "2021-05-30T00:00:00.000Z",
      "start": "2021-05-29T23:00:00.000Z",
      "tweet_count": 2066
    },
    {
      "end": "2021-05-30T01:00:00.000Z",
      "start": "2021-05-30T00:00:00.000Z",
      "tweet_count": 2272
    },
    {
      "end": "2021-05-30T02:00:00.000Z",
      "start": "2021-05-30T01:00:00.000Z",
      "tweet_count": 1851
    },
    {
      "end": "2021-05-30T03:00:00.000Z",
      "start": "2021-05-30T02:00:00.000Z",
      "tweet_count": 1705
    },
    {
      "end": "2021-05-30T04:00:00.000Z",
      "start": "2021-05-30T03:00:00.000Z",
      "tweet_count": 1543
    },
    {
      "end": "2021-05-30T05:00:00.000Z",
      "start": "2021-05-30T04:00:00.000Z",
      "tweet_count": 1446
    },
    {
      "end": "2021-05-30T06:00:00.000Z",
      "start": "2021-05-30T05:00:00.000Z",
      "tweet_count": 1106
    },
    {
      "end": "2021-05-30T07:00:00.000Z",
      "start": "2021-05-30T06:00:00.000Z",
      "tweet_count": 905
    },
    {
      "end": "2021-05-30T08:00:00.000Z",
      "start": "2021-05-30T07:00:00.000Z",
      "tweet_count": 806
    },
    {
      "end": "2021-05-30T09:00:00.000Z",
      "start": "2021-05-30T08:00:00.000Z",
      "tweet_count": 720
    },
    {
      "end": "2021-05-30T10:00:00.000Z",
      "start": "2021-05-30T09:00:00.000Z",
      "tweet_count": 563
    },
    {
      "end": "2021-05-30T11:00:00.000Z",
      "start": "2021-05-30T10:00:00.000Z",
      "tweet_count": 573
    },
    {
      "end": "2021-05-30T12:00:00.000Z",
      "start": "2021-05-30T11:00:00.000Z",
      "tweet_count": 668
    },
    {
      "end": "2021-05-30T13:00:00.000Z",
      "start": "2021-05-30T12:00:00.000Z",
      "tweet_count": 791
    },
    {
      "end": "2021-05-30T14:00:00.000Z",
      "start": "2021-05-30T13:00:00.000Z",
      "tweet_count": 1220
    },
    {
      "end": "2021-05-30T15:00:00.000Z",
      "start": "2021-05-30T14:00:00.000Z",
      "tweet_count": 1606
    },
    {
      "end": "2021-05-30T16:00:00.000Z",
      "start": "2021-05-30T15:00:00.000Z",
      "tweet_count": 1989
    },
    {
      "end": "2021-05-30T17:00:00.000Z",
      "start": "2021-05-30T16:00:00.000Z",
      "tweet_count": 3046
    },
    {
      "end": "2021-05-30T18:00:00.000Z",
      "start": "2021-05-30T17:00:00.000Z",
      "tweet_count": 3598
    },
    {
      "end": "2021-05-30T19:00:00.000Z",
      "start": "2021-05-30T18:00:00.000Z",
      "tweet_count": 4293
    },
    {
      "end": "2021-05-30T20:00:00.000Z",
      "start": "2021-05-30T19:00:00.000Z",
      "tweet_count": 10505
    },
    {
      "end": "2021-05-30T21:00:00.000Z",
      "start": "2021-05-30T20:00:00.000Z",
      "tweet_count": 16604
    },
    {
      "end": "2021-05-30T22:00:00.000Z",
      "start": "2021-05-30T21:00:00.000Z",
      "tweet_count": 32739
    },
    {
      "end": "2021-05-30T23:00:00.000Z",
      "start": "2021-05-30T22:00:00.000Z",
      "tweet_count": 19473
    },
    {
      "end": "2021-05-31T00:00:00.000Z",
      "start": "2021-05-30T23:00:00.000Z",
      "tweet_count": 6223
    },
    {
      "end": "2021-05-31T01:00:00.000Z",
      "start": "2021-05-31T00:00:00.000Z",
      "tweet_count": 6010
    },
    {
      "end": "2021-05-31T02:00:00.000Z",
      "start": "2021-05-31T01:00:00.000Z",
      "tweet_count": 4243
    },
    {
      "end": "2021-05-31T03:00:00.000Z",
      "start": "2021-05-31T02:00:00.000Z",
      "tweet_count": 3389
    },
    {
      "end": "2021-05-31T04:00:00.000Z",
      "start": "2021-05-31T03:00:00.000Z",
      "tweet_count": 2969
    },
    {
      "end": "2021-05-31T05:00:00.000Z",
      "start": "2021-05-31T04:00:00.000Z",
      "tweet_count": 2406
    },
    {
      "end": "2021-05-31T06:00:00.000Z",
      "start": "2021-05-31T05:00:00.000Z",
      "tweet_count": 1796
    },
    {
      "end": "2021-05-31T07:00:00.000Z",
      "start": "2021-05-31T06:00:00.000Z",
      "tweet_count": 1504
    },
    {
      "end": "2021-05-31T08:00:00.000Z",
      "start": "2021-05-31T07:00:00.000Z",
      "tweet_count": 1309
    },
    {
      "end": "2021-05-31T09:00:00.000Z",
      "start": "2021-05-31T08:00:00.000Z",
      "tweet_count": 1018
    },
    {
      "end": "2021-05-31T10:00:00.000Z",
      "start": "2021-05-31T09:00:00.000Z",
      "tweet_count": 842
    },
    {
      "end": "2021-05-31T11:00:00.000Z",
      "start": "2021-05-31T10:00:00.000Z",
      "tweet_count": 1022
    },
    {
      "end": "2021-05-31T12:00:00.000Z",
      "start": "2021-05-31T11:00:00.000Z",
      "tweet_count": 960
    },
    {
      "end": "2021-05-31T13:00:00.000Z",
      "start": "2021-05-31T12:00:00.000Z",
      "tweet_count": 1143
    },
    {
      "end": "2021-05-31T14:00:00.000Z",
      "start": "2021-05-31T13:00:00.000Z",
      "tweet_count": 1471
    },
    {
      "end": "2021-05-31T15:00:00.000Z",
      "start": "2021-05-31T14:00:00.000Z",
      "tweet_count": 1539
    },
    {
      "end": "2021-05-31T16:00:00.000Z",
      "start": "2021-05-31T15:00:00.000Z",
      "tweet_count": 1713
    },
    {
      "end": "2021-05-31T17:00:00.000Z",
      "start": "2021-05-31T16:00:00.000Z",
      "tweet_count": 2215
    },
    {
      "end": "2021-05-31T18:00:00.000Z",
      "start": "2021-05-31T17:00:00.000Z",
      "tweet_count": 3552
    },
    {
      "end": "2021-05-31T19:00:00.000Z",
      "start": "2021-05-31T18:00:00.000Z",
      "tweet_count": 2404
    },
    {
      "end": "2021-05-31T20:00:00.000Z",
      "start": "2021-05-31T19:00:00.000Z",
      "tweet_count": 1939
    },
    {
      "end": "2021-05-31T21:00:00.000Z",
      "start": "2021-05-31T20:00:00.000Z",
      "tweet_count": 1983
    },
    {
      "end": "2021-05-31T22:00:00.000Z",
      "start": "2021-05-31T21:00:00.000Z",
      "tweet_count": 1964
    },
    {
      "end": "2021-05-31T23:00:00.000Z",
      "start": "2021-05-31T22:00:00.000Z",
      "tweet_count": 1650
    },
    {
      "end": "2021-06-01T00:00:00.000Z",
      "start": "2021-05-31T23:00:00.000Z",
      "tweet_count": 1683
    },
    {
      "end": "2021-06-01T01:00:00.000Z",
      "start": "2021-06-01T00:00:00.000Z",
      "tweet_count": 1347
    },
    {
      "end": "2021-06-01T02:00:00.000Z",
      "start": "2021-06-01T01:00:00.000Z",
      "tweet_count": 1179
    },
    {
      "end": "2021-06-01T03:00:00.000Z",
      "start": "2021-06-01T02:00:00.000Z",
      "tweet_count": 1192
    },
    {
      "end": "2021-06-01T04:00:00.000Z",
      "start": "2021-06-01T03:00:00.000Z",
      "tweet_count": 960
    },
    {
      "end": "2021-06-01T05:00:00.000Z",
      "start": "2021-06-01T04:00:00.000Z",
      "tweet_count": 1264
    },
    {
      "end": "2021-06-01T06:00:00.000Z",
      "start": "2021-06-01T05:00:00.000Z",
      "tweet_count": 762
    },
    {
      "end": "2021-06-01T07:00:00.000Z",
      "start": "2021-06-01T06:00:00.000Z",
      "tweet_count": 548
    },
    {
      "end": "2021-06-01T08:00:00.000Z",
      "start": "2021-06-01T07:00:00.000Z",
      "tweet_count": 458
    },
    {
      "end": "2021-06-01T09:00:00.000Z",
      "start": "2021-06-01T08:00:00.000Z",
      "tweet_count": 407
    },
    {
      "end": "2021-06-01T10:00:00.000Z",
      "start": "2021-06-01T09:00:00.000Z",
      "tweet_count": 334
    },
    {
      "end": "2021-06-01T11:00:00.000Z",
      "start": "2021-06-01T10:00:00.000Z",
      "tweet_count": 391
    },
    {
      "end": "2021-06-01T12:00:00.000Z",
      "start": "2021-06-01T11:00:00.000Z",
      "tweet_count": 557
    },
    {
      "end": "2021-06-01T13:00:00.000Z",
      "start": "2021-06-01T12:00:00.000Z",
      "tweet_count": 726
    },
    {
      "end": "2021-06-01T14:00:00.000Z",
      "start": "2021-06-01T13:00:00.000Z",
      "tweet_count": 1230
    },
    {
      "end": "2021-06-01T15:00:00.000Z",
      "start": "2021-06-01T14:00:00.000Z",
      "tweet_count": 1546
    },
    {
      "end": "2021-06-01T16:00:00.000Z",
      "start": "2021-06-01T15:00:00.000Z",
      "tweet_count": 1705
    },
    {
      "end": "2021-06-01T17:00:00.000Z",
      "start": "2021-06-01T16:00:00.000Z",
      "tweet_count": 2163
    },
    {
      "end": "2021-06-01T18:00:00.000Z",
      "start": "2021-06-01T17:00:00.000Z",
      "tweet_count": 2388
    },
    {
      "end": "2021-06-01T19:00:00.000Z",
      "start": "2021-06-01T18:00:00.000Z",
      "tweet_count": 2433
    },
    {
      "end": "2021-06-01T20:00:00.000Z",
      "start": "2021-06-01T19:00:00.000Z",
      "tweet_count": 2832
    },
    {
      "end": "2021-06-01T21:00:00.000Z",
      "start": "2021-06-01T20:00:00.000Z",
      "tweet_count": 3082
    },
    {
      "end": "2021-06-01T22:00:00.000Z",
      "start": "2021-06-01T21:00:00.000Z",
      "tweet_count": 3112
    },
    {
      "end": "2021-06-01T23:00:00.000Z",
      "start": "2021-06-01T22:00:00.000Z",
      "tweet_count": 3509
    },
    {
      "end": "2021-06-02T00:00:00.000Z",
      "start": "2021-06-01T23:00:00.000Z",
      "tweet_count": 3011
    },
    {
      "end": "2021-06-02T01:00:00.000Z",
      "start": "2021-06-02T00:00:00.000Z",
      "tweet_count": 5267
    },
    {
      "end": "2021-06-02T02:00:00.000Z",
      "start": "2021-06-02T01:00:00.000Z",
      "tweet_count": 7784
    },
    {
      "end": "2021-06-02T03:00:00.000Z",
      "start": "2021-06-02T02:00:00.000Z",
      "tweet_count": 29339
    },
    {
      "end": "2021-06-02T04:00:00.000Z",
      "start": "2021-06-02T03:00:00.000Z",
      "tweet_count": 93671
    },
    {
      "end": "2021-06-02T05:00:00.000Z",
      "start": "2021-06-02T04:00:00.000Z",
      "tweet_count": 48240
    },
    {
      "end": "2021-06-02T06:00:00.000Z",
      "start": "2021-06-02T05:00:00.000Z",
      "tweet_count": 14795
    },
    {
      "end": "2021-06-02T07:00:00.000Z",
      "start": "2021-06-02T06:00:00.000Z",
      "tweet_count": 7994
    },
    {
      "end": "2021-06-02T08:00:00.000Z",
      "start": "2021-06-02T07:00:00.000Z",
      "tweet_count": 5430
    },
    {
      "end": "2021-06-02T09:00:00.000Z",
      "start": "2021-06-02T08:00:00.000Z",
      "tweet_count": 3640
    },
    {
      "end": "2021-06-02T10:00:00.000Z",
      "start": "2021-06-02T09:00:00.000Z",
      "tweet_count": 2940
    },
    {
      "end": "2021-06-02T11:00:00.000Z",
      "start": "2021-06-02T10:00:00.000Z",
      "tweet_count": 3377
    },
    {
      "end": "2021-06-02T12:00:00.000Z",
      "start": "2021-06-02T11:00:00.000Z",
      "tweet_count": 4122
    },
    {
      "end": "2021-06-02T13:00:00.000Z",
      "start": "2021-06-02T12:00:00.000Z",
      "tweet_count": 4753
    },
    {
      "end": "2021-06-02T14:00:00.000Z",
      "start": "2021-06-02T13:00:00.000Z",
      "tweet_count": 5258
    },
    {
      "end": "2021-06-02T15:00:00.000Z",
      "start": "2021-06-02T14:00:00.000Z",
      "tweet_count": 6044
    },
    {
      "end": "2021-06-02T16:00:00.000Z",
      "start": "2021-06-02T15:00:00.000Z",
      "tweet_count": 5902
    },
    {
      "end": "2021-06-02T17:00:00.000Z",
      "start": "2021-06-02T16:00:00.000Z",
      "tweet_count": 4986
    },
    {
      "end": "2021-06-02T18:00:00.000Z",
      "start": "2021-06-02T17:00:00.000Z",
      "tweet_count": 5278
    },
    {
      "end": "2021-06-02T19:00:00.000Z",
      "start": "2021-06-02T18:00:00.000Z",
      "tweet_count": 4964
    },
    {
      "end": "2021-06-02T20:00:00.000Z",
      "start": "2021-06-02T19:00:00.000Z",
      "tweet_count": 4641
    },
    {
      "end": "2021-06-02T21:00:00.000Z",
      "start": "2021-06-02T20:00:00.000Z",
      "tweet_count": 4188
    },
    {
      "end": "2021-06-02T22:00:00.000Z",
      "start": "2021-06-02T21:00:00.000Z",
      "tweet_count": 3479
    },
    {
      "end": "2021-06-02T23:00:00.000Z",
      "start": "2021-06-02T22:00:00.000Z",
      "tweet_count": 3506
    },
    {
      "end": "2021-06-03T00:00:00.000Z",
      "start": "2021-06-02T23:00:00.000Z",
      "tweet_count": 2544
    }
  ],
  "meta": {
    "total_tweet_count": 744364
  }
}
    
      {
  "data": [
    {
      "end": "2021-05-29T00:00:00.000Z",
      "start": "2021-05-28T00:00:00.000Z",
      "tweet_count": 178914
    },
    {
      "end": "2021-05-30T00:00:00.000Z",
      "start": "2021-05-29T00:00:00.000Z",
      "tweet_count": 35722
    },
    {
      "end": "2021-05-31T00:00:00.000Z",
      "start": "2021-05-30T00:00:00.000Z",
      "tweet_count": 116243
    },
    {
      "end": "2021-06-01T00:00:00.000Z",
      "start": "2021-05-31T00:00:00.000Z",
      "tweet_count": 50721
    }
  ],
  "meta": {
    "total_tweet_count": 381600
  }
}
    

Response fields

NameTypeDescription
startdate (ISO 8601)Start time for the granularity.
enddate (ISO 8601)End time for the granularity.
tweet_countintegerCount of the volume of Tweets that match the query.
metaobjectCreation time of the Tweet.
meta.total_tweet_countintegerTotal count of the Tweets that match the query.