Full-Archive Post Counts

Get historical Post volume back to 2006

This guide walks you through getting historical Post counts back to March 2006.

Full-archive Post counts requires Self-serve or Enterprise access.

Prerequisites

Before you begin, you’ll need:

• A developer account with Self-serve or Enterprise access
• Your App’s Bearer Token

---

Get full-archive Post counts

1. Build a query

   Use the same query syntax as full-archive search. For example, to count Posts from @XDevelopers:

   from:XDevelopers
   
2. Set a time range

   Specify start_time and end_time to search specific historical periods:

   Parameter	Format	Example
   start_time	ISO 8601	2020-01-01T00:00:00Z
   end_time	ISO 8601	2020-12-31T23:59:59Z

3. Make the request

   cURL

   shellscript

   curl "https://api.x.com/2/tweets/counts/all?\
   query=from%3AXDevelopers&\
   start_time=2020-01-01T00%3A00%3A00Z&\
   end_time=2020-12-31T23%3A59%3A59Z&\
   granularity=day" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
4. Review the response

   {
     "data": [
       {
         "end": "2020-01-02T00:00:00.000Z",
         "start": "2020-01-01T00:00:00.000Z",
         "tweet_count": 3
       },
       {
         "end": "2020-01-03T00:00:00.000Z",
         "start": "2020-01-02T00:00:00.000Z",
         "tweet_count": 5
       }
     ],
     "meta": {
       "total_tweet_count": 8
     }
   }
   

---

Granularity options

Control how counts are grouped:

Granularity	Description
minute	Counts per minute
hour	Counts per hour (default)
day	Counts per day

---

Paginate through results

For large time ranges, use the next_token from the response:

cURL

shellscript

curl "https://api.x.com/2/tweets/counts/all?\
query=from%3AXDevelopers&\
start_time=2015-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
granularity=day&\
next_token=abc123" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

Key differences from recent counts

Feature	Recent Counts	Full-Archive Counts
Time range	Last 7 days	March 2006 to now
Access required	All developers	Pay-per-use, Enterprise
Default time range	Last 7 days	Last 30 days

---

Common parameters

Parameter	Description	Default
query	Search query (required)	—
granularity	Time bucket size	hour
start_time	Oldest timestamp (ISO 8601)	30 days ago
end_time	Newest timestamp (ISO 8601)	Now
next_token	Pagination token	—

---

Next steps

Recent counts

Get recent Post counts

Build a query

Master query syntax

API Reference

Full endpoint documentation