メインコンテンツへスキップ
POST
ユーザーのソーシャルプロフィールに関するanalyticsおよびデモグラフィック(インプレッション、ビュー、フォロワーなど)を取得します。 現在、Bluesky、Facebookページ、Google My Business、Instagram、LinkedIn、Pinterest、Reddit、Snapchat、Threads、TikTok、X/Twitter、およびYouTubeで利用可能です。
Facebook: 一部のリーチおよび動画メトリクスはMetaによって廃止されました(2026年6月15日)。 Metaは、すべてのGraph APIバージョンでユニークインプレッションおよび3秒動画ビュー(ユニーク)Insightsメトリクスを削除したため、Facebook analyticsオブジェクトはpagePostsImpressions*ファミリー(pagePostsImpressionspagePostsImpressionsPaidpagePostsImpressionsUniquepagePostsImpressionsOrganicUniquepagePostsImpressionsViral*pagePostsImpressionsNonviral*pagePostsServedImpressionsOrganicUnique)やpageVideoViewsUniqueを返さなくなりました。リーチにはpageMediaViewを使用してください(Total Unique Media Viewsの後継が計画されています)。pagePostEngagementspageVideoViewspageVideoViewsPaidは影響を受けません。参考: 今後のAPI変更 — 2026年6月15日
  • Facebookページのanalytics(デモグラフィックなど)は、100件以上のいいねがあるページでのみ利用可能です。Facebookは通常、24時間ごとにメトリクスを更新します。
  • Instagramのanalyticsデータの計算には最大48時間かかることがあります。フォロワー数analyticsは、フォロワーが100人未満の場合利用できません。デモグラフィックメトリクスは上位45名のみを返し、デモグラフィックデータがある視聴者のみがデモグラフィックメトリクス計算に使用されます。過去30日間のInstagramユーザーのエンゲージメントが100件未満の場合、デモグラフィックデータは返されません。
  • Instagramのソーシャルanalyticsを取得する際、特定のメトリクスのレスポンスにデモグラフィック情報が表示されない場合があります。デモグラフィック情報は、各内訳で100人以上のメトリクスがある場合に表示されます。詳細についてはInstagram Analyticsデモグラフィック警告を参照してください。
  • LinkedInは企業ページのanalyticsと個人(メンバー)プロフィールのanalyticsの両方をサポートします。個人プロフィールの場合、analyticsオブジェクトにはライフタイムのfollowersCountfollowersDaily[]の日次フォロワー増加、および集計投稿メトリクス(impressionCountuniqueImpressionsCountlikeCountcommentCountshareCount)が含まれます。LinkedInのcount合計は結果整合性があり、即時整合性はなく、場合によっては24〜48時間かかることがあります。個人プロフィールの集計shareCountlikeCountcommentCountはベストエフォートであり、LinkedIn UIに表示される数値とわずかに異なる場合があります。
  • TikTokは、動画ビュー、デモグラフィック、いいね、シェア、コメントなどのanalyticsデータの更新に24〜48時間かかることがあります。
  • 追加情報については、投稿analyticsエンドポイントを参照してください。

ヘッダーパラメータ

ボディパラメータ

platforms
array
必須
analyticsを取得するソーシャルメディアプラットフォーム。以下の値を含む文字列の配列を受け入れます:
quarters
integer
返す履歴データの四半期数を指定します。1四半期は以下のとおりです:
  • Facebookは85日
  • Instagram、TikTok、YouTubeは90日
  • Snapchatは90日(Snapchat APIの制限により最大1四半期/90日に制限)
