X Tweet Engagement Scraper — Replies, Quotes & Retweets

Get all public engagement on any X (Twitter) post in a single run: replies, quote tweets, and retweeters — returned in one unified dataset, each row tagged with an engagementType field. Feed a tweet URL or numeric tweet ID, get back the full conversation and amplification around it. No cookies, no X login, no browser.

What you get

One actor replaces three separate scrapers. For every tweet you supply, it collects:

• Replies (engagementType: "reply") — the comments under the tweet, with full text, author, and engagement metrics.
• Quote tweets (engagementType: "quote") — accounts that quoted the tweet with their own commentary, with full text and metrics.
• Retweeters (engagementType: "retweet") — accounts that amplified the tweet. A retweet carries no text, so these rows contain author fields only (handle, name, followers, bio, verified).

When to use it

• Sentiment & brand monitoring — read what people actually say back (replies + quote commentary) about a launch, ad, or statement.
• Influencer identification — find high-follower accounts amplifying a tweet (retweeters + quoters).
• Virality breakdown — quantify how a post spread: reply volume vs quote volume vs raw retweets.
• AI agents / MCP — single URL in, structured JSON out; ideal as a tool call.

Not for: keyword/hashtag search, profile timelines, or follower lists. Use the related actors below. For replies only, the dedicated x-twitter-replies-scraper is a lighter option.

Output

Each dataset row is a flat record. Key fields:

Field	Description
engagementType	reply, quote, or retweet
parentTweetId / parentTweetUrl	The tweet you queried
tweetId / tweetUrl	The reply or quote tweet (null for retweets)
text	Reply or quote text (null for retweets)
authorUsername / authorName / authorId	Engaging account
authorFollowers / authorVerified / authorBio	Author profile signal
likeCount / retweetCount / replyCount / quoteCount / viewCount	Metrics (reply/quote only)
createdAt	ISO 8601 timestamp (reply/quote)
quotedTweetId	For quotes, the quoted source tweet
hashtags / mentions / urls / mediaUrls	Parsed entities
provider / providerPage / scrapedAt	Provenance

Null/empty fields are omitted from each record rather than emitted as null.

Pricing — Pay Per Event

Event	Price
Actor start	$0.00005
Engagement item (reply, quote, or retweet)	$0.006

You set maxItems (default 100) as a hard cap — the actor never charges beyond it, and prints the maximum possible cost at the start of every run. A typical 100-item run costs about $0.60. Pay-Per-Usage (compute + proxy) billing is also available; pick whichever model you prefer at run time.

Input

{
  "tweetUrls": ["https://x.com/OpenAI/status/2065225362544726371"],
  "engagementTypes": ["reply", "quote", "retweet"],
  "rankingMode": "Relevance",
  "maxItems": 100,
  "maxPagesPerType": 3
}

• tweetUrls (required) — tweet URLs or numeric IDs, up to 50.
• engagementTypes — any of reply, quote, retweet. Default: all three.
• rankingMode — Relevance, Recency, or Likes (applies to replies and quotes).
• maxItems — total billing/dataset cap (1–5000, default 100).
• maxPagesPerType — pagination depth per type per tweet (1–50, default 3).
• includeRaw — attach the raw provider object to each row (debugging).
• dedupeItems — drop duplicates across pages (default true).

How it works

The actor calls a public-data provider API (SociaVault) server-side, so it needs no X login and no cookies from you. It paginates each engagement type with the provider's cursor up to maxPagesPerType, normalizes the raw X/Twitter timeline objects into the flat schema above, dedupes, and pushes rows to the dataset. Replies and quotes resolve to tweet objects (with text + metrics); retweets resolve to user objects (author only). A machine-readable run summary is written to the OUTPUT and RUN_SUMMARY keys in the key-value store.

MCP / AI agents

This actor is MCP-ready. Exposed as apify--x-tweet-engagement-scraper, it takes a narrow input (a tweet URL) and returns compact structured JSON, making it a clean tool call for Claude, ChatGPT, or any MCP client. Errors and empty results return clear status messages rather than crashing.

FAQ

Why do retweet rows have no text? A retweet is a pure amplification on X — there is no comment attached. To capture commentary, use the quote type. Retweet rows still give you the amplifier's handle, name, and follower count.

How deep does it go? Depth is bounded by maxItems, maxPagesPerType, and what X exposes publicly. X does not expose the complete retweeter or reply list for high-volume tweets to anyone; you get the publicly visible window.

Do I need a SociaVault account? No. The provider key is managed by the actor owner. You only pay the per-event price above.

Can I scrape multiple tweets at once? Yes — pass up to 50 tweet URLs/IDs. maxItems caps the combined total.

Related actors

• x-twitter-replies-scraper — replies only, lighter.
• x-tweet-scraper — tweet content by URL/ID.
• twitter-profile-followers-scraper — profiles + followers.

Legal & compliance

This actor collects only publicly available data from X/Twitter via a third-party public-data API. It does not log in, bypass authentication, or access private or protected content. You are responsible for using the output in compliance with X's Terms of Service, applicable data-protection laws (including GDPR/CCPA where relevant), and any restrictions on personal data. Do not use scraped personal data for unlawful profiling, harassment, or spam.