数据分析 APIAPI
从一个端点读取所有网络的指标
FoPost 从每个已连接账号收集表现数据，并以统一的格式返回。获取工作区概览、深入查看某条帖子，或长期追踪某个账号，再接入你用来做报告的任何工具。
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 }]
}统一的指标
曝光量、互动和粉丝数在每个网络上都使用相同的字段名。
三个层级
工作区概览、单条帖子或单个账号。
只读权限
只有 analytics 权限的密钥只能读取数据，别无其他。
日期范围
传入 days，获取最多 365 天的滚动窗口。变化量会与前一个窗口进行比较。
按账号筛选
客户询问某个渠道时，把概览缩小到单个账号。
按工作区
代理机构的密钥按客户工作区划分，报告永远不会互相串扰。
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"
}按账号细分
一条帖子，每个网络一行，一眼看出是哪个渠道带动了它。
点击和永久链接
链接点击数和实时永久链接会随计数一并返回。
按标签分组
先按标签列出帖子，再读取这组帖子的指标。
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" }
]
}快照序列
每次采集为粉丝数、触达和主页浏览量记录一个数据点。
构建你自己的提醒
定时轮询，当某个渠道超出正常范围时发出通知。
历史数据归你所有
把序列存入你的数据仓库，想保存多久就保存多久。
关于 数据分析 API 的常见问题解答
这些数据从哪里来？
FoPost 使用已连接账号的凭据读取各网络自己的分析数据，再统一字段名。数字与该网络在其原生后台中报告的一致。
数据有多新？
每个已连接账号的指标都会定期刷新。今天发布的帖子几小时内就会显示初步数据，并随网络确定最终计数而稳定下来。
所有网络报告的指标都一样吗？
曝光量、互动数和粉丝数这组核心指标是共通的。网络未提供的指标会返回 null 而不是零，让你能区分“没有数据”和“数值为空”。
能获取不是通过 API 发布的帖子的指标吗？
可以。通过已连接账号发布的任何帖子都会在账号层面被追踪，在控制台中创建的帖子也和其他帖子一样有 id。
我需要哪个权限范围？
analytics 权限。只有该权限的密钥是只读的，无法发布、编辑或管理账号。
有速率限制吗？
有，每个密钥每分钟 100 次请求。请用日期范围批量读取，而不是每天调用一次。