Threads 留言爬蟲

從公開 Threads 貼文擷取留言與評論。預設收集第一層留言，可選擇一併擷取公開可見的巢狀子留言。包含作者資料、公開可取得的互動指標、媒體資訊、引用/轉發訊號與驗證徽章。支援一次處理多篇貼文，適合輿情分析、對話追蹤與影響者研究。

提醒：網站結構偶有變動，可能短暫影響資料擷取。建議大批次執行前先以小量測試。

你可以拿到什麼資料

每則留言

欄位	說明
作者帳號 (author_username)	留言者的 @帳號
作者帳號 ID (author_user_id)	公開的數字帳號識別碼，可取得時適合用於資料串接（公開檢視未提供時為 null）
作者顯示名稱 (author_display_name)	公開顯示名稱
作者頭像 (author_profile_pic_url)	標準解析度頭像網址（貼文頁面很少提供高解析度版本，因此 author_profile_pic_hd_url 通常為 null）
作者個人頁網址 (author_profile_url)	作者 Threads 個人頁的連結
驗證狀態 (author_is_verified)	是否擁有驗證徽章
聯邦宇宙(Fediverse) 啟用 (author_fediverse_enabled)	作者是否公開顯示 ActivityPub 分享標記。公開檢視未提供該訊號時為 null——null 代表未知，不代表未啟用
留言內容 (text_content)	公開可取得的留言文字（支援 emoji）
提及 / 標籤 (mentions / hashtags)	從留言文字擷取
連結 (urls)	這則留言帶有的所有網址——包含文字中的外部或 Threads 連結，以及分享連結預覽卡背後的網址，每個只列一次
被標記帳號 (mentioned_accounts)	Threads 實際標記的帳號，附帳號名稱與數字帳號識別碼（可取得時）
連結卡標題 (link_title)	分享連結的預覽卡標題（未分享連結時為空字串）
語言 (language)	Threads 判讀這則留言所使用的語言，例如 zh_TW 或 ja——可用來區分不同市場的對話。Threads 只會標示部分留言，因此這個欄位常常是空的
發布時間 (created_at + created_at_timestamp)	ISO 時間 + Unix timestamp；公開檢視未提供時間時分別為空字串與 null
互動指標 (like_count / reply_count / repost_count / quote_count / share_count)	公開可取得的互動數據；null 代表公開檢視未提供該指標，0 代表平台確實公布為零
作者按讚 (is_liked_by_author)	原貼文作者是否按讚此留言
回覆對象 (reply_to_username)	此留言回覆給誰
媒體 (has_media / media_url / media_urls)	留言是否含媒體、主媒體網址與 carousel 多檔網址。簡單篩選請用 has_media 與 is_gif
是否為 GIF (is_gif)	留言為內嵌 GIF 時為 true，方便快速篩選 GIF 留言
媒體種類 (media_category)	人類可讀的媒體類型——text、photo、video、carousel、gif 或 other，最適合用來篩選
防雷遮罩 (is_spoiler)	作者是否將媒體隱藏在防雷（劇透）遮罩後
媒體尺寸 (media_width / media_height)	原始寬高（像素）
音訊 (has_audio)	貼文是否帶有音訊。null 代表 Threads 未公布音訊訊號——不代表沒有聲音
圖片替代文字 (accessibility_caption)	公開提供時的圖片描述（替代文字）
引用貼文 (is_quote_post / quoted_post_url)	引用識別與目標網址
轉發 (is_repost / reposted_post_url)	轉發識別與原貼文網址
贊助合作 (is_paid_partnership)	是否標示為贊助 / 付費合作
編輯狀態 (is_edited)	貼文是否曾被編輯
留言權限 (reply_control)	誰可以留言，依 Threads 提供的原始值（例如 everyone / followers_only / mentioned_only）
留言網址 (reply_url)	留言的直接連結
原貼文網址 (source_post_url)	此留言所屬的原貼文
擷取時間 (scraped_at)	此列資料的擷取時間（ISO 時間戳）

每則原貼文

爬蟲也會擷取每篇被分析的原貼文，主要欄位與留言相同（作者、互動、媒體、引用/轉發、贊助等），並可能包含 觀看次數 (view_count)——貼文頁面有公開時就會帶上，不限於影片貼文；頁面未公開時為 null，頁面同時帶有多個觀看數而無法判定屬於這篇貼文時也為 null——不會臆測數值。留言列不包含觀看數。留言獨有的欄位（reply_id、reply_url、is_liked_by_author、reply_to_username）只會出現在留言項目。

每筆 original_post 列還會帶有 已收集留言數 (collected_reply_count) 與 公開子集 (is_public_subset)。登出的公開檢視可能只回傳大型討論串的第一批，因此當貼文回報的留言數多於公開檢視實際提供的數量時 is_public_subset 為 true——讓你分辨「完整收集的小型討論串」與「大型討論串的樣本」。貼文未公布留言總數時為 null；本次未能為頁面上每則留言確定歸屬時也是 null——頁面未清楚標明歸屬的留言會被略過而非猜測，因此短少來自本次收集而非公開檢視。這本身不會讓該貼文失敗；只有在頁面本身無法讀取時，執行摘要才會把該貼文標為失敗。您自行設定的留言數上限不會使此旗標變為 true。頁面未標明回覆對象的留言會被計為回覆該貼文，因此啟用巢狀子留言時，此旗標為概略值。

