API Reference

Description: Retrieves a complete list of indexed tweets from a given X account feed, including detailed tweet engagement metrics and attached media.

  • Tweet metadata – timestamp, text, media attachments.

  • Engagement metrics – views, likes, retweets, replies, bookmarks, and quotes.

This endpoint provides full access to an account's historical tweets and engagement data, useful for analyzing trends, measuring influence, and tracking audience interactions. You 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: Use to Retrieve all indexed tweets from an account with engagement stats. Analyze post performance based on likes, retweets, and views. Monitor historical tweet activity for trend analysis. Extract useful tweet info to make better decisions.

Usage Cost: 5 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

string
Defaults to null

The types of events to return separated by comma. Available values: NEW_POST, NEW_RETWEET, NEW_REPLY. If not specified, it will return records of all event types.

Headers
string
required
Response

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

The date the event was created

string

NEW_POST NEW_RETWEET NEW_REPLY

data
object
required
Language