Threads Search Post Scraper

🧵 Search public Threads posts with focused filters

Researchers, marketers, and developers can search public Threads posts by keyword or hashtag, or look up known posts by URL or numeric ID. The Actor saves structured rows with post text, public author details, publication time, available engagement counts, source links, and related public data, so you can review Threads search results in an Apify dataset.

• Collect a public Threads post with the Threads Post Scraper example.
• Find public posts under a tag with the Threads Hashtag Search example.
• Search public Threads posts for a phrase with the Threads Post Search example.
• Look up a public Threads post by URL or ID with the Threads Post Lookup example.
• Review public Threads search matches with the Threads Search example.

📊 Structured Threads post data

What you get

The default output is one normalized row for each saved public post. It includes the post text, author, publication time, available engagement counts, media, mentions, hashtags, outbound links, quote or repost links, conversation links, and public replies when Threads embeds them on a targeted post page. Turn on detailed source data to add selected source-level fields from Threads to the same row.

Fields that Threads does not show are omitted. The Actor handles public posts only. It does not promise a historical archive or a complete reply tree when replies are not present on the public post page.

▶️ Run a public Threads search or lookup

How it works

1. Choose Keyword, Hashtag, or Post URL or ID.
2. Enter one or more keywords, hashtags, public post URLs, or numeric post IDs in the matching field.
3. For keyword and hashtag searches, choose Recent first or Relevance or top. You can also set a UTC date range, a recent-days window, or a public author.
4. Set Maximum posts when you want a smaller run. Leave it empty to return all available results until the source is exhausted.
5. Turn on Include detailed source data when you need the selected source-level fields alongside normalized data.

Focused runs

Keyword and hashtag lists use one shared sort, date, author, and post limit setting. Use separate runs when searches need independent settings. A direct post lookup accepts public URLs or numeric IDs and ignores search sorting, date, and author filters. You do not need to provide a source credential for public data, but private content is not covered.

Where results go

The Actor saves successful public post rows to the standard Apify dataset and exposes that dataset through the run output and API. A post ID and source URL help you trace each row back to its public Threads post.

⚙️ Input

Input fields

Field	Type	What it does
findPostsBy	string	Select keyword, hashtag, or post to choose the target field.
keywords	array of strings	For keyword, enter one or more words or phrases. The same sort and post limit apply to every submitted keyword.
hashtags	array of strings	For hashtag, enter one or more hashtags with or without #. The same sort and post limit apply to every submitted hashtag.
postTargets	array of strings	For post, enter one or more public Threads post URLs or numeric post IDs. The same post limit and output setting apply to every submitted post.
sortOrder	string	For keyword and hashtag searches, choose recent or top. Direct post lookups ignore this field.
publicationDate	object	For keyword and hashtag searches, use a UTC date range or a recent-days window. Direct post lookups ignore this field.
publicationDate.fromDate	UTC date string	First publication date to include in a date range.
publicationDate.toDate	UTC date string	Last publication date to include in a date range.
publicationDate.recentDays	positive integer	Include posts published in this many days before the run.
author	string	For keyword and hashtag searches, enter a public Threads username with or without @. Direct post lookups ignore this field.
maxItems	positive integer	Optional run limit. Leave it empty to return all available results until the source is exhausted.
includeSourceData	boolean	Add selected detailed source-level fields alongside the normalized post data.

Example input

The following small input uses a keyword search, recent ordering, one-post limit, and normalized output.

{
  "findPostsBy": "keyword",
  "keywords": [
    "OpenAI"
  ],
  "sortOrder": "recent",
  "maxItems": 1,
  "includeSourceData": false
}

🧾 Output

Run output

Field	Type	What it does
dataset	URL string	Links to the dataset containing successful public Threads post rows.

The dataset contains normalized post rows by default. When includeSourceData is true, the same normalized fields remain and a source object is added.

Normalized public post row

The table below is complete for a row without detailed source data. Optional fields appear only when Threads provides them.