如何使用

輸入

參數	必填	預設	說明
post_urls	✓	-	最多 20 個 Threads 貼文網址
max_replies	✗	50	每篇貼文要擷取的留言數量上限（10-50）。Threads 實際公開留言數可能少於此上限
include_nested_replies	✗	false	設 true 時會額外擷取執行當下公開可見的巢狀子留言。預設僅第一層；仍受公開可取得範圍與 max_replies 上限影響

範例輸入

{
  "post_urls": [
    { "url": "https://www.threads.com/@zuck/post/DTa3-B1EbTp" },
    { "url": "https://www.threads.com/@zuck/post/DSVRshjkbtK" },
    { "url": "https://www.threads.com/@mosseri/post/DZ5UXU0G-DX" }
  ]
}

輸出範例

所有資料儲存到 dataset。每筆記錄都有 item_type 欄位（original_post 或 reply）以及 source_post_url 欄位以辨別所屬貼文。留言列以 Threads 提供的 reply_id 作為主要識別碼，因此同時出現在多篇指定貼文下的留言只會儲存一次。以下輸出範例使用虛構佔位值。

原貼文

{
  "item_type": "original_post",
  "source_post_url": "https://www.threads.com/@example_creator/post/EXAMPLE01",
  "post_code": "EXAMPLE01",
  "post_url": "https://www.threads.com/@example_creator/post/EXAMPLE01",
  "author_username": "example_creator",
  "author_user_id": "1234567890",
  "author_display_name": "Example Creator",
  "author_is_verified": true,
  "author_profile_pic_url": "https://example.com/avatar.jpg",
  "author_profile_pic_hd_url": null,
  "author_profile_url": "https://www.threads.com/@example_creator",
  "author_fediverse_enabled": null,
  "text_content": "Sharing a product update and inviting public feedback...",
  "mentions": [],
  "mentioned_accounts": [],
  "hashtags": [],
  "urls": [],
  "link_title": "",
  "language": "",
  "created_at": "2026-01-12T18:00:30.000Z",
  "created_at_timestamp": 1768240830,
  "like_count": 285,
  "reply_count": 96,
  "collected_reply_count": 42,
  "is_public_subset": true,
  "repost_count": 14,
  "quote_count": 3,
  "share_count": 23,
  "view_count": null,
  "has_media": false,
  "media_category": "text",
  "is_gif": false,
  "is_spoiler": false,
  "media_url": null,
  "media_urls": [],
  "media_width": null,
  "media_height": null,
  "has_audio": null,
  "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:00Z"
}

留言

{
  "item_type": "reply",
  "source_post_url": "https://www.threads.com/@example_creator/post/EXAMPLE01",
  "reply_id": "REPLY01",
  "author_username": "example_commenter",
  "author_user_id": "9876543210",
  "author_display_name": "Example Commenter",
  "author_is_verified": true,
  "author_profile_pic_url": "https://example.com/avatar.jpg",
  "author_profile_pic_hd_url": null,
  "author_profile_url": "https://www.threads.com/@example_commenter",
  "author_fediverse_enabled": null,
  "text_content": "Thanks @example_creator — I would like to see more details about availability.",
  "mentions": ["example_creator"],
  "mentioned_accounts": [{ "username": "example_creator", "user_id": "1234567890" }],
  "hashtags": [],
  "urls": [],
  "link_title": "",
  "language": "",
  "created_at": "2026-01-12T18:00:30.000Z",
  "created_at_timestamp": 1768240830,
  "like_count": 96,
  "reply_count": 10,
  "repost_count": 4,
  "quote_count": 1,
  "share_count": 4,
  "is_liked_by_author": false,
  "reply_to_username": "example_creator",
  "media_category": "text",
  "has_media": false,
  "is_gif": false,
  "is_spoiler": false,
  "media_url": null,
  "media_urls": [],
  "media_width": null,
  "media_height": null,
  "has_audio": null,
  "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/@example_commenter/post/REPLY01",
  "scraped_at": "2026-04-26T08:08:02Z"
}

應用場景

• 輿情分析：分析公眾對發布、產品上線等議題的反應
• 對話追蹤：監控特定主題或貼文下的討論
• 影響者研究：研究影響者貼文的互動模式
• 市場研究：蒐集真實使用者回饋與意見
• 內容策略：找出哪類貼文最能引起互動

支援的網址格式

• https://www.threads.com/@username/post/CODE
• https://threads.com/@username/post/CODE
• https://www.threads.net/@username/post/CODE
• https://threads.net/@username/post/CODE

分享連結（https://www.threads.com/share/CODE，也就是手機分享按鈕產生的形式）同樣可用，系統會自動解析成它指向的貼文。

