Threads Search Post Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

Search public Threads posts via threads.com/search and export thread-level results (with all posts in each thread) into your Apify Dataset and Key-Value Store.

Supports two modes:

• Normalized mode (raw: false, mặc định) → trả về post đã được chuẩn hoá (text, mentions, links, images, videos, carousel…)
• Raw mode (raw: true) → giữ nguyên JSON 100% gốc từ Threads trong mỗi post, nhưng vẫn chia theo thread (root_post + posts)

What this actor does

• Accepts:

  • text queries (string or array)
  • optional date filters (before_date, after_date)
  • optional author filter (from_author)
  • optional raw mode

• Groups results by thread:

  • one dataset item per thread
  • includes root_post and full posts[] of that thread

• Works on public content, no login or cookies required

Input

Example input

{
"text":["te","hola"],
"before_date":"2025-11-12",
"after_date":"2025-11-01",
"from_author":"taylorswift",
"raw":false
}

Behavior

• If text is a string → run one search
• If text is missing or empty → still runs one filtered search

Input fields

Output

The actor outputs dataset items and a SUMMARY.json.

Mode A — Normalized Output (raw: false)

This is the default mode.

Example thread item

{
"type":"thread",
"thread_id":"3763948739171019822",
"query":"te",
"root_post":{
"id":"3763948739171019822_63028951785",
"pk":"3763948739171019822",
"user":{
"id":"63028951785",
"username":"_sebastiansantillan",
"full_name":"Sebastián",
"is_verified":true,
"profile_pic_url":"https://cdn.example/img.jpg"
},
"text":"Hola 🫣❤️",
"mentions":[],
"links":[],
"images":[],
"videos":[],
"carousel_media":[],
"taken_at":1762917676,
"code":"DQ8O2-fEWwu"
},
"posts":[
{
"id":"3763948739171019822_63028951785",
"text":"Hola 🫣❤️",
"images":[],
"videos":[],
"mentions":[],
"links":[],
"like_count":133
}
]
}

Notes for normalized mode

• Post objects include parsed:

  • text
  • mentions
  • links
  • images
  • videos
  • carousel_media

• Unused or complex fields are removed for easier use.

Mode B — Raw Output (raw: true)

Example thread_raw item

{
"type":"thread_raw",
"thread_id":"3769183267498058314",
"query":"meta",
"root_post":{
/* FULL unmodified Threads JSON for root post */
},
"posts":[
{
/* raw post #1 */
},
{
/* raw post #2 (reply) */
}
]
}

SUMMARY.json

For raw: false:

{
"totalSearches":2,
"totalThreads":10,
"totalPosts":25,
"text":["te","hola"],
"raw":false,
"collectedAt":"2025-11-12T14:05:10.789Z"
}

For raw: true:

{
"totalSearches":2,
"totalThreads":null,
"totalPosts":null,
"text":["te","hola"],
"raw":true,
"collectedAt":"2025-11-12T14:05:10.789Z"
}

Quick start (no code)

1. Open the actor on Apify and click Run

2. Paste your JSON input

3. Start the run

4. View results in:

   • Dataset → thread items
   • Key-Value Store → SUMMARY.json

API Usage

Start a run

curl-X POST "https://api.apify.com/v2/acts/trantus~threads-search-post-scraper/runs?token=YOUR_TOKEN"\
-H"Content-Type: application/json"\
-d'{
 "text": "meta",
 "raw": true
 }'

Fetch the dataset

$curl"https://api.apify.com/v2/acts/trantus~threads-search-post-scraper/runs/last/dataset/items?token=YOUR_TOKEN"

Changelog

• 1.1.0

  • Added raw mode (raw: true)
  • New dataset item type: thread_raw
  • Normalized/Raw modes consolidated in core scraper logic

• 1.0.0 Initial release.