跳转到主要内容
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 後再重試。

標頭參數

路徑參數

查詢參數

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

取得留言請求範例