メインコンテンツへスキップ
POST
Ayrshare経由で送信した投稿について、Ayrshare投稿IDを使用して、いいね、インプレッション、視聴数、リアクションなどのリアルタイム分析データを取得します。 Ayrshare外部から発信された投稿の分析については、ソーシャル投稿IDによる分析をご覧ください。
Facebook: 一部のリーチおよび動画関連指標がMetaによって廃止されました(2026年6月15日)。 MetaはすべてのGraph APIバージョンでユニークインプレッションおよび3秒動画視聴のInsights指標を削除したため、FacebookのanalyticsオブジェクトはimpressionsUniqueimpressionsFanUniqueimpressionsOrganicUniqueimpressionsPaidUniquevideoViewsUniqueを返さなくなりました。リーチにはmediaViewを使用してください(Total Unique Media Viewsの後継指標が計画されています)。reactionsByTypevideoViewsなど、その他の一般的に使用されるフィールドは影響を受けません。参考: 今後のAPI変更 — 2026年6月15日

追加情報

  • 現在サポートされているプラットフォーム: Bluesky、Facebookページ、Instagram、X/Twitter、LinkedIn、Pinterest、Reddit、Snapchat、Threads、TikTok、YouTube。
  • APIに表示されるFacebookおよびInstagramのコメント数は、ソーシャルアプリに表示されるカウントと異なる場合があります。これは次の2つの理由で発生します: - 一部のユーザーは、友人以外や相互接続のないユーザーからのコメントを非表示にするプライバシー設定を持っています。これらのプライベートコメントは合計コメント数に含まれます。- Metaが報告するデータに矛盾が生じる場合があります。
  • APIに表示されるInstagramの igReelsAggregatedAllPlaysCount および playsCount は、ソーシャルアプリに表示されるカウントと異なる場合があります。これはいくつかの理由で発生します:
    • 投稿がプロモートされた場合。APIレスポンスにはオーガニック再生のみが含まれます。
    • Metaが報告するデータに矛盾が生じる場合があります。
  • X/Twitterスレッドはオブジェクトの配列として返され、各オブジェクトはスレッド内の1つのツイートに対応します。
  • YouTubeは、動画視聴数やチャンネル登録者数が少ない動画の分析処理に24〜48時間かかる場合があります。
  • TikTok分析:
    • TikTokは、動画視聴数、デモグラフィック、いいね、シェア、コメントなどの分析データの更新に24〜48時間かかる場合があります。
    • TikTok分析へのアクセスには、アカウント所有者は以下を実施する必要があります: 1. 少なくとも1本の動画を公開する。2. モバイルTikTokアプリの分析ページで「オンにする」ボタンをタップする。3. 視聴者およびコンテンツエンゲージメントに関する追加インサイトを受け取るには100人のフォロワーが必要です。
    • メディアに著作権で保護された素材が含まれている場合、または著作権侵害が指摘されている場合、TikTokは投稿分析を返しません。著作権で保護された素材の例としては、リールの音声などが含まれます(TikTokはこれらの動画をミュートします)。TikTokアプリのアクティビティ -> システム通知でも確認できます。
    • 動画が7日以上非アクティブな場合、TikTokの一部の分析フィールドは利用できないことがあります。このデータを取得するには、動画で新しいアクティビティ(視聴、いいね、コメント、シェア)を生成し、24〜48時間後に再試行してください。動画がレスポンスに返されない場合、原因は音楽の著作権違反などの違反により動画がフィルタリングされたためである可能性が高いです。これらのフィールドには以下が含まれます:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • LinkedIn個人(メンバー)プロフィールは、拡張された投稿分析マトリックスを返すようになりました。利用可能なメンバー指標は以下のとおりです:
    • impressionCount — 投稿のインプレッション
    • uniqueImpressionsCount — リーチしたユニークメンバー数(LinkedInのMEMBERS_REACHED)
    • likeCount — リアクション数
    • commentCount — コメント数
    • shareCount — 投稿の再シェア数
    • engagement — オーガニックのクリック、いいね、コメント、シェアをインプレッションで割った値
    • reactions — タイプごとのリアクション内訳(リアクションが存在する場合)
    • 動画投稿の場合: videoViewsvideoViewersvideoWatchTimeMs
    動画指標は動画投稿にのみ返され、投稿作成から1年以上経過すると利用できません。
  • Instagram Storyのインサイトは、ストーリーがアーカイブされているか、ハイライトされているかに関わらず、24時間のみ利用可能です。注意:
    • 値が5未満のストーリーメディア指標は0として返されます。
    • ヨーロッパおよび日本のユーザーが作成したStoriesの場合、replies指標は0を返します。
  • Facebook Storyの分析は利用できません。
  • Pinterestの分析データ(インプレッション、ユーザーフォロワー、クリック)は24〜72時間後に利用可能になります。
  • YouTube Shortsでは、視聴回数はShortが再生または再再生を開始した回数を返し、最低視聴時間の要件はありません。

ヘッダーパラメータ

ボディパラメータ

id
string
必須
/postエンドポイントから返されるAyrshare投稿ID。これは返されるトップレベルのAyrshare idであり、postIds内のソーシャル投稿IDではありません。
platforms
array
分析データを取得するプラットフォームの文字列配列。次の値を持つ文字列の配列を受け付けます:
platformsが含まれない場合、投稿が送信されたすべてのソーシャルネットワークの分析データが返されます。
累積指標(いいね、コメント、視聴数など)がソーシャルネットワークから一時的に取得できない場合、APIは自動的に保存済みデータから補完します。プラットフォームごとのanalyticsオブジェクトに次の2つの任意フィールドが表示されることがあります:
  • backfilledFrom (文字列、ISO 8601) — 1つ以上の累積指標が保存済みデータで置き換えられた場合に存在します。タイムスタンプは、保存済みデータが最後に更新された時刻を示します。
  • recoveredFrom (文字列、ISO 8601) — APIが完全に失敗したために分析レスポンス全体が保存済みデータから復旧された場合に存在します。タイムスタンプは、保存済みデータが最後に更新された時刻を示します。
4日より古い保存済みデータは陳腐化していると見なされ、補完や復旧には使用されません。
LinkedIn個人(メンバー)分析 — 再連携が必要です。 メンバー投稿分析がリリースされる前に連携された個人のLinkedInプロフィールには、必要な分析スコープがありません。これらのプロフィールへの分析リクエストはエラーコード475(「分析を有効にするためにLinkedInプロフィールを再連携してください」)を返します。アカウント所有者は、新しいスコープを付与するため、Social AccountsページでLinkedInプロフィールを再連携する必要があります。再連携後、コード475がクリアされるまで数分お待ちください(AyrshareとLinkedInの両方が権限状態を短時間キャッシュします、通常5〜10分程度)。投稿は影響を受けません。LinkedInメンバーの投稿カウントはベストエフォートです: 集計されたshareCount(RESHARE)、likeCount(REACTION)、commentCount(COMMENT)の合計は、LinkedIn UIに表示される数値とわずかに異なる場合があります。