Skip to content

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.

Read a timeline now, no signupIt is the modern version of a statuses timeline call.
Twitter api statuses: a librarian in a tall reading room taking one card from a long drawer of dated cards.

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

  1. One status

    Call x.tweet_detail with the post id.

  2. A user timeline

    Call x.tweets with the handle.

  3. Search statuses

    Call x.search with a keyword and page with the cursor.

Endpoints that do it

EndpointWhat it's forCredits
Get a tweetGET /v1/x/tweets/{id}The post behind one status id.2 credits
List user tweetsGET /v1/x/users/{handle}/tweetsA user timeline.2 credits
Search tweetsGET /v1/x/tweets/searchSearch for statuses by keyword.2 credits
List retweetersGET /v1/x/tweets/{id}/retweetersWho 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"
response, first 2 rows
{
  "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?
Call 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?
Call 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?
Call 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?
Yes, from an account you connect, as separate actions. See Twitter API post. The read calls on this page never post.
What is a status in the Twitter API?
A status is a tweet, which X now calls a post. The older API names its endpoints statuses.
What replaces statuses user timeline?
Use the account posts endpoint. The free timeline scraper shows it in the browser.
Can I still use old code?
Port it one call at a time. The Twitter API v2 guide explains the newer model.

More ways to use the API

Build it with one API key

Try it free for 7 days with 1,000 credits.