メインコンテンツへスキップ
POST
低レベルの Social Post ID を指定することで、Ayrshare 経由で発信されていない投稿のアナリティクスを取得します。 この ID は /post エンドポイントpostIds フィールドで返されます。 アナリティクスを取得するには、リンクされたアカウントが投稿の所有者である必要があります(例外: YouTube。下記参照)。対応プラットフォーム: Facebook, Instagram, LinkedIn, Threads, TikTok, Twitter, YouTube
  • 呼び出しは Analytics on a Post エンドポイント と同じです。主な違いは、Ayrshare ID の代わりに、ソーシャルネットワークが返す投稿 ID を使用することです。また、Social Post ID で検索していることをエンドポイントに通知するために、searchPlatformId: true パラメーターを含めます。
  • Ayrshare の外部から発信された投稿と ID を取得するには、Get All Post History エンドポイント を使用し、id フィールドを参照してください。
  • Ayrshare を介して送信されていない投稿にのみ使用することをお勧めします。Ayrshare 経由で送信された投稿の場合は、analytics エンドポイント を使用してください。
  • ユーザーのアカウントが個人アカウントからビジネスアカウントに変換される前に公開された Instagram 投稿のアナリティクスは、機能が制限されています。
  • ソーシャル ID メソッドを使用して自分のチャンネルに属さない投稿の YouTube アナリティクスを取得する場合、API はコンテンツに関する記述メタデータを返しますが、すべての数値メトリクスはゼロと表示されます。タイトル、説明、タグ、チャンネルタイトル、プライバシーステータス、サムネイル URL などの記述情報は正しく入力され、動画コンテンツに関するコンテキストを提供します。ただし、視聴回数、いいね数、コメント、シェア、購読者の変化、視聴時間、プレイリスト追加を含むすべての数値パフォーマンスメトリクスはゼロ値として返されます。
  • X/Twitter スレッドに postIds を使用する場合、各ツイートの Social Post ID を個別に指定する必要があります。親投稿をクエリしても、スレッドツイートは自動的には含まれません。

Header Parameters

Body Parameters

id または postIds のいずれかを指定する必要があります。単一の投稿には id、単一のリクエストで複数の投稿のアナリティクスを取得するには postIds を使用します。
id
string
/post エンドポイント から返される Social Post ID。これは postIds 配列内の個別ソーシャルネットワークの id フィールドです。id または postIds のいずれかが必須です。
postIds
array
単一のリクエストで複数の投稿のアナリティクスを取得するための Social Post ID の配列。最大 100 個の ID を指定できます。id または postIds のいずれかが必須です。
platforms
array
必須
アナリティクスを取得するプラットフォームの文字列配列。1 つの値のみが許可されます。利用可能な値:
searchPlatformId
boolean
デフォルト:false
必須
Social Post ID で検索するには true に設定します。
累積メトリクス(いいね、コメント、視聴回数など)がソーシャルネットワークから一時的に取得できない場合、API は自動的に保存データからバックフィルします。プラットフォームごとの analytics オブジェクトに次の 2 つのオプションフィールドが表示される場合があります:
  • backfilledFrom(文字列、ISO 8601)— 1 つ以上の累積メトリクスが保存データで置き換えられた場合に存在します。タイムスタンプは、保存データが最後に更新された時刻を示します。
  • recoveredFrom(文字列、ISO 8601)— 完全な API 障害により、アナリティクスレスポンス全体が保存データから復元された場合に存在します。タイムスタンプは、保存データが最後に更新された時刻を示します。
4 日以上経過した保存データは古いとみなされ、バックフィルまたは復元には使用されません。