用途:该技能用于检索 Bundle.social 上社交账号与帖子的表现指标,适合在被询问社媒分析或表现数据时使用。
认证与地址:请求头使用 x-api-key: <your-api-key>;基础地址为 https://api.bundle.social。可参考 references/README.md 查看平台枚举与标准错误,references/07-analytics.md 查看端点细节。
使用方式:先确定范围(账号级或帖子级),再确定时间范围,缺少 dateFrom/dateTo 时需询问;随后查阅对应端点参考文档,生成以 <your-api-key> 为占位符的 curl 示例(资料明确说明不要真正调用 API),最后清晰呈现数据,突出关键指标、趋势与对比。
主要能力与端点:账号分析包括 GET /api/v1/analytics/social-account(支持 dateFrom、dateTo、granularity)、GET /api/v1/analytics/social-account/raw 与 POST /api/v1/analytics/social-account/force。帖子分析包括 GET /api/v1/analytics/post、GET /api/v1/analytics/post/raw、GET /api/v1/analytics/post/bulk(一次最多 60 个帖子,每页 20,需 platformType 且帖子须同一平台)与 POST /api/v1/analytics/post/force。
常见指标:impressions、impressionsUnique、views、viewsUnique、likes、comments、shares、saves、followerCount、engagementRate。各平台指标可能不同,例如 YouTube 有观看时长,Instagram 有故事指标。
常见用法:账号健康检查(近 30 天曝光与互动趋势)、帖子表现对比(批量端点并排比较)、深度分析(先看帖子分析再取原始数据)、数据过旧时强制刷新后重取、按日期范围与粒度拉取数据做周报或月报。
限制:发布后数据可能异步更新,不会立即可用;强制刷新有速率限制,不应频繁调用;部分平台特定指标在不支持的平台可能返回 null。具体收费、价格等信息暂未提供。