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.

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
Pick the account
Use the handle without the @, such as
levelsio. The same call works for any public account.Request the feed
GET
/v1/x/users/{handle}/tweetswith your key in theAuthorizationheader. The first page returns about 20 tweets.Page back through older posts
Pass
page.nextCursorascursorto get the next page. Stop whenpage.hasMoreis false or you have enough.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
| Endpoint | What it's for | Credits |
|---|---|---|
| List user tweetsGET /v1/x/users/{handle}/tweets | An 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/search | A 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"{
"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?
How do I get a Twitter feed API for a website?
Can I scrape a Twitter feed without code first?
Does it return replies and retweets?
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?
from: to build a feed from a query.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
- Post with the Twitter 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 hashtag API
- Social media analytics API
- Twitter image API