Twitter API statuses
In the older Twitter API a "status" is a tweet, and endpoints such as statuses/show, statuses/user_timeline and statuses/update read or publish them. Here those jobs map to reading one post, reading an account timeline and running a search.

The job
Code written for the older API often calls statuses endpoints. X's newer versions replace much of that surface, and what you can use depends on your access, so check X's own docs for the current state. Twitter API v2 covers the newer model.
To get a tweet by id or URL, pass it to the post detail call. To get a user's tweets, including the latest tweet, call the account posts endpoint and read the first row; page back with the cursor for older tweets, as far as X returns them. Retweets and replies have their own calls, and posting or replying runs from a connected account. Reading one status is a post detail call. A user timeline is the account posts call. Searching statuses is the keyword search. Publishing is the post action from a connected account, covered in Twitter API post.
How it works
One status
Call
x.tweet_detailwith the post id.A user timeline
Call
x.tweetswith the handle.Search statuses
Call
x.searchwith a keyword and page with the cursor.
Endpoints that do it
| Endpoint | What it's for | Credits |
|---|---|---|
| Get a tweetGET /v1/x/tweets/{id} | The post behind one status id. | 2 credits |
| List user tweetsGET /v1/x/users/{handle}/tweets | A user timeline. | 2 credits |
| Search tweetsGET /v1/x/tweets/search | Search for statuses by keyword. | 2 credits |
| List retweetersGET /v1/x/tweets/{id}/retweeters | Who reposted a status. | 2 credits |
Free tools for the same job
Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.
A user timeline
This call replaces a user timeline request. Each row is a status with its text, time and counts.
curl "https://api.chatterapi.com/v1/x/users/levelsio/tweets" \
-H "Authorization: Bearer $CHATTERAPI_KEY"{
"data": [
{
"id": "2110066474513793361",
"text": "✨ 200,000+ users on my computer nostalgia project @pieter\n\nSometimes it takes a few years for things to take off, in this case about 2 years!\n\nKeep creating 💖 https://t.co/Na0LXnwAjW",
"url": "https://x.com/levelsio/status/2110066474513793361",
"createdAt": "2026-10-13T17:53:45.000Z",
"lang": "en",
"likes": 129,
"retweets": 4,
"replies": 37,
"quotes": 0,
"views": 15475,
"bookmarks": 9,
"isReply": false,
"inReplyToId": null,
"conversationId": "2110066474513793361",
"isRetweet": false,
"quotedTweetId": "2108957488410161442",
"type": "quote",
"isQuote": true,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [
"pieter"
],
"author": {
"id": "1577241403",
"handle": "levelsio",
"name": "@levelsio",
"bio": "💸http://levels.vc\n📸http://PhotoAI.com $86K/m\n🎮http://VibeJam.com $44K/m\n🏡http://InteriorAI.com $23K/m\n👙@X $13K/m\n🌍http://Nomads.com $7K/m\n🏩http://Hotelist.com $5K/m",
"followers": 974707,
"following": 3276,
"tweets": 181450,
"verified": false,
"blueVerified": true,
"canDm": false,
"protected": false,
"location": "📕My book $5K/m 👉",
"url": "https://readMAKE.com",
"avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_400x400.jpg",
"createdAt": "2013-07-08T09:31:59.000Z",
"profileUrl": "https://x.com/levelsio",
"bannerUrl": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
"likesGiven": 185852,
"mediaCount": 19829,
"pinnedTweetIds": [
"2109949585737052316"
]
},
"media": [
{
"type": "photo",
"url": "https://pbs.twimg.com/media/HUh2NAYWQAAP7ZK.jpg",
"videoUrl": null
}
],
"quotedTweet": {
"id": "2108957488410161442",
"text": "💾 Two years ago I started working on these crazy nostalgia projects, kind of randomly, because I was bored and wanted to do something different than just build another SaaS or AI app/website\n\nI wanted to try to run Wind…",
"url": "https://x.com/levelsio/status/2108957488410161442",
"createdAt": null,
"lang": null,
"likes": null,
"retweets": null,
"replies": null,
"quotes": null,
"views": null,
"bookmarks": null,
"isReply": false,
"inReplyToId": null,
"conversationId": null,
"isRetweet": false,
"quotedTweetId": null,
"type": "tweet",
"isQuote": false,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [],
"author": {
"id": "",
"handle": "levelsio",
"name": "@levelsio",
"bio": null,
"followers": null,
"following": null,
"tweets": null,
"verified": null,
"blueVerified": null,
"canDm": null,
"protected": null,
"location": null,
"url": null,
"avatarUrl": null,
"createdAt": null,
"profileUrl": "https://x.com/levelsio",
"bannerUrl": null,
"likesGiven": null,
"mediaCount": null,
"pinnedTweetIds": null
},
"media": []
},
"retweetedTweet": null
},
{
"id": "2110030627336540370",
"text": "This is also interesting to think about\n\nRight now it still takes, let's say, 30 minutes to a few hours to build something usable with AI and then you still polish for days/weeks/months\n\nIf we assume this will keep getti…",
"url": "https://x.com/levelsio/status/2110030627336540370",
"createdAt": "2026-10-13T15:31:18.000Z",
"lang": "en",
"likes": 324,
"retweets": 11,
"replies": 112,
"quotes": 10,
"views": 38339,
"bookmarks": 118,
"isReply": false,
"inReplyToId": null,
"conversationId": "2110030627336540370",
"isRetweet": false,
"quotedTweetId": null,
"type": "quote",
"isQuote": true,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [],
"author": {
"id": "1577241403",
"handle": "levelsio",
"name": "@levelsio",
"bio": "💸http://levels.vc\n📸http://PhotoAI.com $86K/m\n🎮http://VibeJam.com $44K/m\n🏡http://InteriorAI.com $23K/m\n👙@X $13K/m\n🌍http://Nomads.com $7K/m\n🏩http://Hotelist.com $5K/m",
"followers": 974707,
"following": 3276,
"tweets": 181450,
"verified": false,
"blueVerified": true,
"canDm": false,
"protected": false,
"location": "📕My book $5K/m 👉",
"url": "https://readMAKE.com",
"avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_400x400.jpg",
"createdAt": "2013-07-08T09:31:59.000Z",
"profileUrl": "https://x.com/levelsio",
"bannerUrl": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
"likesGiven": 185852,
"mediaCount": 19829,
"pinnedTweetIds": [
"2109949585737052316"
]
},
"media": [],
"quotedTweet": {
"id": "",
"text": "",
"url": "https://x.com/i/status/",
"createdAt": null,
"lang": null,
"likes": null,
"retweets": null,
"replies": null,
"quotes": null,
"views": null,
"bookmarks": null,
"isReply": false,
"inReplyToId": null,
"conversationId": null,
"isRetweet": false,
"quotedTweetId": null,
"type": "tweet",
"isQuote": false,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [],
"author": {
"id": "",
"handle": "",
"name": "",
"bio": null,
"followers": null,
"following": null,
"tweets": null,
"verified": null,
"blueVerified": null,
"canDm": null,
"protected": null,
"location": null,
"url": null,
"avatarUrl": null,
"createdAt": null,
"profileUrl": "https://x.com/",
"bannerUrl": null,
"likesGiven": null,
"mediaCount": null,
"pinnedTweetIds": null
},
"media": []
},
"retweetedTweet": null
}
],
"page": {
"nextCursor": "AYCt…",
"hasMore": true
}
}Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.
What it won't do
- Calls map by job rather than field for field, and field names and shapes differ from the older API.
- Deleted statuses and protected accounts are not returned.
- Publishing works only from connected accounts.
Questions
How do I get a tweet by id or URL?
x.tweet_detail with the tweet id or the tweet link. The free tweet lookup does it in the browser.How do I get the latest tweet or all tweets from a user?
x.tweets with the handle. The first row is the latest tweet, and the cursor pages back through older ones as far as X returns them. For your own tweets, use your handle.How do I get retweets and comments on a tweet?
x.retweeters for the accounts that retweeted it and x.replies for the replies, which is how the API exposes comments.Can I reply to, quote or post a tweet?
What is a status in the Twitter API?
What replaces statuses user timeline?
Can I still use old code?
Guides
More ways to use the API
- Access the Twitter API
- Claude Reddit bot
- Live Twitter monitor
- Reddit API application
- Reddit brand monitoring
- Reddit data export
- Reddit post API
- Reddit scraper API
- Social listening API
- Post with the Twitter API
- Twitter exporter
- Twitter scraper API
- Twitter webhook
- Reddit comments API
- Reddit user API
- Subreddit API
- Twitter followers API
- Twitter user API
- Twitter search API
- Social media scraping API
- Reddit listening tool
- Twitter feed API
- Twitter hashtag API
- Social media analytics API
- Twitter image API