Field	Type	What it does
postId	string	Stable public ID of the Threads post.
postUrl	string (URI)	Public Threads URL for the post.
text	string, optional	Text shown in the post. Omitted when the post has no text.
author	object	Public author details.
author.id	string	Stable public ID of the author.
author.username	string	Public Threads username of the author.
author.displayName	string, optional	Public display name when shown.
author.isVerified	boolean, optional	Whether Threads marks the author as verified.
publishedAt	date-time string	Time when Threads published the post.
engagement	object, optional	Public engagement counts shown for the post.
engagement.likeCount	integer, optional	Public number of likes.
engagement.replyCount	integer, optional	Public number of replies.
engagement.repostCount	integer, optional	Public number of reposts.
engagement.quoteCount	integer, optional	Public number of quote posts.
engagement.viewCount	integer, optional	Public number of views when Threads shows it.
media	array of objects, optional	Image or video attachments shown in the post. A carousel uses multiple media items.
media[].type	string	Media type, either image or video.
media[].url	string (URI), optional	Direct source URL when Threads exposes one that users can open.
media[].altText	string, optional	Alternative text for the media item when available.
media[].width	integer, optional	Media width in pixels when available.
media[].height	integer, optional	Media height in pixels when available.
media[].durationSeconds	number, optional	Video duration in seconds when available.
mentions	array of objects, optional	Accounts mentioned in the post text.
mentions[].username	string	Mentioned public username.
mentions[].id	string, optional	Mentioned public account ID when available.
hashtags	array of strings, optional	Hashtags found in the post text.
outboundLinks	array of strings, optional	Links to other sites found in the post text.
quotedPost	object, optional	Public post quoted by this post when Threads provides the link.
quotedPost.postId	string	Stable ID of the quoted post.
quotedPost.postUrl	string (URI)	Public URL of the quoted post.
repostedPost	object, optional	Public post reposted by this post when Threads provides the link.
repostedPost.postId	string	Stable ID of the reposted post.
repostedPost.postUrl	string (URI)	Public URL of the reposted post.
conversation	object, optional	Source and parent links when this row is a reply.
conversation.rootPostId	string	Stable ID of the first post in the conversation.
conversation.rootPostUrl	string (URI)	Public URL of the first post in the conversation.
conversation.parentPostId	string	Stable ID of the post this reply directly answers.
conversation.parentPostUrl	string (URI)	Public URL of the post this reply directly answers.
replies	array of objects, optional	Public replies embedded on a targeted post page.
replies[].postId	string	Stable public ID of the reply.
replies[].postUrl	string (URI)	Public URL for the reply.
replies[].text	string, optional	Text shown in the reply. Omitted when the reply has no text.
replies[].author	object	Public author details for the reply.
replies[].author.id	string	Stable public ID of the reply author.
replies[].author.username	string	Public Threads username of the reply author.
replies[].author.displayName	string, optional	Public display name when shown.
replies[].author.isVerified	boolean, optional	Whether Threads marks the reply author as verified.
replies[].publishedAt	date-time string	Time when Threads published the reply.
replies[].engagement	object, optional	Public engagement counts shown for the reply.
replies[].engagement.likeCount	integer, optional	Public number of likes on the reply.
replies[].engagement.replyCount	integer, optional	Public number of replies to the reply.
replies[].engagement.repostCount	integer, optional	Public number of reposts of the reply.
replies[].engagement.quoteCount	integer, optional	Public number of quote posts for the reply.
replies[].engagement.viewCount	integer, optional	Public number of views for the reply when Threads shows it.
replies[].media	array of objects, optional	Image or video attachments shown in the reply.
replies[].media[].type	string	Reply media type, either image or video.
replies[].media[].url	string (URI), optional	Direct reply media URL when Threads exposes one that users can open.
replies[].media[].altText	string, optional	Alternative text for the reply media when available.
replies[].media[].width	integer, optional	Reply media width in pixels when available.
replies[].media[].height	integer, optional	Reply media height in pixels when available.
replies[].media[].durationSeconds	number, optional	Reply video duration in seconds when available.
replies[].mentions	array of objects, optional	Accounts mentioned in the reply text.
replies[].mentions[].username	string	Mentioned username in the reply.
replies[].mentions[].id	string, optional	Mentioned public account ID when available.
replies[].hashtags	array of strings, optional	Hashtags found in the reply text.
replies[].outboundLinks	array of strings, optional	Links to other sites found in the reply text.
replies[].conversation	object	Source and parent links for the reply.
replies[].conversation.rootPostId	string	Stable ID of the first post in the reply conversation.
replies[].conversation.rootPostUrl	string (URI)	Public URL of the first post in the reply conversation.
replies[].conversation.parentPostId	string	Stable ID of the post this reply directly answers.
replies[].conversation.parentPostUrl	string (URI)	Public URL of the post this reply directly answers.
replies[].quotedPost	object, optional	Public post quoted by the reply when Threads provides the link.
replies[].quotedPost.postId	string	Stable ID of the post quoted by the reply.
replies[].quotedPost.postUrl	string (URI)	Public URL of the post quoted by the reply.
replies[].repostedPost	object, optional	Public post reposted by the reply when Threads provides the link.
replies[].repostedPost.postId	string	Stable ID of the post reposted by the reply.
replies[].repostedPost.postUrl	string (URI)	Public URL of the post reposted by the reply.

