分析APIAPI

すべてのネットワークの指標を、ひとつのエンドポイントで

FoPostは接続した各アカウントのパフォーマンスデータを集め、一貫した形式で返します。ワークスペースの概要を取得したり、投稿を掘り下げたり、アカウントの推移を追ったりして、普段のレポートツールにそのまま流し込めます。

APIキーを取得ドキュメントを読む
GET /v1/analytics/overview
curl "https://api.fopost.com/v1/analytics/overview?workspace_id=9b2f6c1e-...&days=30" \
  -H "X-API-Key: $API_KEY"

{
  "total_accounts": 6,
  "total_followers": 42810,
  "total_posts": 86,
  "total_engagement": 9127,
  "total_impressions": 184320,
  "total_reach": 121904,
  "engagement_rate": 0.0749,
  "deltas": { "followers": 2.89, "posts": 12.5 },
  "today_stats": { "posts": 3, "follower_change": 41, "engagement": 312 },
  "platforms": [{ "platform": "linkedin", "accounts": 2, "followers": 18402 }]
}

正規化された指標

インプレッション、エンゲージメント、フォロワーは、どのネットワークでも同じフィールド名を使います。

3つのレベル

ワークスペース全体、投稿1件、アカウント1つ。

読み取り専用スコープ

analyticsスコープだけを持つキーは、数値の読み取りだけができます。

概要

月次レポートは1回の呼び出しで

overviewエンドポイントは、期間内のワークスペースを集計します。インプレッション、エンゲージメント、フォロワーの増減、公開した投稿数の合計が返るので、週次サマリーもクライアント向けレポートも、リクエスト1回とテンプレートで作れます。

分析リファレンスを読む
1つのワークスペースにまとめた、すべてのネットワークの接続アカウント

期間指定

daysを渡すと、最大365日までの直近期間を集計します。差分はその前の同じ期間と比較します。

アカウントで絞り込み

クライアントから特定のチャネルについて聞かれたら、概要を1つのアカウントに絞り込めます。

ワークスペースごと

代理店のキーはクライアントのワークスペースごとなので、レポートが混ざることはありません。

投稿別

成果を出した投稿を見つける

APIで作成した投稿はすべてIDを保持し、そのIDで公開先の各ネットワークから指標を取得できます。自社のキャンペーンデータと結合したり、その月の投稿をランキングして次に繰り返すべきものを見極めたりできます。

投稿別の指標を見る
GET /v1/posts/:id/analytics
curl "https://api.fopost.com/v1/posts/7d3e0a52-.../analytics" \
  -H "X-API-Key: $API_KEY"

{
  "post_id": "7d3e0a52-...",
  "totals": { "impressions": 21050, "reach": 15230, "engagements": 1374, "likes": 501, "comments": 60, "shares": 71, "reposts": 0, "clicks": 721, "saves": 21, "video_views": 0, "follows": 12 },
  "platforms": [
    { "platform": "linkedin", "username": "yourbrand", "external_post_id": "urn:li:share:7301...", "permalink": "https://linkedin.com/feed/update/...", "metrics": { "impressions": 12840, "likes": 311, "comments": 42, "shares": 27, "clicks": 508 } },
    { "platform": "twitter", "username": "yourbrand", "external_post_id": "1830...", "permalink": "https://x.com/...", "metrics": { "impressions": 8210, "likes": 190, "comments": 18, "shares": 44, "clicks": 213 } }
  ],
  "last_fetched_at": "2026-09-02T09:00:00Z"
}

アカウント別の内訳

1つの投稿につきネットワークごとに1行。どのチャネルで伸びたかがわかります。

クリック数とパーマリンク

リンクのクリック数と公開中のパーマリンクも、数値と一緒に返ります。

ラベルでグループ化

まずラベルで投稿を一覧し、そのまとまりの指標を取得します。

アカウント別

チャネルごとの成長を継続的に追跡

accountエンドポイントは、フォロワー数、リーチ、プロフィール閲覧数のスナップショットを時系列で返します。自社のグラフに使ったり、落ち込みにアラートを出したり、伸びを生んだ投稿と並べてクライアントに成長曲線を見せたりできます。

開発を始める
GET /v1/accounts/:id/analytics
curl "https://api.fopost.com/v1/accounts/4a71d80b-.../analytics?limit=7" \
  -H "X-API-Key: $API_KEY"

{
  "account_id": "4a71d80b-...",
  "platform": "linkedin",
  "username": "yourbrand",
  "history": [
    { "followers": 41651, "following": 210, "total_posts": 412, "reach": 6034, "profile_views": 341, "fetched_at": "2026-08-02T06:00:00Z" },
    { "followers": 41606, "following": 210, "total_posts": 411, "reach": 5120, "profile_views": 288, "fetched_at": "2026-08-01T06:00:00Z" }
  ]
}

スナップショットの時系列

収集のたびに、フォロワー、リーチ、プロフィール閲覧数のデータポイントを1つ記録します。

独自のアラートを構築

定期的にポーリングし、チャネルが通常の範囲を外れたら通知できます。

履歴を自社で保有

時系列データを自社のデータウェアハウスに保存し、好きなだけ保持できます。

分析APIに関するよくある質問

数値はどこから来ていますか？

FoPostは接続アカウントの認証情報で各ネットワーク自身の分析データを読み取り、フィールド名を正規化します。数値は各ネットワークのネイティブのダッシュボードと一致します。

データはどれくらい新しいですか？

指標は、接続したすべてのアカウントで定期的に更新されます。今日公開した投稿は数時間以内に初期の数値が表示され、ネットワーク側の集計が確定するにつれて落ち着きます。

すべてのネットワークが同じ指標を返しますか？

インプレッション、エンゲージメント、フォロワーという基本セットは共通です。ネットワークが公開していない指標は0ではなくnullで返るため、データがないのか値が空なのかを区別できます。

API以外で公開した投稿の指標も取得できますか？

はい。接続アカウントで公開された投稿はすべてアカウント単位で追跡され、ダッシュボードで作成した投稿にもほかと同じようにIDがあります。

必要なスコープは？

analyticsスコープです。このスコープだけを持つキーは読み取り専用で、投稿、編集、アカウント管理はできません。

レート制限はありますか？

はい、キーごとに毎分100リクエストです。1日ごとに呼び出すのではなく、期間を指定してまとめて取得してください。

今日から分析APIで開発を

無料で始められ、API全体が含まれます。キーを作成すれば、数分で最初の呼び出しができます。

APIキーを取得