Skip to content

Twitter API post: read and publish

"Twitter API post" can mean reading a post or publishing one. Reading uses the post detail and search endpoints. Publishing runs only from an X account you connect in the dashboard, within safe daily limits, and test keys return a dry run.

Look up a post now, no signupSee the fields before you build.
Twitter api post: a postmaster stamping and sending a single letter from a small counter while a window shows an arriving letter.

The job

To read a post, call the post detail endpoint with its id. You get the text, author, time and engagement counts back. To find posts, search by keyword or read an account's timeline.

To publish, connect your own X account in the dashboard. The post tool sends from that account and applies safe limits, so it won't behave like a bulk bot. Don't send real posts while testing: a test key returns a dry run. See the X docs for the actions endpoints, and does Twitter have an API for the official route.

How it works

  1. Read a post

    Call x.tweet_detail with the post id or link.

  2. Connect an account to publish

    Link your X account in the dashboard. You need it to publish.

  3. Use a test key first

    Test keys return a dry run, so you can check the request shape without posting anything.

Endpoints that do it

EndpointWhat it's forCredits
Get a tweetGET /v1/x/tweets/{id}One post with its details.2 credits
List user tweetsGET /v1/x/users/{handle}/tweetsAn account's recent posts.2 credits
Search tweetsGET /v1/x/tweets/searchPosts by keyword.2 credits
List repliesGET /v1/x/tweets/{id}/repliesReplies to a post.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.

Reading a post by id

A post detail call. Publishing uses a separate action endpoint from a connected account.

curl "https://api.chatterapi.com/v1/x/tweets/2099495333231288346" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": {
    "id": "2099495333231288346",
    "text": "meta ads: how important is the “connect to your crm” recommendation?\n\nthis essentially will tell meta if the lead was good or bad (ie converted), any experience how how is actually helps?\n\nthis particular client doesn’t …",
    "url": "https://x.com/HesomParhizkar/status/2099495333231288346",
    "createdAt": "2026-09-14T13:47:48.000Z",
    "lang": "en",
    "likes": 2,
    "retweets": 0,
    "replies": 2,
    "quotes": 0,
    "views": 139,
    "bookmarks": 0,
    "isReply": false,
    "inReplyToId": null,
    "conversationId": "2099495333231288346",
    "isRetweet": false,
    "quotedTweetId": null,
    "type": "tweet",
    "isQuote": false,
    "isPinned": false,
    "source": null,
    "hasVideo": false,
    "urls": [],
    "mentions": [],
    "author": {
      "id": "35363135",
      "handle": "HesomParhizkar",
      "name": "Hesom",
      "bio": "Startup Founder/Executive, investor, nba fan",
      "followers": 584,
      "following": 2010,
      "tweets": null,
      "verified": false,
      "blueVerified": true,
      "canDm": true,
      "protected": null,
      "location": "Marietta, GA",
      "url": null,
      "avatarUrl": "https://pbs.twimg.com/profile_images/1871033188081942528/comvGkRg_normal.jpg",
      "createdAt": "2009-04-26T01:18:19.000Z",
      "profileUrl": "https://x.com/HesomParhizkar",
      "bannerUrl": "https://pbs.twimg.com/profile_banners/35363135/1787179410",
      "likesGiven": null,
      "mediaCount": null,
      "pinnedTweetIds": null
    },
    "media": [],
    "quotedTweet": null,
    "retweetedTweet": null
  }
}

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

  • Publishing runs only from accounts you connect, within safe daily limits.
  • Test keys never post. They return a dry run.
  • Posting too fast or repeating the same text can get an account limited, so keep volume low.

Questions

Can I post a tweet through this API?
Yes, from an X account you connect in the dashboard, within safe daily limits. Test keys return a dry run.
How do I read a post by id?
Call the post detail endpoint with the id. The free post lookup tool does the same thing in the browser.
Is this the official X API?
No. It is independent. See the comparison.

More ways to use the API

Build it with one API key

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