X(Twitter) Thread Scraper

Expand a tweet into its thread conversation and export rows with text, timestamps, engagement counts, media/entity blocks, and author metadata when available. The actor can continue through cursor-based pages automatically so you can collect a longer thread in one run.

Who it’s for

• Analysts and researchers reviewing full thread context beyond the first post.
• Content teams tracking engagement and media across a conversation.
• Automation pipelines that store thread snapshots in tabular form.

What you can do with it

• Start from one tweet id and collect related thread items.
• Automatically continue paging while more rows are available.
• Set a max row cap to keep runs predictable.

How it works (in plain terms)

You provide a tweet id and an optional max row count. The actor fetches the first thread page, saves results, then keeps requesting next pages when a cursor is returned, until your cap is reached or no more items are available.

Input

Field	Required	What it means
Tweet ID (tweetId)	Yes	The tweet id used to load the thread.
Maximum results (maxResults)	No	Upper bound on rows to collect across cursor pages (default 100).

Output

• One row per thread item (until your cap).
• Rows can include fields such as id_str, tweet_id, text, display_text, created_at, likes, retweets, replies, quotes, views, lang, source, entities, author, and media-related blocks when present.
• Actor context: each row includes seedTweetId and scrapedAt.

Field coverage depends on the specific tweet and can vary over time.

Sample output (one row, illustrative)

{
	"likes": 815,
	"created_at": "Fri Dec 22 08:01:21 +0000 2023",
	"status": "active",
	"text": "@elonmusk Gratitude is a musk thank you Elon https://t.co/8u6rbvMYKp",
	"retweets": 68,
	"bookmarks": 4,
	"quotes": 2,
	"display_text": "Gratitude is a musk thank you Elon",
	"replies": 145,
	"lang": "en",
	"views": "56905",
	"conversation_id": "1738106896777699464",
	"id": "1738107442452381976",
	"author": {
		"rest_id": "2800216425",
		"name": "THE CHELSEA FORUM",
		"screen_name": "TheChelseaForum",
		"description": "The Chelsea Forum ◇|◇ A community where all Chelsea fans call their home! 💙",
		"image": "https://pbs.twimg.com/profile_images/2030605354267025408/ND29IXzP_normal.jpg",
		"blue_verified": true,
		"can_dm": false,
		"sub_count": 264150
	},
	"entities": {
		"hashtags": [],
		"media": [
			{
				"allow_download_status": {
					"allow_download": true
				},
				"display_url": "pic.x.com/8u6rbvMYKp",
				"expanded_url": "https://x.com/TheChelseaForum/status/1738107442452381976/photo/1",
				"ext_media_availability": {
					"status": "Available"
				},
				"features": {
					"large": {
						"faces": [
							{
								"h": 182,
								"w": 182,
								"x": 212,
								"y": 20
							}
						]
					},
					"medium": {
						"faces": [
							{
								"h": 182,
								"w": 182,
								"x": 212,
								"y": 20
							}
						]
					},
					"orig": {
						"faces": [
							{
								"h": 182,
								"w": 182,
								"x": 212,
								"y": 20
							}
						]
					},
					"small": {
						"faces": [
							{
								"h": 182,
								"w": 182,
								"x": 212,
								"y": 20
							}
						]
					}
				},
				"id_str": "1738107408629542912",
				"indices": [
					45,
					68
				],
				"media_key": "3_1738107408629542912",
				"media_results": {
					"result": {
						"media_key": "3_1738107408629542912"
					}
				},
				"media_url_https": "https://pbs.twimg.com/media/GB7_erDWsAAeTs2.jpg",
				"original_info": {
					"focus_rects": [
						{
							"h": 357,
							"w": 638,
							"x": 0,
							"y": 252
						},
						{
							"h": 637,
							"w": 637,
							"x": 1,
							"y": 0
						},
						{
							"h": 637,
							"w": 559,
							"x": 79,
							"y": 0
						},
						{
							"h": 637,
							"w": 319,
							"x": 271,
							"y": 0
						},
						{
							"h": 637,
							"w": 638,
							"x": 0,
							"y": 0
						}
					],
					"height": 637,
					"width": 638
				},
				"sizes": {
					"large": {
						"h": 637,
						"resize": "fit",
						"w": 638
					},
					"medium": {
						"h": 637,
						"resize": "fit",
						"w": 638
					},
					"small": {
						"h": 637,
						"resize": "fit",
						"w": 638
					},
					"thumb": {
						"h": 150,
						"resize": "crop",
						"w": 150
					}
				},
				"type": "photo",
				"url": "https://t.co/8u6rbvMYKp"
			}
		],
		"symbols": [],
		"timestamps": [],
		"urls": [],
		"user_mentions": [
			{
				"id_str": "44196397",
				"indices": [
					0,
					9
				],
				"name": "Elon Musk",
				"screen_name": "elonmusk"
			}
		]
	},
	"media": {
		"photo": [
			{
				"media_url_https": "https://pbs.twimg.com/media/GB7_erDWsAAeTs2.jpg",
				"id": "1738107408629542912"
			}
		]
	},
	"seedTweetId": "1738106896777699464",
	"scrapedAt": "2026-03-27T02:57:06.243Z"
}