# twitr.sh, pay as you go: X post API

> Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited).

twitr.sh's X post API on its Pay per call plan. It costs $1.20 per 1,000 posts. It returns 3 of the 6 key fields we check: Text, Engagement, Author.
We haven't run twitr.sh through [our X post API benchmark](https://datacircle.dev/best-x-twitter-post-api.txt) yet.
Half of the 298 plans we rank by price cost $0.075 per 1,000 posts or less. This plan costs less per 1,000 posts than 6% of the 298 plans.
[Zapi's Rp399,000 monthly plan](https://datacircle.dev/x-post-apis/zapi/rp399000-monthly/llms.txt) costs the least per 1,000 posts: $0.0011. Zapi charges for each page of results. We count 20 posts on each page to get the $0.0011 price.
[TweetAPI](https://datacircle.dev/x-post-apis/tweetapi/17-monthly-pro-get-tw-v2-user-tweets/llms.txt), [TwitterAPIs](https://datacircle.dev/x-post-apis/twitterapis/top-up-from-10-pay-as-you-go-get-twitter-user-tweets/llms.txt) and [Sorsa](https://datacircle.dev/x-post-apis/sorsa/199-monthly/llms.txt) are the best X (Twitter) post API providers in the Datacircle benchmark.

- This page: https://datacircle.dev/x-post-apis/twitr-sh/pay-as-you-go
- [X (Twitter) post API: 15 providers compared](https://datacircle.dev/best-x-twitter-post-api.txt)
- Get it: https://twitr.sh/x-api-pricing?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- Request: `POST https://twitr.sh/api/tools/x_timeline`
- API key: not needed
- Its API docs: https://twitr.sh/tools/x_timeline?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- Sold by: twitr.sh (https://twitr.sh?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing)
- Checked: 2026-11-05

## In the answer

- Completeness: 50%
- Text: ✓
- Engagement: ✓
- Author: ✓

## Price

- $ per 1,000 posts: $1.20
- Per: result
- Billing: pay as you go

## Charges

- Also pays for: nothing else

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited).

## Data

- Keep data: no limit
- Use data: twitr.sh grants you no rights to X's platform, and using this service does not exempt you from any agreement you have with X. [...] You may not use twitr.sh for: automated mass following, unfollowing, or liking, keyword-triggered reply spam, harassment or impersonation, activity that is unlawful where you operate, or attempts to probe, overload, or interfere with the service itself.

## Plan

- Pay: per call

## Rate limit

- Concurrent: 1
- Batch: 1

## Speed

- Answer: in the call

## The call

- You send: kind "user-tweets", id, resultsLimit. Optional: includeReplies, includeParentTweet, language, mediaType, minFaves, verifiedOnly
- Method: POST
- Path: /api/tools/x_timeline

## About the plan

- Plan: Pay per call
- Who can get it: anyone with a USDC wallet

## The 5 fields the plan's answer can hold

post ID, text, author username, like count, created at

## twitr.sh's plans (2)

- [twitr.sh, pay as you go](https://datacircle.dev/x-post-apis/twitr-sh/pay-as-you-go/llms.txt): $1.20 per 1,000, 50% complete
- [twitr.sh, top-up](https://datacircle.dev/x-post-apis/twitr-sh/top-up/llms.txt): $1.20 per 1,000, 50% complete

## twitr.sh's calls (1)

- `POST /api/tools/x_timeline`: [twitr.sh, pay as you go](https://datacircle.dev/x-post-apis/twitr-sh/pay-as-you-go/llms.txt)

## twitr.sh's APIs (1)

- [twitr.sh: X post API pricing, 2 plans](https://datacircle.dev/x-post-apis/twitr-sh/pay-as-you-go/llms.txt)

## twitr.sh: X post API alternatives

- [ProLevelMax, top-up, Pay per use, POST /v1/run, X (Twitter) tweets by search, profile or URL](https://datacircle.dev/x-post-apis/prolevelmax/top-up-pay-per-use-post-v1-run-x-twitter-tweets-by-search-profile-or-url/llms.txt): $1.20 per 1,000, 83% complete, live
- [1Lookup, $19,990 yearly, Enterprise (annual), POST /bulk/jobs](https://datacircle.dev/x-post-apis/1lookup/19990-yearly-enterprise-annual-post-bulk-jobs/llms.txt): $1.249 per 1,000, 83% complete
- [Bright Data, $499 monthly](https://datacircle.dev/x-post-apis/bright-data/499-monthly/llms.txt): $1.30 per 1,000, 100% complete, live
- [InsightSocial, $13 pack](https://datacircle.dev/x-post-apis/insightsocial/13-pack/llms.txt): $1.30 per 1,000, 83% complete

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-05.

- https://twitr.sh?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- https://twitr.sh/docs?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- https://twitr.sh/llms-full.txt?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- https://twitr.sh/llms.txt?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- https://twitr.sh/terms?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- https://twitr.sh/tools/x_timeline?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- https://twitr.sh/twitter-scraper-api?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing
- https://twitr.sh/x-api-pricing?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=x-twitter-post-api-pricing