Skip to content

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.

Search X for a story, no signupPaste names or phrases and read the posts.
Twitter api for journalists: a reporter on a night street under a lantern reading a thin paper strip, a notebook open, quiet city rooftops behind.

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

  1. Search the story terms

    Search for the names, places and phrases involved with the X tweet search tool or x.search.

  2. Check the source

    Before you rely on a post, look up the account with x.user for its bio, join date and follower count.

  3. Read the thread

    Pull replies with x.replies and keep the post ids and times for your notes.

Endpoints that do it

EndpointWhat it's forCredits
Search tweetsGET /v1/x/tweets/searchFind 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}/repliesReplies 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"
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": 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.

Questions

Can I see when a post was made?
Yes. Every post carries its timestamp and id.
Do I need to code?
No. The free tools cover search, post lookup and reply export in the browser.
Can I monitor a topic over time?
Yes, by running a search on a schedule. See Twitter keyword alerts.

Other solutions

Build it with one API key

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