Threads 資料 API

透過 12 個需要驗證的 Threads 介面查詢使用者資料、貼文、回覆、轉發、留言及搜尋結果。

身分驗證

在 Authorization 標頭中傳送 API Hop API Key。存取取決於已啟用的閘道及 API Key 權限，文件不代表正式環境已開放。

Authorization: Bearer YOUR_API_KEY

請求

使用 GET 查詢參數，不接受請求主體。未知、重複或無效欄位會遭拒絕。ID 須保留為字串，包括超出 JavaScript 安全整數範圍的值。請求逾時為 60 秒，不會自動重試。

curl --get "https://api.apihop.ai/v1/threads/web/posts/detail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "post_id=DPVUglOjOUu"

回應

保留原始 JSON code/data 結構及數字精度。成功要求 code=200 且 data 非 null。HTTP 200 中的業務錯誤仍視為失敗。各介面回應結構不同；以下為說明性範例，並非即時回應。

{"code":200,"data":{"post":{"code":"DPVUglOjOUu"},"replies":[]}}

計費

預設依每次成功請求 $0.002（2000 credits）計費，包括成功傳回的空陣列或空物件，不依筆數計費。帳戶專屬價格優先。上游失敗會釋放預扣；結算失敗傳回錯誤，不會再次呼叫上游。

分頁限制

使用者貼文、轉發、回覆、貼文留言、熱門搜尋及最新搜尋不支援分頁。end_cursor 是無效的保留欄位，請勿依 next_cursor 或 has_more 請求後續頁。使用者清單僅傳回目前可得的一批資料（約 25 筆），並非完整歷史。所有介面均不會自動追加擷取。

錯誤

HTTP 400：參數錯誤；401：驗證失敗；402：餘額不足；403：無存取權限；405：不支援的方法；408：請求取消；429：速率限制；5xx：服務或上游錯誤，其中 504 表示逾時。排查時請保留 X-Request-Id。

介面參考

完整介面參考

來源

於 2026-10-31 核對官方 OpenAPI V5.3.2 與端點價格。僅出現在價目表中的 fetch_post_id_from_url 不在 OpenAPI 中，因此不納入接入範圍。

TikHub · OpenAPI · Prices