Skip to content

Twitter API in JavaScript

Call the X endpoints from Node.js or the browser with the built-in fetch. You don't need an SDK: send a GET with an Authorization header and read the JSON that comes back.

Try the search in your browser firstThen copy the JavaScript code below.
Twitter api javascript: a small yellow-lit workshop with a tidy shelf of jars labelled with simple letters and a craftsperson pouring a drink into a cup.

The job

Because they only need fetch, the same calls work in Node 18 and later, Deno, Bun and edge runtimes. Keep the key in an environment variable, and never ship it in a public browser bundle.

A Twitter REST API JavaScript example is one GET request with a bearer key. The same pattern calls the Reddit endpoints from Node.js, so this works as a Reddit API Node.js example too. Posting from JavaScript is a separate action on a connected account; see Twitter API post. The JavaScript tab below shows the exact request behind the recorded response. For Python, see the X API in Python guide.

How it works

  1. Set the key

    Export CHATTERAPI_KEY in your shell or .env file and read it with process.env.

  2. Call the endpoint

    fetch the search URL with the key in the Authorization: Bearer header, then await res.json().

  3. Handle paging and errors

    To get the next page, pass nextCursor back. Check res.ok, and if it fails, read the error body.

Endpoints that do it

EndpointWhat it's forCredits
Search tweetsGET /v1/x/tweets/searchPosts by keyword.2 credits
Get a userGET /v1/x/users/{handle}A profile by handle.2 credits
List user tweetsGET /v1/x/users/{handle}/tweetsAn account's recent posts.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.

The JavaScript call and its response

The code is in the JavaScript tab. The response shown was recorded from a real call.

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

  • Keep the key out of front-end code and make the call from a server or an edge function.
  • The API doesn't return deleted posts or protected accounts.
  • Results are what X returns at call time.

Questions

How do I use the Twitter API in JavaScript?
Export your key as CHATTERAPI_KEY, fetch an endpoint with the key in the Authorization: Bearer header, and read await res.json(). You don't need an SDK.
Is there a Reddit API Node.js example?
Yes. Reddit endpoints use the same fetch call and header, so you only change the URL, for example a subreddit posts or search endpoint. See Reddit API in JavaScript.
How do I post a tweet from JavaScript?
Posting is a separate action that runs from an X account you connect, not from the read calls shown here. See Twitter API post.
Is there an npm package?
You do not need one. fetch is enough.
Does it work in the browser?
You can, but it exposes your key. Call it from a server instead.
Can I use TypeScript?
Yes. The responses are plain JSON, so you can describe the fields you use with an interface.

Other languages

Build it with one API key

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