Example normalized row

This is a genuine row from a successful run with detailed source data turned off.

{
  "postId": "3966878386803679869_63477724337",
  "postUrl": "https://www.threads.com/@legalmiga/post/DcNLuAYm6J9",
  "author": {
    "id": "63477724337",
    "username": "legalmiga",
    "displayName": "Taylor M. Tieman, Esq. | Business + Trademark Lawyer",
    "isVerified": true
  },
  "publishedAt": "2026-08-19T03:06:15.000Z",
  "text": "today, @openai launched a teen mode for chatGPT\n\non this episode of \"what could go wrong?!\"\n\n...",
  "engagement": {
    "likeCount": 123,
    "replyCount": 13,
    "repostCount": 7,
    "quoteCount": 0
  },
  "mentions": [
    {
      "username": "openai",
      "id": "63299409527"
    }
  ]
}

Detailed public post row

When includeSourceData is true, the row keeps every normalized field above and adds the source branch below. The table repeats the shared fields so this shape is complete.

Field	Type	What it does
postId	string	Stable public ID of the Threads post.
postUrl	string (URI)	Public Threads URL for the post.
text	string, optional	Text shown in the post. Omitted when the post has no text.
author	object	Public author details.
author.id	string	Stable public ID of the author.
author.username	string	Public Threads username of the author.
author.displayName	string, optional	Public display name when shown.
author.isVerified	boolean, optional	Whether Threads marks the author as verified.
publishedAt	date-time string	Time when Threads published the post.
engagement	object, optional	Public engagement counts shown for the post.
engagement.likeCount	integer, optional	Public number of likes.
engagement.replyCount	integer, optional	Public number of replies.
engagement.repostCount	integer, optional	Public number of reposts.
engagement.quoteCount	integer, optional	Public number of quote posts.
engagement.viewCount	integer, optional	Public number of views when Threads shows it.
media	array of objects, optional	Image or video attachments shown in the post.
media[].type	string	Media type, either image or video.
media[].url	string (URI), optional	Direct source URL when Threads exposes one that users can open.
media[].altText	string, optional	Alternative text for the media item when available.
media[].width	integer, optional	Media width in pixels when available.
media[].height	integer, optional	Media height in pixels when available.
media[].durationSeconds	number, optional	Video duration in seconds when available.
mentions	array of objects, optional	Accounts mentioned in the post text.
mentions[].username	string	Mentioned public username.
mentions[].id	string, optional	Mentioned public account ID when available.
hashtags	array of strings, optional	Hashtags found in the post text.
outboundLinks	array of strings, optional	Links to other sites found in the post text.
quotedPost	object, optional	Public post quoted by this post when Threads provides the link.
quotedPost.postId	string	Stable ID of the quoted post.
quotedPost.postUrl	string (URI)	Public URL of the quoted post.
repostedPost	object, optional	Public post reposted by this post when Threads provides the link.
repostedPost.postId	string	Stable ID of the reposted post.
repostedPost.postUrl	string (URI)	Public URL of the reposted post.
conversation	object, optional	Source and parent links when this row is a reply.
conversation.rootPostId	string	Stable ID of the first post in the conversation.
conversation.rootPostUrl	string (URI)	Public URL of the first post in the conversation.
conversation.parentPostId	string	Stable ID of the post this reply directly answers.
conversation.parentPostUrl	string (URI)	Public URL of the post this reply directly answers.
replies	array of objects, optional	Public replies embedded on a targeted post page.
replies[].postId	string	Stable public ID of the reply.
replies[].postUrl	string (URI)	Public URL for the reply.
replies[].text	string, optional	Text shown in the reply. Omitted when the reply has no text.
replies[].author	object	Public author details for the reply.
replies[].author.id	string	Stable public ID of the reply author.
replies[].author.username	string	Public Threads username of the reply author.
replies[].author.displayName	string, optional	Public display name when shown.
replies[].author.isVerified	boolean, optional	Whether Threads marks the reply author as verified.
replies[].publishedAt	date-time string	Time when Threads published the reply.
replies[].engagement	object, optional	Public engagement counts shown for the reply.
replies[].engagement.likeCount	integer, optional	Public number of likes on the reply.
replies[].engagement.replyCount	integer, optional	Public number of replies to the reply.
replies[].engagement.repostCount	integer, optional	Public number of reposts of the reply.
replies[].engagement.quoteCount	integer, optional	Public number of quote posts for the reply.
replies[].engagement.viewCount	integer, optional	Public number of views for the reply when Threads shows it.
replies[].media	array of objects, optional	Image or video attachments shown in the reply.
replies[].media[].type	string	Reply media type, either image or video.
replies[].media[].url	string (URI), optional	Direct reply media URL when Threads exposes one that users can open.
replies[].media[].altText	string, optional	Alternative text for the reply media when available.
replies[].media[].width	integer, optional	Reply media width in pixels when available.
replies[].media[].height	integer, optional	Reply media height in pixels when available.
replies[].media[].durationSeconds	number, optional	Reply video duration in seconds when available.
replies[].mentions	array of objects, optional	Accounts mentioned in the reply text.
replies[].mentions[].username	string	Mentioned username in the reply.
replies[].mentions[].id	string, optional	Mentioned public account ID when available.
replies[].hashtags	array of strings, optional	Hashtags found in the reply text.
replies[].outboundLinks	array of strings, optional	Links to other sites found in the reply text.
replies[].conversation	object	Source and parent links for the reply.
replies[].conversation.rootPostId	string	Stable ID of the first post in the reply conversation.
replies[].conversation.rootPostUrl	string (URI)	Public URL of the first post in the reply conversation.
replies[].conversation.parentPostId	string	Stable ID of the post this reply directly answers.
replies[].conversation.parentPostUrl	string (URI)	Public URL of the post this reply directly answers.
replies[].quotedPost	object, optional	Public post quoted by the reply when Threads provides the link.
replies[].quotedPost.postId	string	Stable ID of the post quoted by the reply.
replies[].quotedPost.postUrl	string (URI)	Public URL of the post quoted by the reply.
replies[].repostedPost	object, optional	Public post reposted by the reply when Threads provides the link.
replies[].repostedPost.postId	string	Stable ID of the post reposted by the reply.
replies[].repostedPost.postUrl	string (URI)	Public URL of the post reposted by the reply.
source	object	Selected public fields returned by Threads when detailed source data is requested.
source.id	string	Source identifier for the post.
source.code	string, optional	Short code Threads uses for the post when available.
source.canonicalUrl	string (URI), optional	Canonical post URL supplied by Threads when available.
source.caption	string, optional	Post text supplied by Threads when available.
source.takenAt	number	Publication time as a Unix timestamp in seconds.
source.user	object	Author object supplied by Threads.
source.user.id	string	Source identifier for the author.
source.user.username	string	Source username for the author.
source.user.fullName	string, optional	Full name supplied by Threads when shown.
source.user.isVerified	boolean, optional	Whether Threads marks the source author as verified.
source.likeCount	integer, optional	Public like count supplied by Threads when available.
source.replyCount	integer, optional	Public reply count supplied by Threads when available.
source.repostCount	integer, optional	Public repost count supplied by Threads when available.
source.quoteCount	integer, optional	Public quote count supplied by Threads when available.
source.viewCount	integer, optional	Public view count supplied by Threads when available.
source.media	array of objects, optional	Selected media fields supplied by Threads for the post.
source.media[].type	string	Source media type, either image or video.
source.media[].url	string (URI), optional	Direct source media URL when available.
source.media[].altText	string, optional	Alternative text supplied by Threads when available.
source.media[].width	integer, optional	Source media width in pixels when available.
source.media[].height	integer, optional	Source media height in pixels when available.
source.media[].durationSeconds	number, optional	Source video duration in seconds when available.

