Skip to content

Twitter feed API: get any account's timeline as JSON

Send a handle and you get that account's recent tweets back as JSON, newest first, with text, time, likes, reposts, replies, views and media links. You can use it to put a Twitter feed on a site, fill a dashboard or feed another job. It reads public X accounts only, one page at a time, and it does not stream new posts to you.

Pull an account's recent tweets now, no signupThen run the same call from code.
Twitter feed API: a ribbon of notes unrolls into a display case.

The job

A feed on your own page needs the latest posts, a stable format and a way to refresh. This Twitter feed API handles the first two with one GET request per account. To refresh, call it again on whatever schedule suits you.

Each row has the tweet text, its link, the time, public engagement counts and any image or video URLs, plus a small author profile. Set includeRetweets to false when you want only what the account wrote itself, which is the usual setting for a site feed.

Cache the response on your side. A feed that refreshes every ten minutes needs far fewer calls than one that fetches on every page view, and your credit use stays flat no matter how many visitors you get. This covers X only. Reddit has its own feed endpoints for subreddits.

How it works

  1. Pick the account

    Use the handle without the @, such as levelsio. The same call works for any public account.

  2. Request the feed

    GET /v1/x/users/{handle}/tweets with your key in the Authorization header. The first page returns about 20 tweets.

  3. Page back through older posts

    Pass page.nextCursor as cursor to get the next page. Stop when page.hasMore is false or you have enough.

  4. Render and cache

    Map the fields you need into your template, and store the response for a few minutes so repeat visits don't trigger new calls.

Endpoints that do it

EndpointWhat it's forCredits
List user tweetsGET /v1/x/users/{handle}/tweetsAn account's recent tweets, newest first, with engagement counts and media.2 credits
Get a userGET /v1/x/users/{handle}The account's profile, to show a name, avatar and follower count above the feed.2 credits
Search tweetsGET /v1/x/tweets/searchA feed built from a query instead of one account, for example from:handle with filters.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.

An account's recent tweets

One call for one handle. The response below was recorded from a real call.

curl "https://api.chatterapi.com/v1/x/users/levelsio/tweets" \
  -H "Authorization: Bearer $CHATTERAPI_KEY"
