Timeline

Retrieves a list of events related to a Twitter account. Examples of events include: the account posting a tweet, following another account, updating its name, description, or handle (bio change), being mentioned by a "smart" follower, or a "smart" follower subscribing to or unsubscribing from the account.

Input:

Username: The username of the account on x.com.

Parameters:

toDate: Filters events by date, returning events up to the specified date in UNIX timestamp format.
Limit: The maximum number of events to return in the response.
Types: Specifies the types of events to retrieve. If left empty, all event types will be returned. Supported values:
- NEW_MENTION: Mention of the account by a "smart" follower on x.com.
- NEW_POST: New post created by the account on x.com.
- NEW_RETWEET: New retweet by the account on x.com.
- NEW_QUOTE_RETWEET: New quote retweet created by the account on x.com.
- NEW_POST_WITH_LINK: New post containing a link created by the account on x.com.
- NEW_RETWEET_WITH_LINK: New retweet containing a link created by the account on x.com.
- NEW_QUOTE_RETWEET_WITH_LINK: New quote retweet containing a link created by the account on x.com.
- NEW_BIO: Changes to the account's name, username, or bio on x.com.
- NEW_FOLLOWING_BY_SMART: New follow by a "smart" account on x.com.
- NEW_UNFOLLOWING_BY_SMART: Unfollow by a "smart" account on x.com.
- NEW_FOLLOWING: The account following another account on x.com.
- NEW_RAW_PROJECT_FOLLOWING: The account following another account on x.com identified as a potential project by the system.
- NEW_MAJOR_EVENT: Major events related to the account's project, such as a listing or launch.

Result:

{
"items": [
{
"createdAt": 1733209206, // Timestamp (UNIX) indicating when the event occurred
"type": "NEW_POST", // Type of the event
"text": "📝 New post: another memecoin or winter boots? 🤔 https://t.co/6ZLenye4V5", // Textual representation of the event
"data": { // Additional event data
"links": null,
"rawTweet": {
"entities": {
"urls": [],
"links": []
}
},
"tweetUrl": "https://x.com/getmoni_io/status/1863840619921359350/", // URL to the tweet
"tweetText": "another memecoin or winter boots? 🤔 https://t.co/6ZLenye4V5" // Raw text of the tweet
}
}
] // List of events
}