Example detailed row

This is a genuine row from a successful run with detailed source data turned on.

{
  "postId": "3954859909900432925_40976579231",
  "postUrl": "https://www.threads.com/@anilbhawsar2963/post/DbifCJiDHYd",
  "author": {
    "id": "40976579231",
    "username": "anilbhawsar2963",
    "displayName": "Anil Bhawsar Jirafe",
    "isVerified": false
  },
  "publishedAt": "2026-08-02T13:07:41.000Z",
  "engagement": {
    "likeCount": 0,
    "replyCount": 0,
    "repostCount": 0,
    "quoteCount": 0
  },
  "media": [
    {
      "type": "video",
      "url": "https://media4.giphy.com/media/v1.Y2lkPWFlZWNjYzExdm8zcjFodzJrOWYyNjg0Y3M0bTNhNWlmNWNmanI2MTFnNHVmMTQ5NiZlcD12MV9naWZzX2dpZklkJmN0PWc/9nUtl7JLuXeg/200.gif",
      "altText": "Lady GIF",
      "width": 266,
      "height": 200
    }
  ],
  "conversation": {
    "rootPostId": "3932980370346228618_39283617667",
    "rootPostUrl": "https://www.threads.com/@snjuuu_p79/post/DaUwM8bEjuK",
    "parentPostId": "3932980370346228618_39283617667",
    "parentPostUrl": "https://www.threads.com/@snjuuu_p79/post/DaUwM8bEjuK"
  },
  "source": {
    "id": "3954859909900432925_40976579231",
    "takenAt": 1785676061,
    "user": {
      "id": "40976579231",
      "username": "anilbhawsar2963",
      "fullName": "Anil Bhawsar Jirafe",
      "isVerified": false
    },
    "code": "DbifCJiDHYd",
    "canonicalUrl": "https://www.threads.com/@anilbhawsar2963/post/DbifCJiDHYd",
    "likeCount": 0,
    "replyCount": 0,
    "repostCount": 0,
    "quoteCount": 0,
    "media": [
      {
        "type": "video",
        "url": "https://media4.giphy.com/media/v1.Y2lkPWFlZWNjYzExdm8zcjFodzJrOWYyNjg0Y3M0bTNhNWlmNWNmanI2MTFnNHVmMTQ5NiZlcD12MV9naWZzX2dpZklkJmN0PWc/9nUtl7JLuXeg/200.gif",
        "altText": "Lady GIF",
        "width": 266,
        "height": 200
      }
    ]
  }
}

