Skip to main content
GET
透過 Comment API,使用 Ayrshare Post ID、Social Post ID、Ayrshare Comment ID 或 Social Comment ID 取得貼文的留言。 不同 ID 類型的詳情請參閱留言概觀
若使用 Ayrshare Post ID,則不需要任何查詢參數。

額外的留言細節

  • 除了 X 以外的所有平台,留言資料每 10 分鐘更新一次。由於 X API 的限制,X 的留言資料採用指數退避(exponential backoff)策略重新整理,代表更新間隔會隨時間逐漸拉長。
  • 在 Facebook 回應中,對回覆的回覆一律具有相同的 parent.id
  • 若要取得 LinkedIn 對留言的回覆,請將 "commentId": true"searchPlatformId": true 查詢參數設好,並在路徑參數中提供 Social Comment ID
  • Facebook 與 Instagram 最多會回傳貼文最近的 1,000 則留言。如需 Enterprise 方案提高上限的資訊,請與我們聯絡。
  • 對於仍在處理中的 TikTok 貼文(其 id"pending"),get-comments 會回傳明確的「仍在處理中」錯誤(code: 288,HTTP 400),而非通用失敗。請等到 tikTokPublished webhook 觸發,或 /history 顯示已解析的 video id 後再重試。

多平台讀取與部分成功

當你以 Ayrshare Post ID 請求留言時,該貼文可能涵蓋多個平台。Ayrshare 會為每個平台各發出一個請求分支(“leg”),並在部分分支成功、其他分支失敗時回傳 部分成功——成功平台的留言資料一律會回傳,每個失敗的分支則會列在頂層的 errors[] 陣列中。
  • 部分平台成功、部分失敗:回應為 HTTP 200,並帶有 status: “partial”。成功平台的區塊會如常回傳,頂層的 errors[] 陣列則會列出每個失敗的分支,包含其 platformstatuscodemessageid
  • 所有平台皆失敗:回應會帶有 status: “error” 以及完整的 errors[] 陣列。HTTP 狀態會依代表性的頂層錯誤碼對應而定。485 對應到 HTTP 404;其他代表性代碼則使用各自的對應。
  • 所有平台皆成功:回應維持不變——HTTP 200status: “success”,且沒有 errors[] 鍵。
行為變更——請檢查 errors[],勿依 HTTP 狀態分支判斷。 由於帶有失敗分支的多平台讀取現在會回傳 HTTP 200,而不會將整個回應摺疊為錯誤,因此整合方應一律檢查頂層是否存在 errors[] 陣列以偵測個別平台的失敗,而非僅依賴 HTTP 狀態碼。

已過期或不可用的 Instagram / Facebook Story 留言

已過期或不可用而無法取回留言的 Instagram 或 Facebook Story 留言分支,會出現在 errors[] 中,並帶有代碼 485。一個代表性的 Instagram 訊息為 “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” 若另一個平台成功,該平台的留言仍會回傳,整體回應為 HTTP 200。對於全部失敗的回應,代表性代碼 485 對應到 HTTP 404;其他代表性代碼則使用各自的對應。請比對 code485),而非確切的訊息文字。

範例:部分成功的回應

200: Partial Success

標頭參數

路徑參數

查詢參數

boolean
默认值:false
若要取得透過 Ayrshare 發布之貼文的留言並使用 Ayrshare Post ID,請勿包含此欄位——預設為 false。若要以社群網路產生的 ID(即 Social Post IDSocial Comment ID)取得留言,請設為 true
boolean
默认值:false
若要以 Social Comment ID(即社群網路產生的留言 ID)取得留言,請設為 true若使用 Ayrshare Post ID 或 Social Post ID 取得留言,請勿包含此欄位——預設為 false
使用 commentId 查詢參數時,也必須將 searchPlatformId 設為 true
string
searchPlatformIdcommentIdtrue 時為必填。何時使用:
  • 使用 Social Post ID 並將 "searchPlatformId": true 時。支援平台:blueskyfacebookinstagramlinkedinthreadstiktoktwitteryoutube
  • 使用 Social Comment ID 並將 "searchPlatformId": true"commentId": true 時。支援平台:facebookinstagramlinkedin
  • 若使用 Ayrshare Post ID,請勿包含此欄位——會從原始貼文所發布的所有平台回傳留言。

取得留言請求範例