Threads Search Post Scraper

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

Field	Type	Required	Notes
text	string[]	No	Search query. Empty → still do 1 filtered search.
before_date	string	No	Format YYYY-MM-DD.
after_date	string	No	Format YYYY-MM-DD.
from_author	string	No	Threads username without @.
timeoutMs	number	No	Per-request timeout (default 15000 ms).
raw	boolean	No	false = normalized output, true = return raw JSON in posts.

---

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.