Twitter API for journalists
Journalists use the X endpoints to find posts about a story, read whole reply threads, check who an account is, and keep a timestamped record of what they found. Getting started takes little code.

The job
When a story breaks, the first questions are who said it, when, and what the replies show. The search, post detail and replies endpoints answer those, with timestamps and author details attached.
The free tools run in the browser. A newsroom developer can script the same calls to monitor a topic or keep a log. See also brand and topic monitoring.
How it works
Search the story terms
Search for the names, places and phrases involved with the X tweet search tool or
x.search.Check the source
Before you rely on a post, look up the account with
x.userfor its bio, join date and follower count.Read the thread
Pull replies with
x.repliesand keep the post ids and times for your notes.
Endpoints that do it
| Endpoint | What it's for | Credits |
|---|---|---|
| Search tweetsGET /v1/x/tweets/search | Find posts about the story. | 2 credits |
| Get a tweetGET /v1/x/tweets/{id} | One post with its details and time. | 2 credits |
| List repliesGET /v1/x/tweets/{id}/replies | Replies to a post. | 2 credits |
| Get a userGET /v1/x/users/{handle} | Who the account is. | 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.
Posts about a story
A keyword search. Save the post ids and times with your notes.
curl "https://api.chatterapi.com/v1/x/tweets/search?q=%22crm+recommendation%22" \
-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": 138,
"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
},
{
"id": "2040879100261458222",
"text": "Here's a live audit on what happens when buyers ask AI for a CRM recommendation. You can't miss it...",
"url": "https://x.com/apoorvshrm/status/2040879100261458222",
"createdAt": "2026-04-05T19:47:49.000Z",
"lang": "en",
"likes": 4,
"retweets": 0,
"replies": 1,
"quotes": 0,
"views": 145,
"bookmarks": 0,
"isReply": false,
"inReplyToId": null,
"conversationId": "2040879100261458222",
"isRetweet": false,
"quotedTweetId": "2040878095415304308",
"type": "quote",
"isQuote": true,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [],
"author": {
"id": "1459048370371137542",
"handle": "apoorvshrm",
"name": "Apoorv Sharma | SEO and GEO for B2B SaaS",
"bio": "SEO + GEO for B2B SaaS. I help SaaS brands rank on Google and get recommended by Claude, Gemini, and Google AI.\nCo-Founder, DerivateX",
"followers": 2316,
"following": 519,
"tweets": null,
"verified": false,
"blueVerified": true,
"canDm": true,
"protected": null,
"location": "Bengaluru",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/2069124654112149504/AWTErF4d_normal.jpg",
"createdAt": "2021-11-12T06:40:23.000Z",
"profileUrl": "https://x.com/apoorvshrm",
"bannerUrl": "https://pbs.twimg.com/profile_banners/1459048370371137542/1770951885",
"likesGiven": null,
"mediaCount": null,
"pinnedTweetIds": null
},
"media": [],
"quotedTweet": {
"id": "2040878095415304308",
"text": "I just ran a live AI visibility audit on HubSpot.\n\nTyped the same prompt into ChatGPT, Perplexity, and Gemini.\n\nThe results were... WILD.\n\nHere's what I found 🧵",
"url": "https://x.com/apoorvshrm/status/2040878095415304308",
"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": "apoorvshrm",
"name": "Apoorv Sharma | SEO and GEO for B2B SaaS",
"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/apoorvshrm",
"bannerUrl": null,
"likesGiven": null,
"mediaCount": null,
"pinnedTweetIds": null
},
"media": []
},
"retweetedTweet": null
}
],
"page": {
"nextCursor": "ATcD…",
"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
- Deleted posts are not returned, so screenshot and archive anything you rely on.
- A profile and a post do not prove identity. Verify through your usual process.
- Protected accounts are hidden.