💳 Pricing

Charged event

Post charges for one public Threads post saved to the dataset. The event applies to a successful post returned by the Actor.

How charging works

The Actor charges once for each public post it returns. A run that returns no post does not trigger this post event. Set Maximum posts to keep a run and its charge count focused, or leave it empty to collect all available results until the source is exhausted.

🔌 Integrations

Dataset and API

Read the results through the standard Apify dataset and API output. You can export the saved rows or connect them to a workflow from the run output.

❓ FAQ

What happens when I submit several keywords or hashtags?

The Actor searches every submitted value with one shared sort, date, author, and maximum-post setting. Use separate runs when each search needs different filters or limits.

Can I look up a post by URL or numeric ID?

Yes. Choose Post URL or ID and enter one or more public Threads URLs or numeric post IDs. Search sorting, date, and author filters do not apply to direct lookups.

Can I search private Threads posts?

No. The Actor covers the public search and public post-page surface only. It does not require a buyer-supplied Threads credential for that public data.

Will it collect every reply in a conversation?

It can include public replies embedded on a targeted post page. It does not promise a full reply tree or nested replies that the public page does not show.

What if Threads does not show a field?

That field is omitted from the row when it is optional and unavailable. For example, post text, media details, view counts, and engagement counts depend on what Threads exposes.

What does detailed source data add?

Set includeSourceData to true to add selected source-level fields such as the source ID, short code, canonical URL, caption, Unix publication time, source author, counts, and media data alongside the normalized fields.

How can I keep a run smaller?

Set Maximum posts to a positive number. For keyword and hashtag searches, you can also use a date range, a recent-days window, or an author filter. Leaving the limit empty returns all available results until the source is exhausted.

📝 Changelog

v0.0

• Initial release

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• Threads Replies Scraper: Collect public replies from Threads post or profile URLs with conversation context.
• Threads Video Downloader: Get direct source video links and available details from public Threads post URLs.
• Social Media Stats Checker: Check public Threads profile stats alongside other supported social profiles.
• Threads Search Post Scraper: Search public Threads results with text, dates, authors, and engagement data for research and monitoring.
• 🧵 Threads Search Post Scraper: Posts, Quotes & Replies: Review public Threads posts with quote and reply context for conversation research.

Made with ❤️ by Maxime Dupré