API Reference

Description: Retrieves a list of all indexed tweets from a given X account feed, containing only tweet engagement metrics, such as:

  • Likes count (likeCount)

  • Retweets count (retweetCount)

  • Replies count (replyCount)

  • Impressions count (impressionCount)

  • Quote tweets count (quoteCount)

  • Bookmarks count (bookmarkCount)

You can filter tweets by date range. The endpoint has limits – up to 100 tweets in the list per request.

âš¡ Important: To enable tweet indexing for an account, you must first send a PUT request to /api/v2/twitters/{username}/tracker/tweet/.

Usage: This endpoint is useful for analyzing audience engagement, tracking tweet performance, and measuring content impact. You can use it to retrieve historical engagement metrics for any account's tweets, measure post performance based on likes, retweets, and impressions, and compare tweet engagement trends over time.

Usage Cost: 3 points per request

Log in to see full request history
Path Params
string
required

The username (handle) of the user in x.com

Query Params
int32
Defaults to null

Unixtimestamp of the earliest event to include.

int32
Defaults to null

Unixtimestamp of the most recent event to include.

int32
1 to 100
Defaults to 100

The maximum number of items to return

Headers
string
required
Response

Response body
object
items
array of objects
required
items*
object
int32
required

The date the event was created

data
object
required
Language