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)	作者是否開啟聯邦宇宙分享。貼文頁面通常未提供此訊號，因此多為 null——null 代表未知，不代表未啟用
留言內容 (text_content)	公開可取得的留言文字（支援 emoji），可能是空的，例如留言只有媒體時。長文貼文的原貼文列為整篇內容：先是開頭幾行，接著是長文本文
提及 / 標籤 (mentions / hashtags)	從留言文字擷取。提及的帳號與標籤都依首次出現順序列出，每個只列一次
連結 (urls)	這則留言帶有的網址：文字中完整寫出的外部或 Threads 連結（例如 https://example.com/page），以及分享連結預覽卡背後的網址，每個只列一次
被標記帳號 (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)	留言是否含媒體與主媒體網址。media_urls 只在 carousel（多張媒體）時列出所有媒體網址，單張圖片或影片時為空。公開頁面不提供 GIF 本身的網址，因此 GIF 留言的 has_media 與 is_gif 為 true、media_url 為 null。簡單篩選請用 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)	轉發標記與原貼文網址。貼文頁面很少帶有轉發標記，因此這裡通常是 false 與 null
贊助合作 (is_paid_partnership)	是否標示為贊助 / 付費合作
編輯狀態 (is_edited)	文字發布後是否曾被編輯
留言權限 (reply_control)	誰可以留言，依 Threads 提供的原始值（實際出現過的值包含 everyone、accounts_you_follow 與 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)——當貼文回報的留言數多於公開顯示的數量時為 true，公開顯示已涵蓋貼文回報的全部時為 false，本次無法判定時為 null（貼文未公布留言總數、留言數上限提前結束收集、本次未能讀完或確認整段留言、Threads 在開始讀取這篇貼文時就限制存取，或頁面上有留言無法確認屬於這篇貼文，而缺少的留言可能就在其中）。它描述的是公開檢視的狀況，而非您的上限實際交付了多少列，可用來分辨「完整收集的小型討論串」與「大型討論串的樣本」。null 不代表失敗——部分公開留言資料未能讀取的貼文會列在執行摘要的 partly_read_post_urls，失敗的貼文（包括資料無法儲存的貼文）則列在 failed_details。它比較的是貼文回報的總數與第一層留言，因此開啟巢狀子留言時，即使收集到的列數與總數相同，它仍可能為 true。

如何使用

輸入

參數	必填	預設	說明
post_urls	✓	-	最多 20 個 Threads 連結：貼文、留言或分享連結皆可
max_replies	✗	50	每篇貼文要擷取的留言數量上限（10-300）。每篇成功擷取的貼文另外會交付一列原貼文，不計入這個上限。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" }
  ]
}

請將這些範例換成您想分析的公開 Threads 貼文網址。

輸出範例

所有資料儲存到 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": 24817,
  "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": null,
  "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://www.threads.com/t/CODE）同樣可用，系統會自動解析成它指向的貼文。

結尾為 /media 的貼文連結（例如 https://www.threads.com/@username/post/CODE/media）同樣可用：系統會擷取該貼文本身，連結則原樣保留在 source_post_url 與原貼文的 post_url 中；分享連結或短連結則記錄為其解析後的貼文網址。同一篇貼文若以不同形式貼上多次，只會擷取一次。

請貼上瀏覽器複製出來的完整連結（以 https:// 開頭）。貼文連結尾端的追蹤參數不影響使用，並會保留在 source_post_url 中。

功能特色

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

限制

