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.

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
Read a post
Call
x.tweet_detailwith the post id or link.Connect an account to publish
Link your X account in the dashboard. You need it to publish.
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
| Endpoint | What it's for | Credits |
|---|---|---|
| Get a tweetGET /v1/x/tweets/{id} | One post with its details. | 2 credits |
| List user tweetsGET /v1/x/users/{handle}/tweets | An account's recent posts. | 2 credits |
| Search tweetsGET /v1/x/tweets/search | Posts by keyword. | 2 credits |
| List repliesGET /v1/x/tweets/{id}/replies | Replies 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"{
"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?
How do I read a post by id?
Is this the official X API?
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
- Twitter API statuses
- 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