竞品内容周报
拉取每个竞品在所用平台上的最新公开帖子,按其相对于该账号自身基线的参与度进行排名,并总结本期其内容的变化。
本功能能告诉您什么以及不能告诉您什么
- 仅限公开、未登录数据。不含曝光量、保存数、点击率或受众数据——绝不要估算这些指标。
- 不同平台返回的内容列表不同:
- X
user-tweets返回的是该账号最受欢迎的近期推文(约 100 条),而非按时间顺序的 Feed。 - LinkedIn
company-posts返回公司页面在未登录状态下向访客展示的帖子(约 10 条最新)。 - Facebook
profile-posts通常只返回页面在未登录状态下展示的1-2条最新帖子。请将 Facebook 视为抽查而非完整 Feed,并在周报中注明。
- X
- 参与度比较仅限同一账号、同一平台内。不同平台间的原始点赞数不可比。
首先需要收集的输入
- 竞品及其在各平台上的个人主页 URL。不要猜测用户名——如果用户未提供某平台,则跳过该平台。
- 时间段(默认:最近 7 天)以及每个平台拉取的帖子数量(默认:10 条;Facebook
profile-posts最多接受limit=4)。 - 上一期周报文件(如有),用于报告周环比变化。
信用估算——运行前展示
每个竞品,每个平台一次列表调用:
| 平台 | 端点 | 信用点数 |
|---|---|---|
| TikTok | /v1/tiktok/channel-posts | 2 |
/v1/instagram/channel-posts (每条 0.3,10 条) | 3 | |
| YouTube | /v1/youtube/channel-videos | 2 |
| X | /v1/twitter/user-tweets | 2 |
| Threads | /v1/threads/user-posts | 2 |
/v1/linkedin/company-posts | 1 | |
/v1/facebook/profile-posts | 2 |
全部七个平台:每个竞品约 14 信用;若调用几个可选的详情端点则约为 16 信用。打印出所请求竞品和平台的信用总和,调用 GET /v1/account/balance(免费)进行检查,并请求确认。
如何调用 Captapi
- MCP:
tiktok_channel_posts、instagram_channel_posts、youtube_channel_videos、twitter_user_tweets、threads_user_posts、linkedin_company_posts、facebook_profile_posts。 - REST:
GET https://api.captapi.com<path>?url=<profile URL>&limit=<N>,请求头含Authorization: Bearer $CAPTAPI_API_KEY。Facebook 使用limit=4;更高的值会导致 422 验证错误。
失败的调用不消耗信用点数。对 retryable: true 的错误重试一次;将 retryable: false 的错误记录为该平台的答案。
步骤
- 拉取列表:对用户提供的每个竞品 × 平台组合执行。
- 按时间段过滤:通过每条帖子的
publishedAt进行过滤——返回的是最新帖子,无论其发布时间多久。将“该时间段内无帖子”与“调用失败”分开报告。对于 X,保留时间段内的推文,并注明数据源是基于受欢迎程度排序的集合。 - 合并跨平台帖子:同一竞品在不同平台上发布时间相差几分钟且内容重叠的帖子视为一条。
- 为每条帖子打分:基于同一账号同一平台的数据:
参与度 = 点赞数 + 评论数(+ 分享/转发数,若有);相对提升 = 参与度 / 该账号所拉取帖子的参与度中位数。相对提升 ≥ 2 的帖子视为“杰出帖子”。 - 为每条帖子打标签:格式(短视频、长视频、图片、轮播、文本、链接)以及从文案推断出的 2-4 词话题。
- 与上一期周报比较(若提供):发布频率变化、新出现的话题、被舍弃或新增的格式。
周报格式
- 活动表格:竞品 × 平台 → 本期帖子数(以及与上一期相比的变化)。
- 杰出帖子:每个竞品最多 5 条——平台、日期、格式、文案首行、参与度和相对提升、链接、来源端点。
- 主题
[需人工审核]:竞品关注的 3-5 个话题或格式,每个需至少两条关联帖子支持。 - 缺失与注意事项:未提供或调用失败的平台、上述关于 Facebook 和 X 的说明、以及近似计数。
- 本次运行的信用总数。
需要人工审核的部分
- 话题标签和主题——它们是从文案中推断的。
- 任何对数据的“策略”解读;周报展示的是发布了什么以及这些帖子相对于该账号的表现如何,而不是为什么。