Recent Post Counts

Get Post volume for the last 7 days

This guide walks you through getting Post counts (volume) for the last 7 days.

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• Your App’s Bearer Token

---

Get recent Post counts

1. Build a query

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

   from:XDevelopers
   
2. Make the request

   cURL

   shellscript

   curl "https://api.x.com/2/tweets/counts/recent?\
   query=from%3AXDevelopers&\
   granularity=day" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
3. Review the response

   {
     "data": [
       {
         "end": "2024-01-16T00:00:00.000Z",
         "start": "2024-01-15T00:00:00.000Z",
         "tweet_count": 5
       },
       {
         "end": "2024-01-17T00:00:00.000Z",
         "start": "2024-01-16T00:00:00.000Z",
         "tweet_count": 3
       },
       {
         "end": "2024-01-18T00:00:00.000Z",
         "start": "2024-01-17T00:00:00.000Z",
         "tweet_count": 8
       }
     ],
     "meta": {
       "total_tweet_count": 16
     }
   }
   

---

Granularity options

Control how counts are grouped:

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

cURL

shellscript

# Get hourly counts
curl "https://api.x.com/2/tweets/counts/recent?\
query=python%20lang%3Aen&\
granularity=hour" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

Filter by time range

Limit counts to a specific time period:

cURL

shellscript

curl "https://api.x.com/2/tweets/counts/recent?\
query=from%3AXDevelopers&\
start_time=2024-01-10T00%3A00%3A00Z&\
end_time=2024-01-15T00%3A00%3A00Z&\
granularity=day" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

Common parameters

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

---

Next steps

Full-archive counts

Get historical Post counts

Build a query

Master query syntax

API Reference

Full endpoint documentation