限制	說明
公開檢視	回傳 Threads 在未登入狀態下公開顯示的留言，不一定是超大討論串的全部留言。原貼文列的 reply_count 會在 Threads 公布時顯示平台回報的總留言數；未公布時為 null，0 代表 Threads 確實公布為零。
留言永久連結	指向單一留言的連結會被視為獨立對話：該留言成為 original_post 列，並依您設定的留言數上限收集回覆它的留言。開啟巢狀子留言時，也會收集公開檢視在其下顯示的子留言；若要收集更深一層留言底下的回覆，請使用該則留言自己的連結。is_liked_by_author 仍是指整串討論最初那篇貼文的作者，而非您提供連結的那則留言的作者。is_public_subset 的判讀方式與一般貼文相同。Threads 有時不會向未登入的訪客顯示該留言底下的子對話；此時不會交付任何留言列，也不會把周圍討論串中不相關的留言當成結果（請見下方「頁面未附帶留言」）。
自然變動	每次執行的留言集合可能有所不同，且活躍貼文會隨時間累積新留言——這反映即時公開頁面，並非故障。
頁面未附帶留言	Threads 可能只提供貼文頁面而不附帶留言。此時貼文本身仍會被讀取。若貼文顯示了留言數，而頁面上顯示的留言都無法確認屬於這篇貼文——或是留言連結的頁面沒有顯示該留言回報的任何回覆（視頁面的呈現方式而定）——會交付該貼文本身的列、不交付留言列。其他未附帶留言的貼文都不會交付任何列，並會在 failed_details 中列出原因。原因為 replies_not_public（Threads 在沒有先限制存取的情況下回應沒有任何留言公開顯示）的貼文不會列在 posts_for_a_new_run：每次執行都讀取即時頁面，因此之後再次執行時，會讀取 Threads 當下顯示的內容。
貼文類型	僅公開貼文（私人帳號無法存取）

輸出位置

執行完成後：

• Dataset：所有資料集中匯出
  • 用 item_type 篩選：original_post 或 reply
  • 用 source_post_url 依原貼文分組
  • 切到「總覽」頁籤可看主要欄位
• Key-Value Store：
  • OUTPUT：執行摘要。每一篇您送出的貼文都只會計入一類：已收集（posts_succeeded）、失敗（posts_failed）、因達到本次執行設定的費用上限而停止（posts_stopped_at_result_limit）或未擷取（posts_not_collected）——四者相加必然等於本次執行可用的不同貼文數（total_posts）。因執行被停止或 Threads 限制存取而中斷的已收集貼文，會列在 cut_short_post_urls。已交付、但部分公開留言資料未能讀取的貼文，無論已收集或因達到費用上限而停止，都會列在 partly_read_post_urls；同一篇貼文可能同時列在兩份清單。要交給新執行、讓它收集本次未能收集內容的貼文連結，會列在 posts_for_a_new_run，每一項的格式為 {"url": ...}，與輸入欄位 post_urls 相同。您提供的其餘連結分別計入 links_skipped（無法使用的連結）與 duplicate_post_urls_skipped（指向本次已有貼文的第二個連結）。
  • PROGRESS：執行中的進度（已完成貼文數、已收集留言數）

常見問題

Q：為什麼擷取到的留言比貼文顯示的少？ A：本 Actor 使用公開、未登入視角讀取貼文。它會回傳執行當下公開可見的留言，並受 max_replies 設定上限。當貼文的留言多於您的上限時，您最多會拿到上限數量的留言，大致依本次從公開頁面讀取的順序排列；本 Actor 不會依讚數或時間為留言排名。若某篇貼文的對話串非常長，本次執行也可能在讀完之前就結束。

Q：批次中某篇失敗會怎樣？ A：貼文已刪除、設為私密或無法讀取時，其餘貼文會繼續處理。執行摘要（OUTPUT）會交代每一篇貼文：failed_details 列出每篇失敗的貼文與原因，posts_not_collected 計入未擷取的貼文。若某個連結本次無法使用，只會略過該筆，並在紀錄中標明是第幾個、計入 links_skipped；所有連結都無法使用時，執行會在開始收集前中止，訊息會說明該怎麼做。若 Threads 在讀取某篇貼文時暫時限制存取，執行會比平常多等一段時間再處理下一篇；若連續三篇貼文都因 Threads 限制存取而未能完整讀取，執行會停止繼續處理，剩下的貼文計為未擷取。

Q：沒收集到的貼文該怎麼辦？ A：結束訊息會告訴您下一步：

• 以 Resurrect 繼續本次執行：接著擷取本次未處理完的貼文——尚未處理到的，以及因意外問題而未處理完的。
• 另開新的執行：使用執行摘要中 posts_for_a_new_run 所列的連結。清單列出新的執行可能補上內容的貼文：中途被中斷的貼文；列在 partly_read_post_urls、新的執行可能讀到更多留言的貼文；因達到費用上限而停止的貼文；以及 failed_details 中原因可能隨重新執行而改變的貼文。清單每一項的格式為 {"url": ...}，與 post_urls 相同，可以直接交給新的執行。若結束訊息請您先以 Resurrect 繼續本次執行，請改用 Resurrect 結束後執行摘要中的清單。
• 先檢查 dataset：已儲存資料無法驗證的貼文，只有在留言確實缺少時，才另開新的執行擷取。