Facebook、Instagram、Snapchat、TikTok、YouTubeプラットフォームで利用可能です。有効値: 1〜4。 0より大きい値のみが日付フィルタリングを有効化します。日付フィルタリング(InstagramとTikTok): 日付フィルタリングはdaily=trueまたはquarters > 0の場合に有効です。 dailyquartersのどちらも指定されていない場合、日付フィルタなしで全期間データが返されます。注意: quarters: 0は現在、日付範囲なし(全期間データ)として扱われます。以前はquarters: 0quarters: 1として扱われていました。
daily
boolean
デフォルト:false
trueに設定すると、analyticsデータを集計合計ではなく日次時系列の値として返します。このオプションはFacebook、Instagram、Snapchat、TikTok、YouTubeプラットフォームでのみ利用可能です。データサイズが大きくなるため、圧縮の使用をお勧めします。InstagramとTikTokの場合、daily=trueを設定するとデフォルトのより短い四半期ウィンドウを使用する日付フィルタリングも有効になります。Instagramリーチ: daily=trueの場合、Instagramのレスポンスは、非daily モードで返されるスカラーreachCountフィールドの代わりに、ネストされたreachオブジェクト(periodvalues時系列を含む)を返します。
period60Days
boolean
デフォルト:false
TikTok analyticsの場合、trueに設定すると、コメント、シェア、ビューの60日間の集計合計(commentCountTotalshareCountTotalviewCountTotal)のみを返します。 完全なanalytics履歴を取得するのに比べて、応答時間が短くなります。 注意: このパラメータはdaily=trueと互換性がないため、一緒に使用しないでください。重要: 2025年3月1日以降、TikTokは60日合計に移行しました。2026年4月以降、TikTokは四半期ベースの日付フィルタリングを使用します — 日付ウィンドウを制御するにはquartersパラメータを使用してください(例: quarters: 1 = 90日、quarters: 2 = 180日)。詳細は今後の変更を参照してください。
youtube
object
YouTube analytics用のプラットフォーム固有のオプション。lifetime (boolean、デフォルト: false): trueに設定すると、レスポンスにlifetimeLikesが含まれます — チャンネル上のすべての公開動画のいいねの合計。すべての動画を取得していいね数を合計するため、動画が多いチャンネルでは時間がかかる場合があります。しきい値: 1,000本を超える動画があるチャンネルはlifetimeLikes: nullとトップレベルのwarnings配列内の警告を返します。これにより過剰なAPI使用を防止します。キャッシュ: チャンネルごとに、非成功結果の場合はTTLが短く、リトライが状態変化を迅速に反映します:
  • lifetimeLikes値が成功した場合: 24時間
  • 1,000動画のベイルアウト(警告 code: 445): 1時間 — しきい値を下回るように動画を削除したチャンネルが実際の値を得るために丸1日待つ必要がないほど短くなっています。
  • 一時的なYouTube Data APIの失敗(警告 code: 446): キャッシュされません — 次のリクエストで再試行されます。
注意: 削除または非公開の動画は合計から除外されるため、動画を削除したチャンネルでは「真の」ライフタイムいいね数と異なる場合があります。リクエスト例:
userId
string
X/Twitterのみ。このパラメータを使用すると、リンクされたアカウントからではなく、特定のX/Twitterユーザーの数値IDから投稿を取得できます。たとえば、ハンドル@Googleのすべての投稿を取得するには、数値userId 20536157を使用します。任意のX/TwitterユーザーのuserIdは、Brands Get Userエンドポイントを使用して見つけることができます。注意: このリクエストを行うにはヘッダーにAPI KEYのみを使用してください。Profile Keyは含めないでください。
userName
string
X/Twitterのみ。このパラメータを使用すると、リンクされたアカウントからではなく、特定のX/Twitterユーザーのハンドルから投稿を取得できます。たとえば、ハンドル@Googleのすべての投稿を取得します。注意: このリクエストを行うにはヘッダーにAPI KEYのみを使用してください。Profile Keyは含めないでください。
累積メトリクス(フォロワー、いいねなど)がソーシャルネットワークから一時的に利用できない場合、APIは保存されたデータから自動的にバックフィルします。プラットフォームごとのanalyticsオブジェクトに2つのオプションフィールドが表示されることがあります:
  • backfilledFrom (string、ISO 8601) — 1つ以上の累積メトリクスが保存データから置き換えられた場合に存在します。タイムスタンプは保存データが最後に更新された時刻を示します。
  • recoveredFrom (string、ISO 8601) — 完全なAPI障害により、analyticsレスポンス全体が保存データから復元された場合に存在します。タイムスタンプは保存データが最後に更新された時刻を示します。
4日より古い保存データは古いものとみなされ、バックフィルや復元には使用されません。LinkedIn reactions: 投稿レベルの累積reactionsメトリクス(タイプごとのリアクション数のオブジェクト)は、このempty-onlyバックフィルの対象となります。LinkedInがreactions取得をレート制限した場合、値は最後の成功したスナップショットから継続され、backfilledFromはそのスナップショットのタイムスタンプに設定されます — 空に後退することはありません。
LinkedIn個人(メンバー)analytics — 再リンクが必要です。 メンバーanalyticsのリリース前にリンクされた個人LinkedInプロフィールには、必要なanalyticsスコープがありません。これらのプロフィールに対するソーシャルanalyticsリクエストはエラーコード475(「analyticsを有効にするためにLinkedInプロフィールを再リンクしてください」)を返します。アカウント所有者は、新しいスコープを付与するためにSocial AccountsページでLinkedInプロフィールを再リンクする必要があります。再リンク後、コード475がクリアされるまで数分間の余裕を持たせてください(AyrshareとLinkedInの両方が権限状態を短時間キャッシュします。通常は約5〜10分)。投稿は影響を受けません。
warnings (オブジェクトの配列、オプションのトップレベルフィールド) — Ayrshareが呼び出し元に致命的でない状態(例: オプトイン計算がスキップされた)を通知する必要がある場合にのみ存在します。警告するものがない場合はレスポンスから省略されます。各エントリは自由形式の文字列ではなく、構造化されたオブジェクトです:既知の警告コード:
  • 445 — YouTubeチャンネルが1,000動画のしきい値を超えているため、lifetimeLikesがスキップされました。
  • 446 — YouTube Data APIがuploadsプレイリストまたはすべてのvideos.listバッチでエラーを返したため、lifetimeLikesが利用できません。