Threads Replies Scraper API
Pricing
from $1.00 / 1,000 results
Scrape Threads replies (comments): reply text, likes, reposts, author details and media, with nested replies on request. Requires a Threads Session ID.
Item Type
item_type
Optional
"post" for the item you submitted, "reply" for each reply collected under it
Source URL
sourceUrl
Optional
The post you submitted that this item belongs to, in its standard form, so rows from one run group by it. The run log names the same post as @handle/post/CODE.
Post ID
postId
Optional
Threads identifier of the item you submitted. Populated for item_type: post; null for item_type: reply.
Reply ID
replyId
Optional
Threads identifier of this reply. Populated for item_type: reply; null for item_type: post. The same reply can be listed under each submitted link it belongs to (for example when you submit both a post and one of its replies), so use sourceUrl together with replyId as a row's key.
Shortcode
postCode
Optional
Shortcode of this row's own item: on a post row, the item you submitted (the shortcode in sourceUrl); on a reply row, the reply's own shortcode, not the one in sourceUrl — group a post's replies by sourceUrl
Post URL
postUrl
Optional
Direct link to this item, under its author's handle. May differ from sourceUrl when the link you submitted used a different handle. Filled for item_type: post; empty for item_type: reply.
Reply URL
replyUrl
Optional
Direct link to the reply. Filled for item_type: reply; empty for item_type: post.
Text
text
Optional
Full text of the post or reply. Empty when it has no words of its own, such as a GIF, a photo or a quoted post on its own.
Mentions
mentions
Optional
Mentioned users (@username) found in the text, in lower case
Mentioned Accounts
mentionedAccounts
Optional
Accounts Threads itself recognised in the text, each with its account identifier where one is given. Handles here are written without the leading @, while the Mentions column keeps it. The Mentions column lists every @handle written in the text, including any Threads did not recognise, so the two are read together rather than one instead of the other.
URLs
urls
Optional
Every link the row carries: the ones Threads itself recognised and linked, the ones written plainly in the text, and the destination behind an attached link card. A link is listed once when both routes spell it the same; when the text and the card spell it differently, for example with and without a tracking code, both are listed.
Link Title
linkTitle
Optional
Title shown on an attached link card, when the item has one
Language
language
Optional
The language Threads read this text in, such as zh_TW. It is Threads' own reading and can be wrong. Empty when Threads stated none — which is not the same as the text having no language.
Username
username
Optional
Author's username
User ID
userId
Optional
Author's user ID
Profile URL
profileUrl
Optional
Link to the author's Threads profile
Profile Picture
profilePicUrl
Optional
Link to the author's profile picture. Time-limited by Threads — save the image soon after the run rather than keeping the link
Verified
isVerified
Optional
Whether the author has a verified badge. Reads false when Threads states nothing.
Display Name
displayName
Optional
Author's display name, as shown on their profile. Empty when Threads gives none.
Date
timestamp
Optional
When the post or reply was created (ISO 8601)
Posted (Unix time)
timestampUnix
Optional
The same instant as Date, as Unix time (seconds since 1970), so you can sort or join on it without parsing a date.
Edited
isEdited
Optional
Whether the text has been edited since it was posted. Reads false when Threads states nothing.
Who Can Reply
replyControl
Optional
Who the author allows to reply, in Threads' own words, for example everyone. Other settings come through as Threads writes them.
Is Quote Post
isQuotePost
Optional
True when this row quotes another Threads post.
Quoted Post URL
quotedPostUrl
Optional
Link to the post this one quotes. Empty when it quotes nothing, and also when the quoted post is no longer available.
Likes
likeCount
Optional
Number of likes
Reply Count
replyCount
Optional
Number of direct replies Threads reports for this item. It is what Threads displays, not a count of the rows you will get: a finished run can save fewer, because Threads' own list can end before that number, and nested replies can make it more.
Reposts
repostCount
Optional
Number of reposts
Quotes
quoteCount
Optional
Number of quote posts
Views
viewCount
Optional
How many views Threads states for the post you submitted, on that post's own row. Empty on reply rows, and when Threads states none.
Liked by Original Poster
isLikedByAuthor
Optional
Whether the author of the thread's original post liked this item, as Threads reports it. Reads false when Threads states nothing.
Pinned to Parent Post
isPinnedByAuthor
Optional
Whether the author of the post above pinned this reply to it, as Threads reports it. Empty when Threads does not say.
Replying To
replyToUsername
Optional
Username of the person this item is directed at. Populated when the item is itself a reply, including the item_type: post row when you submitted a reply link.
Depth
depth
Optional
Depth within these results. 0 = the item you submitted, 1 = a direct reply to it, 2+ = a nested reply
Parent Reply ID
parentReplyId
Optional
The replyId of the parent reply this is responding to. Empty for original posts and for direct replies (which answer the item_type: post row), and when Threads did not identify the parent — select direct replies with depth = 1.
Media Type
mediaType
Optional
Type of media: text, photo, video, carousel or gif; text means no media is attached, even when the row has no words of its own. Empty when Threads uses a format this Actor does not recognise; any links this Actor could read are in Media URLs.
Is GIF
isGif
Optional
True when the attachment is an embedded GIF, so you can filter GIF replies without inspecting the media URL.
Spoiler
isSpoiler
Optional
Whether the author hid this row's media behind a spoiler cover, as Threads reports it. Empty when Threads does not say.
Media URL
mediaUrl
Optional
Link to the main media attachment. A photo or video link is time-limited by Threads — save the file soon after the run rather than keeping the link; a GIF's link points to the service that hosts the GIF. For carousel posts, this is the first slide that has a link. Empty for text-only posts.
Media URLs
mediaUrls
Optional
Links to every media attachment. Photo and video links are time-limited by Threads — save the files soon after the run rather than keeping the links; a GIF's link points to the service that hosts the GIF. For carousel posts, one link per slide, in order; a slide without a link is left out. Empty array for text-only posts.
Media Width
mediaWidth
Optional
Width in pixels of the primary media attachment. Null for text-only items.
Media Height
mediaHeight
Optional
Height in pixels of the primary media attachment. Null for text-only items.
Has Audio
hasAudio
Optional
Whether Threads reports audio for this row. Empty means Threads said nothing about audio, not that there is none.
Image Description
accessibilityCaption
Optional
Threads' own description of the attached image, when there is one — for example a credit line followed by what Threads could make out in the picture. For a post with several images, this is the first one that carries a description; the rest are still listed in Media URLs
Position
index
Optional
Reply position within this post's results (1-based). Empty for item_type: post.
Collected At
scrapedAt
Optional
When this row was collected (ISO 8601).
