# Threads 留言爬蟲 (`futurizerush/threads-replies-scraper-zh-tw`) Actor 從 Threads 貼文擷取留言與評論，含作者資料、互動指標（按讚、留言、轉發、引用、分享、觀看）、媒體（網址、尺寸、無障礙說明）、引用/轉發識別、驗證徽章。批次處理多篇貼文，無需登入。適合幫助 Threads 海巡、輿情分析、對話研究、影響者分析。 - **URL**: https://apify.com/futurizerush/threads-replies-scraper-zh-tw.md - **Developed by:** [Rush](https://apify.com/futurizerush) (community) - **Categories:** AI, Agents, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Threads 留言爬蟲 從公開 Threads 貼文擷取第一層留言與評論，含作者資料、完整互動指標、媒體（網址、尺寸、無障礙說明）、引用/轉發識別、驗證徽章。支援批次處理多篇貼文，適合輿情分析、對話追蹤與影響者研究。 > **提醒**：網站結構偶有變動，可能短暫影響資料擷取。建議大批次執行前先以小量測試。 ### 你可以拿到什麼資料 #### 每則留言 | 欄位 | 說明 | |------|------| | **作者帳號** (`author_username`) | 留言者的 @帳號 | | **作者顯示名稱** (`author_display_name`) | 完整顯示名稱 | | **作者頭像** (`author_profile_pic_url` / `..._hd_url`) | 頭像網址（若 Threads 公開高解析度版本） | | **驗證狀態** (`author_is_verified`) | 是否擁有驗證徽章 | | **聯邦宇宙(Fediverse) 啟用** (`author_fediverse_enabled`) | 作者是否啟用 ActivityPub 跨平台分享 | | **留言內容** (`text_content`) | 完整留言文字（支援 emoji） | | **提及 / 標籤 / 連結** (`mentions` / `hashtags` / `urls`) | 從留言文字擷取 | | **發布時間** (`created_at` + `created_at_timestamp`) | ISO 時間 + Unix timestamp | | **互動指標** (`like_count` / `reply_count` / `repost_count` / `quote_count` / `share_count`) | 完整互動數據 | | **作者按讚** (`is_liked_by_author`) | 原貼文作者是否按讚此留言 | | **回覆對象** (`reply_to_username`) | 此留言回覆給誰 | | **媒體** (`has_media` / `media_type` / `media_url` / `media_urls`) | 圖片、影片、carousel 多媒體或純文字；主網址 + carousel 多檔網址 | | **是否為 GIF** (`is_gif`) | 留言為內嵌 GIF 時為 true，方便快速篩選 GIF 留言 | | **媒體尺寸** (`media_width` / `media_height`) | 原始寬高（像素） | | **音訊** (`has_audio`) | 是否包含音訊 | | **無障礙說明** (`accessibility_caption`) | 替代文字 — 圖片自動產生、GIF 自動帶入 Giphy 標題 | | **引用貼文** (`is_quote_post` / `quoted_post_url`) | 引用識別與目標網址 | | **轉發** (`is_repost` / `reposted_post_url`) | 轉發識別與原貼文網址 | | **贊助合作** (`is_paid_partnership`) | 是否標示為贊助 / 付費合作 | | **編輯狀態** (`is_edited`) | 貼文是否曾被編輯 | | **留言權限** (`reply_control`) | 誰可以留言（everyone / followers_only / mentioned_only） | | **留言網址** (`reply_url`) | 留言的直接連結 | | **擷取模式** (`extraction_mode`) | `json`（完整欄位）或 `dom`（後備模式，部分欄位為預設值） | | **原貼文網址** (`source_post_url`) | 此留言所屬的原貼文 | #### 每則原貼文 爬蟲也會擷取每篇被分析的原貼文，**主要欄位與留言相同**（作者、互動、媒體、引用/轉發、贊助等），並額外提供 **觀看次數** (`view_count`)（留言不公開觀看數）。留言獨有的欄位（`reply_id`、`reply_url`、`is_liked_by_author`、`reply_to_username`、`extraction_mode`）只會出現在留言項目。 ### 如何使用 #### 輸入 | 參數 | 必填 | 預設 | 說明 | |------|:---:|:---:|------| | `post_urls` | ✓ | - | 一個或多個 Threads 貼文網址 | | `max_replies` | ✗ | 50 | 每篇貼文要擷取的留言數量上限（10-50）。較低值可降低費用 | | `include_nested_replies` | ✗ | false | 設 `true` 時會額外擷取巢狀子留言（同對話中對其他留言者的回覆）。預設僅第一層 | #### 範例輸入 ```json { "post_urls": [ { "url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp" }, { "url": "https://www.threads.com/@zuck/post/DSVRshjkbtK" } ] } ```` ### 輸出範例 所有資料儲存到 dataset。每筆記錄都有 `item_type` 欄位（`original_post` 或 `reply`）以及 `source_post_url` 欄位以辨別所屬貼文。 #### 原貼文 ```json { "item_type": "original_post", "source_post_url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp", "post_code": "DTa3-B1EbTp", "post_url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp", "author_username": "zuck", "author_display_name": "Mark Zuckerberg", "author_is_verified": true, "author_profile_pic_url": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-19/...", "author_profile_pic_hd_url": null, "author_profile_url": "https://www.threads.com/@zuck", "author_fediverse_enabled": false, "text_content": "Today we're establishing a new top-level initiative called Meta Compute...", "mentions": [], "hashtags": [], "urls": [], "created_at": "2026-01-12T18:00:30.000Z", "created_at_timestamp": 1768240830, "like_count": 2856, "reply_count": 960, "repost_count": 145, "quote_count": 38, "share_count": 239, "view_count": 480585, "has_media": false, "media_type": 19, "is_gif": false, "media_url": null, "media_urls": [], "media_width": 612, "media_height": 612, "has_audio": false, "accessibility_caption": null, "is_quote_post": false, "quoted_post_url": null, "is_repost": false, "reposted_post_url": null, "is_paid_partnership": false, "is_edited": false, "reply_control": "everyone", "scraped_at": "2026-04-26T08:08:00.870328Z" } ``` #### 留言 ```json { "item_type": "reply", "source_post_url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp", "reply_id": "DTa39_1EWf5", "author_username": "zuck", "author_display_name": "Mark Zuckerberg", "author_is_verified": true, "author_profile_pic_url": "https://scontent-iad6-1.cdninstagram.com/v/t51.82787-19/...", "author_profile_pic_hd_url": null, "author_profile_url": "https://www.threads.com/@zuck", "author_fediverse_enabled": false, "text_content": "Santosh will continue to lead our technical architecture, software stack, silicon...", "mentions": [], "hashtags": [], "urls": [], "created_at": "2026-01-12T18:00:30.000Z", "created_at_timestamp": 1768240830, "like_count": 961, "reply_count": 106, "repost_count": 48, "quote_count": 5, "share_count": 48, "is_liked_by_author": false, "reply_to_username": "zuck", "media_type": 19, "has_media": false, "is_gif": false, "media_url": null, "media_urls": [], "media_width": 612, "media_height": 612, "has_audio": false, "accessibility_caption": null, "is_quote_post": false, "quoted_post_url": null, "is_repost": false, "reposted_post_url": null, "is_paid_partnership": false, "is_edited": false, "reply_control": "everyone", "reply_url": "https://www.threads.com/@zuck/post/DTa39_1EWf5", "extraction_mode": "json", "scraped_at": "2026-04-26T08:08:02.921497Z" } ``` ### 應用場景 - **輿情分析**：分析公眾對發布、產品上線等議題的反應 - **對話追蹤**：監控特定主題或貼文下的討論 - **影響者研究**：研究影響者貼文的互動模式 - **市場研究**：蒐集真實使用者回饋與意見 - **內容策略**：找出哪類貼文最能引起互動 ### 支援的網址格式 - `https://www.threads.com/@username/post/CODE` - `https://threads.com/@username/post/CODE` - `https://www.threads.net/@username/post/CODE` ### 功能特色 - **批次擷取**：一次執行多篇貼文 - **對話模式**：預設僅第一層留言；開啟 `include_nested_replies` 可擷取完整巢狀對話 - **無需登入**：公開貼文不需驗證 - **結構化資料**：乾淨一致的輸出格式，可直接分析 - **錯誤容錯**：單篇失敗不影響其他批次 - **匯出選項**：JSON / CSV / Excel ### 限制 | 限制 | 說明 | |------|------| | **留言數量** | 取決於 Threads 對未登入訪客公開的內容範圍 | | **貼文類型** | 僅公開貼文（私人帳號無法存取） | | **留言層級** | 預設僅第一層；開啟 `include_nested_replies` 可額外擷取巢狀子留言 | ### 最佳實踐建議 1. **確認貼文公開**：請確保貼文來自公開帳號 2. **批次效率**：一次執行多篇貼文比分次執行更快 3. **依來源篩選**：用 `source_post_url` 將留言依原貼文分組 ### 輸出位置 執行完成後： - **Dataset**：所有資料集中匯出 - 用 `item_type` 篩選：`original_post` 或 `reply` - 用 `source_post_url` 依原貼文分組 - 切到「總覽」頁籤可看主要欄位 - **Key-Value Store**： - `OUTPUT`：執行摘要（貼文數、留言總數、耗時） - `PROGRESS`：執行中即時進度（已完成貼文數、已收集留言數、預估剩餘時間） ### 常見問題 **Q：為什麼擷取到的留言比貼文顯示的少？** A：Threads 對未登入訪客限制可見內容，這是平台限制。本工具擷取 Threads 公開可見的範圍，並受 `max_replies` 設定上限。 **Q：批次中某篇失敗會怎樣？** A：爬蟲會繼續處理剩餘貼文。執行完可在 OUTPUT 摘要查看成功 / 失敗統計。 **Q：批次執行需要多久？** A：時間視貼文活躍度與平台狀態而定。批次執行會在貼文之間加入短暫延遲以確保穩定。 **Q：可以拿到貼文所有留言嗎？** A：無法。Threads 需要登入才能看完整留言列表。本工具不需登入，因此僅能取得 Threads 對未登入者公開的範圍。 *** 由 [futurizerush](https://apify.com/futurizerush?fpr=rush) 開發 — 探索更多 Threads 與社群媒體爬蟲。 ### 免責聲明 本工具僅供教育與研究用途。使用者需自行確保使用方式符合所有適用的法律、規範與所存取平台的服務條款。開發者對所擷取資料的準確性、完整性或可靠性不作任何保證。資料是否可取得取決於平台的公開存取政策，可能隨時變動恕不另行通知。開發者不對因使用或誤用本工具產生的任何損害負責。 使用本工具即表示您同意： - 僅擷取公開可取得的資料 - 遵守流量限制與平台規範 - 自行負責所蒐集資料的使用方式 - 資料的準確性取決於平台所提供的內容 ### 支援 如遇問題或有任何建議，請於 Actor 頁面開啟 issue。 *** Threads 留言爬蟲, Threads 評論抓取, Threads 評論下載, Threads 留言 API, Threads 互動數據, 社群輿情分析, 社群評論監控, Threads 留言匯出, Threads 留言下載工具, Threads scraper, Threads replies scraper, Threads comments scraper, Meta Threads API, conversation analysis, sentiment tracking, engagement metrics, influencer research, social media monitoring, OpenClaw, Claude Code, Gemini, Antigravity, Codex, ChatGPT # Actor input Schema ## `post_urls` (type: `array`): 貼上一個或多個 Threads 貼文網址以擷取留言。 ## `max_replies` (type: `integer`): 每篇貼文要擷取的留言數量上限。設定較低可降低費用（僅需熱門留言時）。 ## `include_nested_replies` (type: `boolean`): 預設只擷取第一層留言（直接回覆原貼文者）。啟用後會額外擷取巢狀子留言（同對話串中針對其他留言者的回覆）。 ## Actor input object example ```json { "post_urls": [ { "url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp" }, { "url": "https://www.threads.com/@zuck/post/DSVRshjkbtK" } ], "max_replies": 50, "include_nested_replies": false } ``` # Actor output Schema ## `overview` (type: `string`): All scraped replies and original post data ## `runSummary` (type: `string`): Post counts, reply totals, and execution time # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "post_urls": [ { "url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp" }, { "url": "https://www.threads.com/@zuck/post/DSVRshjkbtK" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("futurizerush/threads-replies-scraper-zh-tw").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "post_urls": [ { "url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp" }, { "url": "https://www.threads.com/@zuck/post/DSVRshjkbtK" }, ] } # Run the Actor and wait for it to finish run = client.actor("futurizerush/threads-replies-scraper-zh-tw").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "post_urls": [ { "url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp" }, { "url": "https://www.threads.com/@zuck/post/DSVRshjkbtK" } ] }' | apify call futurizerush/threads-replies-scraper-zh-tw --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=futurizerush/threads-replies-scraper-zh-tw", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Threads 留言爬蟲", "description": "從 Threads 貼文擷取留言與評論，含作者資料、互動指標（按讚、留言、轉發、引用、分享、觀看）、媒體（網址、尺寸、無障礙說明）、引用/轉發識別、驗證徽章。批次處理多篇貼文，無需登入。適合幫助 Threads 海巡、輿情分析、對話研究、影響者分析。", "version": "0.0", "x-build-id": "8EpXKL3tfe1WLlcj5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/futurizerush~threads-replies-scraper-zh-tw/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-futurizerush-threads-replies-scraper-zh-tw", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/futurizerush~threads-replies-scraper-zh-tw/runs": { "post": { "operationId": "runs-sync-futurizerush-threads-replies-scraper-zh-tw", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/futurizerush~threads-replies-scraper-zh-tw/run-sync": { "post": { "operationId": "run-sync-futurizerush-threads-replies-scraper-zh-tw", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "post_urls" ], "properties": { "post_urls": { "title": "🔗 Threads 貼文網址", "type": "array", "description": "貼上一個或多個 Threads 貼文網址以擷取留言。", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "max_replies": { "title": "📊 每篇貼文最大留言數", "minimum": 10, "maximum": 50, "type": "integer", "description": "每篇貼文要擷取的留言數量上限。設定較低可降低費用（僅需熱門留言時）。", "default": 50 }, "include_nested_replies": { "title": "💬 包含巢狀子留言", "type": "boolean", "description": "預設只擷取第一層留言（直接回覆原貼文者）。啟用後會額外擷取巢狀子留言（同對話串中針對其他留言者的回覆）。", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```