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 json { "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 json { "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 json { "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: json { "totalSearches": 2, "totalThreads": 10, "totalPosts": 25, "text": ["te", "hola"], "raw": false, "collectedAt": "2025-11-12T14:05:10.789Z" } For raw: true: json { "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 bash 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 bash 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.