Catalog / Social, content & reviews
SOCIAL, CONTENT & REVIEWS
X (Twitter) Profile & Post
Collect public X (Twitter) profiles and posts by link.
About this data
Collect public X (Twitter) profiles and posts by link. Profiles come with exact follower, following and post counts, bio, website, verification and join date, plus latest posts. Posts come with text, media and exact likes, reposts, replies, quotes, bookmarks and views. Pay only for rows delivered.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/x/snapshot
Fetch one public X/Twitter profile and up to two posts displayed on it, or one post by URL/ID.
Profile rows include name, bio, location, website, follower/following/post counts and verification.
Post rows include public text, author, publication time and engagement counts supplied by X.
Replies are not crawled.
Input
Send a JSON body to POST https://api.ssh.autos/v1/x/snapshot.
| Field | Type | Required | Notes |
|---|---|---|---|
source | string | required | 1–2048 characters |
includeLatestPosts | boolean | optional | default true |
maxPosts | integer | optional | 1–2; default 2 |
Returned fields
The answer is JSON: records, a list, and summary, the run status and counts. Each record has these 51 fields; a field the source does not publish comes back null.
51 fields per record
| Field | Type | Notes |
|---|---|---|
type | string | profile or post one of profile, post |
id | string | X's numeric id of the profile or post |
url | string | The profile or post page on X |
origin | string | requested: from your input; latest: a profile's latest post; reply: a top reply under a post link one of requested, latest, reply |
username | string | Handle without @ (profiles only) |
name | string | Display name (profiles only) |
bio | string | — |
location | string | — |
website | string | — |
createdAt | string | Join date (profiles) or posting time (posts), ISO 8601 UTC |
followers | integer | — |
following | integer | — |
postsCount | integer | — |
isBlueVerified | boolean | — |
verifiedType | string | Business, Government or null |
isProtected | boolean | — |
avatarUrl | string | — |
bannerUrl | string | — |
professionalType | string | — |
affiliatesCount | integer | — |
subscribersCount | integer | — |
latestPostIds | array of strings | — |
text | string | Post text with links expanded (posts only) |
lang | string | — |
authorId | string | — |
authorUsername | string | — |
authorName | string | — |
authorFollowers | integer | — |
authorIsBlueVerified | boolean | — |
authorVerifiedType | string | — |
authorAvatarUrl | string | — |
likes | integer | — |
reposts | integer | — |
replies | integer | — |
quotes | integer | — |
bookmarks | integer | — |
views | integer | null for older posts without a view counter |
media | array of objects | Photos, videos and GIFs: type, url (image or video preview), width, height, altText, videoUrl (best quality MP4), durationMs |
hashtags | array of strings | — |
mentions | array of strings | — |
links | array of strings | — |
possiblySensitive | boolean | — |
isReply | boolean | — |
inReplyToId | string | — |
inReplyToUsername | string | — |
isQuote | boolean | — |
quotedPost | object | The quoted post: id, url, text, createdAt, author, likes, reposts, replies, views, media |
isPinned | boolean | — |
countsPartial | boolean | true when only likes and reply count could be read |
source | string | The input line this row came from |
scrapedAt | string | — |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/x/snapshot -m POST -b '{"source": "NASA", "includeLatestPosts": true, "maxPosts": 2}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: X (Twitter) Profile & Post Scraper. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt