Skip to main content
GET
Comment APIを使用して、Ayrshare投稿ID、Social Post ID、Ayrshareコメント ID、またはSocial Comment IDから投稿のコメントを取得します。 異なるID型の詳細については、Comments Overviewをご覧ください。
Ayrshare Post IDを使用する場合、クエリパラメータは不要です。

追加のコメント詳細

  • コメントデータはXを除くすべてのプラットフォームで10分ごとに更新されます。XのAPIによる制限のため、Xのコメントデータは指数バックオフ戦略を使用して更新され、更新間隔は時間とともに徐々に長くなります。
  • Facebookのレスポンスでは、返信への返信は常に同じparent.idを持ちます。
  • "commentId": true"searchPlatformId": trueのクエリパラメータを設定し、パスパラメータにSocial Comment IDを指定することで、LinkedInのコメントへの返信を取得できます。
  • FacebookとInstagramは、投稿の最新1,000件のコメントまでを返します。Enterpriseプランでのより高い上限についてはお問い合わせください。
  • まだ処理中のTikTok投稿(そのid"pending")の場合、get-commentsは一般的な失敗ではなく明確な「still processing(処理中)」エラー(code: 288、HTTP 400)を返します。tikTokPublishedwebhookが発火するか、/historyで解決された動画IDが表示されたら、再試行してください。

マルチプラットフォーム読み取り & 部分的成功

Ayrshare Post ID でコメントをリクエストすると、その投稿は複数のプラットフォームにまたがることがあります。Ayrshare はプラットフォームごとに 1 つのリクエスト(「レッグ」)にファンアウトし、いくつかのレッグが成功し、他が失敗した場合には 部分的成功 を返します — 正常なプラットフォームのコメントデータは常に返され、失敗したレッグはそれぞれトップレベルの errors[] 配列に列挙されます。
  • 一部のプラットフォームが成功し、一部が失敗: レスポンスは HTTP 200status: “partial” となります。正常なプラットフォームブロックは通常どおり返され、トップレベルの errors[] 配列には、失敗したすべてのレッグがその platformstatuscodemessageid とともに列挙されます。
  • すべてのプラットフォームが失敗: レスポンスは status: “error” と完全な errors[] 配列を含みます。HTTP ステータスは代表的なトップレベルのエラーコードからマッピングされます。コード 485 は HTTP 404 にマッピングされ、他の代表的なコードはそれぞれ独自のマッピングを使用します。
  • すべてのプラットフォームが成功: レスポンスは変更なし — HTTP 200status: “success”errors[] キーはありません。
動作変更 — errors[] を検査し、HTTP ステータスで分岐しないでください。 レッグが失敗するマルチプラットフォーム読み取りが、レスポンス全体をエラーに集約するのではなく HTTP 200 を返すようになったため、インテグレーターは HTTP ステータスコードだけに依存するのではなく、プラットフォームごとの失敗を検出するために常にトップレベルの errors[] 配列の存在を確認する必要があります。

期限切れまたは利用不可の Instagram / Facebook Story コメント

期限切れまたは利用不可の Instagram または Facebook Story コメントのレッグ(コメントを取得できないもの)は、コード 485 とともに errors[] に現れます。代表的な Instagram のメッセージは “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” です。別のプラットフォームが成功した場合、そのコメントは引き続き返され、全体のレスポンスは HTTP 200 です。全失敗のレスポンスでは、代表的なコード 485 は HTTP 404 にマッピングされ、他の代表的なコードはそれぞれ独自のマッピングを使用します。正確なメッセージテキストではなく code(485)でマッチングしてください。

例: 部分的成功レスポンス

200: 部分的成功

ヘッダーパラメータ

パスパラメータ

クエリパラメータ

boolean
デフォルト:false
Ayrshare経由で公開された投稿でAyrshare Post IDを使用してコメントを取得する場合、このフィールドは含めないでください - デフォルトはfalseです。ソーシャルネットワークによって生成されたSocial Post IDまたはSocial Comment IDを使用してコメントを取得する場合、trueに設定します。
boolean
デフォルト:false
ソーシャルネットワークによって生成されたコメントIDであるSocial Comment IDを使用してコメントを取得する場合、trueに設定します。Ayrshare Post IDまたはSocial Post IDを使用してコメントを取得する場合、このフィールドは含めないでください - デフォルトはfalseです。
commentIdクエリパラメータを使用する場合、searchPlatformIdtrueに設定する必要があります。
string
searchPlatformIdまたはcommentIdtrueの場合は必須です。使用するタイミング:
  • Social Post ID"searchPlatformId": trueフィールドを使用する場合。サポートされているプラットフォーム: blueskyfacebookinstagramlinkedinthreadstiktoktwitteryoutube
  • Social Comment ID"searchPlatformId": trueおよび"commentId": trueフィールドを使用する場合。サポートされているプラットフォーム: facebookinstagramlinkedin
  • Ayrshare Post IDを使用する場合、このフィールドは含めないでください - 元の投稿が公開されたすべてのプラットフォームからコメントが返されます。

コメントGETリクエスト例