POST /v1/x/postsX (Twitter) Posts Scraper API
An X profile plus its recent timeline (up to 60 tweets incl. pinned, retweets and own replies) with text, media and engagement counts.
- Cost
- 2 credits
- Failed requests
- Refunded
- Cache hits
- Free
- Response fields
- 21
- Limits
- Up to 60 recent posts · no search
What the X (Twitter) Posts Scraper API does
The X (Twitter) Posts Scraper API returns a public X profile together with its recent timeline: up to 60 items including the pinned post, reposts and the account's own replies. Each post has its ID, link, full text, language, creation time, author, reply, quote and repost information, media with image and video URLs, and the engagement numbers: replies, reposts, quotes, likes, bookmarks and views. For reposts, the post fields describe the original post and retweeted_from names its author. The profile part includes bio, location, website, verification flags and follower, following and post counts. Send a username, an @handle or a profile URL; no paid X API tier or developer account is needed. Each request costs 2 credits.
What you get
Top-level fields of the response. Every field is typed and documented; nullable fields are null when the platform does not show them.
| Field | Type | Description |
|---|---|---|
user_id | string | null | X numeric user ID (rest_id) |
username | string | Screen name (canonical casing) |
full_name | string | Display name |
biography | string | Bio text; empty string if none |
location | string | Profile location; empty string if none |
external_url | string | null | Expanded profile website URL |
is_private | boolean | Tweets are protected |
is_verified | boolean | Legacy verified OR blue-verified |
is_blue_verified | boolean | Has X Premium (blue) checkmark |
follower_count | integer | null | Number of followers |
following_count | integer | null | Number of accounts followed |
tweet_count | integer | null | Total tweets incl. retweets |
like_count | integer | null | Tweets the user has liked |
media_count | integer | null | Number of media posts |
listed_count | integer | null | Number of lists including the user |
created_at | string | null | Join date, X legacy format |
profile_image_url | string | null | Full-size avatar URL |
profile_banner_url | string | null | Profile banner image URL |
posts | array<object> (20 fields each) | Timeline tweets in timeline order, max limit |
posts_fetched | integer | Number of tweets returned |
has_more | boolean | More tweets exist beyond those returned |
Request example
Send the API key as a Bearer token. The body is a small JSON object.
curl -X POST https://api.scrapeeverything.com/v1/x/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"tesla","limit":20}'| Parameter | Required | Description |
|---|---|---|
username | Yes | X username, @handle or profile URL. |
limit | No | Maximum number of tweets to return. |
What it costs
Each successful request costs 2 credits. Your first 100 credits are free. With credit packs, 1,000 requests to this endpoint cost:
Builder pack
$3.12
25,000 credits for $39.00
Growth pack
$2.38
100,000 credits for $119.00
Scale pack
$1.80
500,000 credits for $449.00
See pricing for all packs and rate limits.
Use cases
- Monitor what competitors, founders or public figures post, and how each post performs.
- Compare views, likes and reposts across a brand's recent posts for reporting.
- Collect images and videos attached to an account's recent posts.
Limitations: Unofficial API: not affiliated with or endorsed by the platform. Public data only, as a logged-out visitor sees it. Timelines return recent posts only (up to 60); protected accounts and posts X hides from logged-out visitors are missing.
- Includes the pinned post, reposts and the account's own replies, up to 60 items.
- For reposts the post fields describe the original post and retweeted_from holds its author.
- Protected accounts return an empty posts array.
Questions
How far back does the timeline go?
Recent posts only, up to 60 items per request. There is no keyword search and no paging into older posts.
Are reposts and replies included?
Yes. The pinned post, reposts and the account's own replies are included; is_pinned, is_retweet and is_reply tell them apart.
What about protected accounts?
Protected accounts return their public profile fields with an empty posts array.
How much does the X (Twitter) Posts Scraper API cost?
2 credits per successful request. Credits are bought in one-time packs and never expire. New accounts get 100 free credits. No payment details needed.
Am I charged for failed requests?
No. If the platform blocks the request, it times out or something fails on our side, the credits are refunded automatically. A definitive answer such as "this account does not exist" is billed because the lookup completed.
Can I re-read a result without paying again?
Yes. Send cache_days (1 to 14) and a repeat request for the same target within that window is served from your cache for free.
More X (Twitter) endpoints
Start with 100 free credits.
Continue with Google, create an API key and send your first request in under a minute.