X (Twitter) Scraper
Tweet detail (text, author, media, likes/reposts/quotes/replies/bookmarks/views) and top replies. Public, no login.
Tweet Detail
Tweet by URL or id: text, author, media, metrics, createdAt. viewCount null for pre-2023 tweets.
/v1/social-media:x-scraper/postParameters
| Name | Type | In | Description |
|---|---|---|---|
| url | string | query | Tweet URL (x.com / twitter.com). |
| id | string | query | Tweet id (alternative to url). |
| fresh | enum | query | Skip cache (impact rounds). One of true, false. |
Example response
{"project":"social-media:x-scraper","data":null,"timestamp":"2026-10-10T14:55:44Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Tweet Replies
Top replies (first page, ~18-35) of a tweet by URL or id, with total reply count.
/v1/social-media:x-scraper/repliesParameters
| Name | Type | In | Description |
|---|---|---|---|
| url | string | query | Tweet URL. |
| id | string | query | Tweet id (alternative to url). |
| fresh | enum | query | Skip cache (impact rounds). One of true, false. |
Example response
{"project":"social-media:x-scraper","data":null,"timestamp":"2026-10-10T14:55:44Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
User Tweets
Latest posts of a public X account (or its media tab), 20 per page with cursor pagination. Text, media, likes, replies, reposts, quotes, bookmarks, views.
/v1/social-media:x-scraper/user-tweetsParameters
| Name | Type | In | Description |
|---|---|---|---|
| username | string | query | X username (with or without @) or profile URL. Required. |
| type | enum | query | tweets = latest posts & reposts (default), media = media tab only. One of tweets, media. |
| cursor | string | query | Pagination cursor — pass nextCursor from the previous response. |
Example response
{"project":"social-media:x-scraper","data":null,"timestamp":"2026-10-10T14:55:44Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "social-media:x-scraper", "post", { url: "https://x.com/SpaceX/status/1732824684683784516", id: "1732824684683784516", fresh: "false" });
X (Twitter) Scraper
Tweet detail (text, author, media, likes/reposts/quotes/replies/bookmarks/views) and top replies. Public, no login.
Tweet by URL or id: text, author, media, metrics, createdAt. viewCount null for pre-2023 tweets.
/v1/…x-scraper/postTry it
Parameters
url
string · query · optional
Tweet URL (x.com / twitter.com).
id
string · query · optional
Tweet id (alternative to url).
fresh
enum · query · optional
Skip cache (impact rounds).
Example response
{"project":"social-media:x-scraper","data":null,"timestamp":"2026-10-10T14:55:44Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "social-media:x-scraper", "post", { url: "https://x.com/SpaceX/status/1732824684683784516", id: "1732824684683784516", fresh: "false" });