重新執行的貼文會從第一則留言開始讀取，本次已交付的留言會再次收集。您自行停止的執行，則依下方「中途停止執行會怎樣？」的說明處理。

Q：執行什麼時候會以失敗狀態結束？ A：沒有可用結果、已收集資料無法安全儲存，或執行途中發生意外問題、批次尚未跑完就中斷時，會以失敗狀態結束。由您自己停止的執行是另一種情況，見下方說明。若所有請求的貼文都已讀取，但 Threads 表示這些貼文的留言都沒有公開顯示，執行也會以失敗結束：訊息會說明是哪一類失敗，執行摘要（有寫入時）則列出每篇貼文的原因。以下情況會以成功狀態結束：貼文尚無留言（仍會交付貼文本身的列）；所有貼文都確定已刪除或設為私密（那個答案本身就是結果）；頁面上的留言無法確認屬於該貼文（仍會交付貼文本身的列）；有些貼文讀到、有些無法存取或無法讀取（未讀到的會列在執行摘要中，它們已交付的資料列會保留）；以及已收集到資料後 Threads 限制存取的情況。達到您在執行選項中設定的費用上限時，執行也不會失敗：它會就此自行結束；若平台先一步停止它，狀態會顯示為 Aborted。但若此時尚未收集到任何資料，且有貼文因其他原因未能收集，執行會以失敗結束。無論以哪種狀態結束，已寫入 dataset 的資料列都會保留。

若狀態顯示無法驗證已儲存的結果，部分資料列可能已經在 dataset 中。請先檢查；只有在那篇貼文的留言確實缺少時，才另開新的執行擷取，避免重複收集相同結果。無法驗證的那篇貼文若與您提供的另一篇貼文有相同的留言，該留言可能不在另一篇貼文的資料列中，也可能在兩篇貼文下各存一次。

Q：中途停止執行會怎樣？ A：請以優雅中止（graceful abort）停止——透過 API 請加上 gracefully=true。執行不會再開始新的貼文，平台接著會給它 30 秒：正在處理的那篇貼文若能及時完成並儲存就會交付，否則計入未擷取。若這篇貼文被停止中斷，已讀到的留言仍會交付。執行狀態會顯示為 Aborted，狀態訊息與執行摘要會說明已收集的內容與有幾篇貼文未擷取；若平台在摘要寫入前就結束了執行，狀態訊息會說明執行正在停止；若執行還在讀取您提供的連結時就停止，也不會寫入執行摘要。Apify 預設的中止不是優雅中止，執行會立即結束，正在處理的那篇貼文不會完成，也不會寫入執行摘要，達到執行選項中設定的逾時時間時也是如此（狀態會顯示為 Timed out）。您立即中止或逾時結束的執行，以 Resurrect 繼續並結束後，會寫入執行摘要。之後以 Resurrect 繼續時，會接著擷取未擷取的貼文，並重新開啟本次無法開啟的分享連結或短連結；被停止中斷的已收集貼文不會重新讀取。若費用上限所剩的額度可能不足以處理完未擷取的貼文，它們會改列在 posts_for_a_new_run。無論用哪種方式停止，已儲存的資料列都會保留。

Q：如果我設定了執行費用上限會怎樣？ A：達到上限時會停止收集，已儲存的資料都會保留。貼文是逐篇讀取的，前面的貼文可能用完費用上限，使後面的貼文被截斷或未讀取。中途被截斷的貼文會保留額度內的留言，額度還有空間時才保留原貼文列。因達到費用上限而停止的貼文會列在新執行的清單（posts_for_a_new_run），只少了原貼文那一列的除外。後面還有貼文要讀取時，執行也可能擱置前面貼文的部分留言，替後面的貼文保留空間：紀錄會在該貼文的訊息中說明則數，只因這些留言被擱置的貼文，不會列入這份清單。直接 Resurrect 仍沿用同樣的費用上限，因此所剩額度可能不足以處理完未處理完的貼文時，它們也會列在這份清單中。

---

需要其他 Threads 工作流程？

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

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

免責聲明

本 Actor 用於收集公開的 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