開頭的 https:// 可以省略——直接複製網址列上顯示的形式即可。分享連結尾端的追蹤參數會自動忽略。

功能特色

• 批次擷取：一次執行多篇貼文
• 對話模式：預設僅第一層留言；開啟 include_nested_replies 可包含公開可取得的巢狀子留言
• 無需登入：公開貼文不需驗證
• 結構化資料：乾淨一致的輸出格式，可直接分析
• 批次摘要：逐篇追蹤處理結果，並在摘要中列出未能擷取的貼文
• 匯出選項：JSON / CSV / Excel

限制

限制	說明
公開檢視	回傳 Threads 在公開登出檢視所顯示的那批留言，不一定是超大討論串的全部留言。原貼文列的 reply_count 會在 Threads 公布時顯示平台回報的總留言數；未公布時為 null，0 代表 Threads 確實公布為零。
留言永久連結	指向單一留言的連結會被視為獨立對話。Threads 有時不會向登出訪客公開該留言底下的子對話；此時執行摘要會誠實標示未能收集，而不會把周圍討論串中不相關的留言當成結果。
自然變動	每次執行的留言集合可能有所不同，且活躍貼文會隨時間累積新留言——這反映即時公開頁面，並非故障。
貼文類型	僅公開貼文（私人帳號無法存取）

最佳實踐建議

1. 確認貼文公開：請確保貼文來自公開帳號
2. 批次整理：想把多篇貼文集中在同一份資料集時，可一次加入多個網址
3. 依來源篩選：用 source_post_url 將留言依原貼文分組

輸出位置

執行完成後：

• Dataset：所有資料集中匯出
  • 用 item_type 篩選：original_post 或 reply
  • 用 source_post_url 依原貼文分組
  • 切到「總覽」頁籤可看主要欄位
• Key-Value Store：
  • OUTPUT：執行摘要（貼文數、留言總數、耗時）
  • PROGRESS：執行中的進度（已完成貼文數、已收集留言數）

常見問題

Q：為什麼擷取到的留言比貼文顯示的少？ A：本 Actor 使用公開、未登入視角讀取貼文。它會回傳執行當下公開可見的留言，並受 max_replies 設定上限。

Q：批次中某篇失敗會怎樣？ A：爬蟲會逐篇獨立處理。執行摘要成功寫入時，未能擷取的貼文都會列在 OUTPUT 的 failed_details 中。若某個連結本次無法使用，只會略過該筆而不會中止整次執行：其餘可用的連結照常收集，被略過的會在紀錄中標明是第幾個、並計入 links_skipped，結束訊息也會說明略過幾個。只有在所有連結都無法使用時，執行才會在開始收集前中止。分享連結若當下無法開啟，會如實說明——它確實是貼文連結，因此建議重新執行，而不是去檢查連結。

Q：執行什麼時候會以失敗狀態結束？ A：沒有可用結果、留言資料未能完整讀取、已收集資料無法安全儲存，或執行中途中斷時，會以失敗狀態清楚呈現；即使已有部分資料列交付，這些問題也不會被隱藏。以下情況會以成功狀態結束：有些貼文讀到、有些確定無法公開存取（未讀到的會列在執行摘要中）；所有貼文都確定已刪除或設為私密（那個答案本身就是結果）；以及因為達到您設定的結果上限而提早停止。無論以哪種狀態結束，已寫入 dataset 的資料列都會保留。

若狀態顯示無法驗證已儲存的結果，部分資料列可能已經在 dataset 中。再次執行前請先檢查，避免重複收集相同結果。

Q：可以拿到貼文所有留言嗎？ A：本工具不需登入，因此僅能取得 Threads 對未登入訪客公開顯示的範圍。

---

需要其他 Threads 工作流程？

• Threads Scraper - Posts, Profiles & Search：擷取公開貼文、關鍵字搜尋、尋找相關帳號與匯出個人檔案資料。

由 futurizerush 開發 — 探索更多 Threads 與社群媒體爬蟲。

免責聲明

本工具僅供教育與研究用途。使用者需自行確保使用方式符合所有適用的法律、規範與所存取平台的服務條款。開發者對所擷取資料的準確性、完整性或可靠性不作任何保證。資料是否可取得取決於平台的公開存取政策，可能隨時變動恕不另行通知。開發者不對因使用或誤用本工具產生的任何損害負責。

使用本工具即表示您同意：

• 僅擷取公開可取得的資料
• 自行負責所蒐集資料的使用方式
• 資料的準確性取決於平台所提供的內容

支援

有任何問題或遇到狀況嗎？歡迎使用本 Actor 頁面的 Issues 分頁，我們很樂意協助。

---

Threads 留言爬蟲, Threads 評論抓取, Threads 評論下載, Threads 互動數據, 社群輿情分析, 社群評論監控, Threads 留言匯出, Threads 留言下載工具, Threads scraper, Threads replies scraper, Threads comments scraper, conversation analysis, sentiment tracking, engagement metrics, influencer research, social media monitoring, OpenClaw, Claude Code, Gemini, Antigravity, Codex, ChatGPT