response, first 2 rows
{
  "data": [
    {
      "id": "2110066474513793361",
      "text": "✨ 200,000+ users on my computer nostalgia project @pieter\n\nSometimes it takes a few years for things to take off, in this case about 2 years!\n\nKeep creating 💖 https://t.co/Na0LXnwAjW",
      "url": "https://x.com/levelsio/status/2110066474513793361",
      "createdAt": "2026-10-13T17:53:45.000Z",
      "lang": "en",
      "likes": 129,
      "retweets": 4,
      "replies": 37,
      "quotes": 0,
      "views": 15475,
      "bookmarks": 9,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2110066474513793361",
      "isRetweet": false,
      "quotedTweetId": "2108957488410161442",
      "type": "quote",
      "isQuote": true,
      "isPinned": false,
      "source": null,
      "hasVideo": false,
      "urls": [],
      "mentions": [
        "pieter"
      ],
      "author": {
        "id": "1577241403",
        "handle": "levelsio",
        "name": "@levelsio",
        "bio": "💸http://levels.vc\n📸http://PhotoAI.com $86K/m\n🎮http://VibeJam.com $44K/m\n🏡http://InteriorAI.com $23K/m\n👙@X $13K/m\n🌍http://Nomads.com $7K/m\n🏩http://Hotelist.com $5K/m",
        "followers": 974707,
        "following": 3276,
        "tweets": 181450,
        "verified": false,
        "blueVerified": true,
        "canDm": false,
        "protected": false,
        "location": "📕My book $5K/m 👉",
        "url": "https://readMAKE.com",
        "avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_400x400.jpg",
        "createdAt": "2013-07-08T09:31:59.000Z",
        "profileUrl": "https://x.com/levelsio",
        "bannerUrl": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
        "likesGiven": 185852,
        "mediaCount": 19829,
        "pinnedTweetIds": [
          "2109949585737052316"
        ]
      },
      "media": [
        {
          "type": "photo",
          "url": "https://pbs.twimg.com/media/HUh2NAYWQAAP7ZK.jpg",
          "videoUrl": null
        }
      ],
      "quotedTweet": {
        "id": "2108957488410161442",
        "text": "💾 Two years ago I started working on these crazy nostalgia projects, kind of randomly, because I was bored and wanted to do something different than just build another SaaS or AI app/website\n\nI wanted to try to run Wind…",
        "url": "https://x.com/levelsio/status/2108957488410161442",
        "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": "levelsio",
          "name": "@levelsio",
          "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/levelsio",
          "bannerUrl": null,
          "likesGiven": null,
          "mediaCount": null,
          "pinnedTweetIds": null
        },
        "media": []
      },
      "retweetedTweet": null
    },
    {
      "id": "2110030627336540370",
      "text": "This is also interesting to think about\n\nRight now it still takes, let's say, 30 minutes to a few hours to build something usable with AI and then you still polish for days/weeks/months\n\nIf we assume this will keep getti…",
      "url": "https://x.com/levelsio/status/2110030627336540370",
      "createdAt": "2026-10-13T15:31:18.000Z",
      "lang": "en",
      "likes": 324,
      "retweets": 11,
      "replies": 112,
      "quotes": 10,
      "views": 38339,
      "bookmarks": 118,
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "2110030627336540370",
      "isRetweet": false,
      "quotedTweetId": null,
      "type": "quote",
      "isQuote": true,
      "isPinned": false,
      "source": null,
      "hasVideo": false,
      "urls": [],
      "mentions": [],
      "author": {
        "id": "1577241403",
        "handle": "levelsio",
        "name": "@levelsio",
        "bio": "💸http://levels.vc\n📸http://PhotoAI.com $86K/m\n🎮http://VibeJam.com $44K/m\n🏡http://InteriorAI.com $23K/m\n👙@X $13K/m\n🌍http://Nomads.com $7K/m\n🏩http://Hotelist.com $5K/m",
        "followers": 974707,
        "following": 3276,
        "tweets": 181450,
        "verified": false,
        "blueVerified": true,
        "canDm": false,
        "protected": false,
        "location": "📕My book $5K/m 👉",
        "url": "https://readMAKE.com",
        "avatarUrl": "https://pbs.twimg.com/profile_images/2077111020305162240/PwddgOau_400x400.jpg",
        "createdAt": "2013-07-08T09:31:59.000Z",
        "profileUrl": "https://x.com/levelsio",
        "bannerUrl": "https://pbs.twimg.com/profile_banners/1577241403/1665964220",
        "likesGiven": 185852,
        "mediaCount": 19829,
        "pinnedTweetIds": [
          "2109949585737052316"
        ]
      },
      "media": [],
      "quotedTweet": {
        "id": "",
        "text": "",
        "url": "https://x.com/i/status/",
        "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": "",
          "name": "",
          "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/",
          "bannerUrl": null,
          "likesGiven": null,
          "mediaCount": null,
          "pinnedTweetIds": null
        },
        "media": []
      },
      "retweetedTweet": null
    }
  ],
  "page": {
    "nextCursor": "AYCt…",
    "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

  • X only. For subreddit feeds use the Reddit endpoints.
  • Public accounts only. Protected accounts and deleted tweets are not returned.
  • Each call returns one page of about 20 tweets, so long histories need paging.
  • It is a pull API. It does not push new tweets to you or stream a live feed, so poll on a schedule.

Questions

What is a Twitter feed API?
It returns an account's recent posts as structured data, so you can show them on your site or use them in a script without building a scraper.
How do I get a Twitter feed API for a website?
Call the timeline endpoint from your server, cache the JSON for a few minutes and render it in your page. Keep the key on the server and never put it in browser code.
Can I scrape a Twitter feed without code first?
Yes. The free X timeline scraper shows an account's recent tweets in the browser with no signup.
Does it return replies and retweets?
Retweets are included unless you set includeRetweets to false. Each row says whether it is a reply, a quote or a retweet.
Can I get a feed built from a search instead?
Yes. Use the tweet search endpoint with operators such as from: to build a feed from a query.

More ways to use the API

Build it with one API key

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