TIMELINE
Twitter Timeline API: Pull Any Account at $0.04/1K
The Twitter timeline API is a REST endpoint that returns any public account's tweets as paginated JSON at $0.0008 per call ($0.04 per 1,000 tweets). TwitterAPIs provides four timeline endpoints: originals only, tweets with replies, home timeline, and a complete auto-paginated full-history pull, all on one Bearer key with no X developer account required.
Quick answer
To pull a user's timeline, call GET /twitter/user/tweets?userName=elonmusk with your Bearer key. Each response returns about 20 tweets plus a next_cursor and has_more. Pass the cursor back on the next call and repeat until has_more is false. For the full account history in one shot, use /twitter/user/tweets/complete. Every call costs $0.0008. No X developer account, no rate limits. 47 total endpoints on the same key.
Four timeline endpoints, one Bearer key
TwitterAPIs maps every timeline use case to a dedicated endpoint, all billed at the same flat $0.0008 per call. Pull originals only, include replies, read your own home feed, or fetch the complete history of any account in a single request.
| What you pull | Endpoint | Per page | Docs |
|---|---|---|---|
| Original tweets only | GET /twitter/user/tweets | ~20 per page | View docs |
| Tweets and replies (full activity) | GET /twitter/user/tweets_and_replies | ~20 per page | View docs |
| Home timeline (authenticated) | GET /twitter/user/home_timeline | ~20 per page | View docs |
| Full history (auto-paginated) | GET /twitter/user/tweets/complete | All pages, auto-paginated | View docs |
Every endpoint runs on the same Bearer key at $0.0008 per call, so cost scales with how much you pull, not which timeline shape you request.
Pull a timeline with cursor pagination
The tweets endpoint lives at GET /twitter/user/tweets. Pass the userName you want and read the tweets array. To walk the full timeline, omit cursor on the first call, then pass the returned next_cursor back on each subsequent call and loop until has_more is false. Each call is $0.0008 and returns about 20 tweets.
Get the first page of tweets
1curl -H "Authorization: Bearer YOUR_API_KEY" \2 "https://api.twitterapis.com/twitter/user/tweets?userName=elonmusk"The response is structured JSON with a next_cursor and has_more on every page. No HTML to parse, no proxy to rotate. Read the user tweets endpoint docs.
Pull the full account history in one request
The /twitter/user/tweets/complete endpoint auto-paginates through every available tweet and returns them merged into a single response. You skip the cursor loop entirely. It is the fastest path to archiving a full account history or building a training dataset from an account's entire output.
Fetch the complete tweet history
1curl -H "Authorization: Bearer YOUR_API_KEY" \2 "https://api.twitterapis.com/twitter/user/tweets/complete?userName=elonmusk"Use the complete endpoint when you need the entire history in one call and the account has a manageable tweet count. For accounts with very large histories, walk pages manually with user/tweets to control memory and resumability. Read the complete endpoint docs.
Pull tweets with replies: full account activity
Switch to GET /twitter/user/tweets_and_replies when you need the full chronological activity stream including replies. The response shape is identical to user/tweets, so the same cursor loop works without changes.
1curl -H "Authorization: Bearer YOUR_API_KEY" \2 "https://api.twitterapis.com/twitter/user/tweets_and_replies?userName=elonmusk"Each call returns about 20 items at $0.0008. Use this endpoint when you need to map how an account engages in conversations, not just what it publishes. Read the tweets and replies docs.
Endpoint breakdown: what each timeline path returns
| Endpoint | Payload | Page size | Best for |
|---|---|---|---|
| user/tweets | Original posts only, no replies | ~20 per page | Brand monitoring, content audits, post-level analytics |
| user/tweets_and_replies | Posts + replies in chronological order | ~20 per page | Full account activity, sentiment analysis, engagement mapping |
| user/home_timeline | Authenticated user's own feed (requires user context) | ~20 per page | Reading the home feed of your own account |
| user/tweets/complete | Entire tweet history, all pages merged into one response | Auto-paginated | Full account history exports, training data, archival pipelines |
All four endpoints bill at $0.0008 per call. The complete endpoint is the only one without a cursor response since it handles pagination internally.
TwitterAPIs timeline vs the official X API and scraping
| Option | Price | Auth | Limits | Full history |
|---|---|---|---|---|
| TwitterAPIs | $0.04 / 1,000 tweets | Bearer token, 30s signup | No rate limits | Full history via cursor or auto-paginated complete endpoint |
| Official X API timeline | Gated, enterprise pricing | X developer account, OAuth app approval | Hard tweet caps per 15-minute window on every tier | Limited lookback on lower tiers; full history on enterprise only |
| Browser scraping the profile tab | $0 plus proxy and compute cost | Session cookies or tokens | IP bans within hours of a high-volume run | Breaks on any X layout change, partial pulls only |
Pricing: flat and pay-as-you-go
$0.04
per 1,000 tweets pulled
$0.50
free credits at signup, no card
$0
subscription, you pay per call only
Every call is $0.0008 and returns about 20 tweets, so 1,000 tweets costs roughly $0.04. See the full cost breakdown on the Twitter API pricing page or check the pricing page for the full endpoint list.
If you need more than timeline tweets
The timeline endpoints cover what an account posts. To find tweets across all accounts by keyword or hashtag, use the Twitter search API. To track every tweet that mentions an account in near real time, use the Twitter mentions API. To pull follower and following lists for the same account, use the Twitter followers API. To enumerate the members of any public X list by list ID, use the Twitter list API. To wire timeline calls into an AI agent, install the MCP server or read the full API docs. You get 47 endpoints across the X data surface on the same key.
Twitter timeline API FAQ
The Twitter timeline API is a set of REST endpoints that return a user's tweets as paginated JSON. TwitterAPIs exposes 47 endpoints across the X data surface, including four timeline-specific paths: user/tweets (originals only), user/tweets_and_replies (full activity), user/home_timeline (authenticated feed), and user/tweets/complete (auto-paginated full history). Every call costs $0.0008, so pulling 1,000 tweets costs $0.04 flat, with no subscription and no X developer account required.
user/tweets returns only the account's original posts, filtering out replies. user/tweets_and_replies returns the full chronological activity stream including both posts and replies. Use user/tweets when you want clean tweet-only data for brand monitoring or content analysis. Use user/tweets_and_replies when you need the complete picture of how an account engages, such as for sentiment analysis, conversation mapping, or full account audits.
No. TwitterAPIs uses a single Bearer token you copy from your dashboard after signup. There is no OAuth app review, no X developer account, and no waiting period. The only exception is user/home_timeline, which reads the authenticated user's own feed and therefore requires a user context token. For pulling any other public account's timeline, the standard Bearer key is all you need.
Yes. Use GET /twitter/user/tweets to get only the account's original posts. Replies, quote-tweets-as-replies, and thread continuations are stripped from the response. Each page returns about 20 original tweets at $0.0008 per call. If you need replies included, switch to user/tweets_and_replies on the same key.
Call GET /twitter/user/tweets/complete with the userName of the account. The endpoint auto-paginates through the entire history and returns all tweets merged into a single response, so you do not have to write cursor-loop logic yourself. For very large accounts with tens of thousands of tweets, use the standard user/tweets endpoint with manual cursor pagination instead: omit cursor on the first call, read the next_cursor from the response, pass it back on the next call, and repeat until has_more is false. Each page returns about 20 tweets and costs $0.0008.
Every call to any TwitterAPIs endpoint is $0.0008 (source: twitterapis pricing). The timeline endpoints return about 20 tweets per page, so pulling 1,000 tweets costs roughly $0.04. There is no monthly subscription and no minimum spend. You start with $0.50 in free credits after a 30-second signup with no card required, enough to pull around 600 tweets before you spend a cent. The official X API gates timeline access behind paid developer tiers with per-window tweet caps, making TwitterAPIs the cheapest managed path to high-volume timeline exports.
On your first request, omit the cursor parameter. The response includes a next_cursor string and a has_more boolean. Pass next_cursor back in the cursor parameter on your next call to fetch the following page. Repeat the loop until has_more is false. The same cursor pattern applies to user/tweets, user/tweets_and_replies, and user/home_timeline. user/tweets/complete handles the pagination internally and returns all pages merged, so no cursor loop is needed for that endpoint.
Yes. TwitterAPIs publishes an MCP server at @twitterapis/mcp that exposes all timeline endpoints as native tools. Any MCP-compatible AI agent or IDE can call user/tweets, user/tweets_and_replies, or user/tweets/complete directly, without writing HTTP request logic. See the MCP page for installation and usage instructions.
Pull any Twitter timeline without an X developer account
$0.04 per 1,000 tweets. $0.50 free credits at signup. Cursor pagination, full history, no rate limits.
Next read
Continue exploring related pages: