engagement-analysis

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Engagement Analysis

互动分析

Overview

概述

Measure how a specific post performed and what the audience said. Two moves: pull the stats, and pull the comments. Use

socialkit-api

for auth and endpoint details.

衡量特定帖子的表现以及受众反馈。可分为两个步骤：获取统计数据和获取评论。使用

socialkit-api

了解身份验证和端点详情。

Per-Video Stats

单个视频的统计信息

Source	Endpoint / MCP tool	Returns
YouTube	`/youtube/stats` / `youtube_stats`	views, likes, comments, duration, channel
TikTok	`/tiktok/stats` / `tiktok_stats`	views, likes, comments, shares, collects
Instagram	`/instagram/stats` / `instagram_stats`	likes, views, comments, author
Facebook	`/facebook/stats` / `facebook_stats`	views, reactions breakdown, shares
X/Twitter (single)	`/twitter/tweet` / `twitter_tweet`	tweet detail
LinkedIn (single)	`/linkedin/post` / `linkedin_post`	post detail

来源	端点 / MCP 工具	返回结果
YouTube	`/youtube/stats` / `youtube_stats`	观看次数、点赞数、评论数、时长、频道
TikTok	`/tiktok/stats` / `tiktok_stats`	观看次数、点赞数、评论数、分享数、收藏数
Instagram	`/instagram/stats` / `instagram_stats`	点赞数、观看次数、评论数、作者
Facebook	`/facebook/stats` / `facebook_stats`	观看次数、反应分类、分享数
X/Twitter（单条）	`/twitter/tweet` / `twitter_tweet`	推文详情
LinkedIn（单条）	`/linkedin/post` / `linkedin_post`	帖子详情

Comments

Source	Endpoint / MCP tool	Params
YouTube	`/youtube/comments` / `youtube_comments`	`url` , `limit` ; no cursor
TikTok	`/tiktok/comments` / `tiktok_comments`	`url` , `limit` , `cursor`
Instagram	`/instagram/comments` / `instagram_comments`	`url` , `limit` , `cursor`
Facebook	`/facebook/comments` / `facebook_comments`	`url` , `limit` , `cursor`

Comment fields vary by platform. Preserve missing counts as unknown, including null Instagram views/shares. Instagram comments expose collectionStatus and stopReason; hasMore=false alone does not establish completeness.

来源	端点 / MCP 工具	参数
YouTube	`/youtube/comments` / `youtube_comments`	`url` 、 `limit` ；无 cursor
TikTok	`/tiktok/comments` / `tiktok_comments`	`url` 、 `limit` 、 `cursor`
Instagram	`/instagram/comments` / `instagram_comments`	`url` 、 `limit` 、 `cursor`
Facebook	`/facebook/comments` / `facebook_comments`	`url` 、 `limit` 、 `cursor`

各平台的评论字段有所不同。缺失的计数应保留为未知，包括值为 null 的 Instagram 观看次数和分享次数。Instagram 评论会公开 collectionStatus 和 stopReason；仅凭 hasMore=false 无法确定数据是否完整。

Workflow

工作流

For "how did this do", call the stats endpoint for the video URL.
For "what did people say", call the comments endpoint. Set
```
limit
```
; use a returned cursor only where supported and cap the pages fetched.
To analyze sentiment, pull a bounded sample of returned comments, then summarize themes and tone yourself. State the sample size and collection limits; a popularity-ranked sample is not representative of the entire audience.
To compare many videos, use the bulk stats or bulk comments routes rather than looping.

对于“表现如何”之类的问题，调用视频 URL 对应的统计端点。
对于“大家说了什么”，调用评论端点。设置
```
limit
```
；仅在受支持时使用返回的
```
cursor
```
，并限制获取的页面数。
要分析情感倾向，请拉取数量受限的评论样本，然后自行总结主题和语气。说明样本量和采集限制；按热度排序的样本不能代表全部受众。
要比较多个视频，使用批量统计或批量评论端点，而不是循环调用。

Examples

示例

bash

export SOCIALKIT_API_KEY="YOUR_SOCIALKIT_ACCESS_KEY"

bash

export SOCIALKIT_API_KEY="YOUR_SOCIALKIT_ACCESS_KEY"

Stats

统计数据

curl -s "https://api.socialkit.dev/tiktok/stats?url=https://www.tiktok.com/@user/video/7370790114802322694"
-H "x-access-key: $SOCIALKIT_API_KEY"

Top comments

热门评论

curl -s "https://api.socialkit.dev/youtube/comments?url=https://youtube.com/watch?v=dQw4w9WgXcQ&limit=50"
-H "x-access-key: $SOCIALKIT_API_KEY"

undefined

curl -s "https://api.socialkit.dev/youtube/comments?url=https://youtube.com/watch?v=dQw4w9WgXcQ&limit=50"
-H "x-access-key: $SOCIALKIT_API_KEY"

undefined

Bulk

批量操作

Bulk stats:

/youtube/stats/bulk

/tiktok/stats/bulk

/instagram/stats/bulk

. Bulk comments:

/youtube/comments/bulk

/tiktok/comments/bulk

. All take a

urls

array by

POST

批量统计：

/youtube/stats/bulk

、

/tiktok/stats/bulk

、

/instagram/stats/bulk

。批量评论：

/youtube/comments/bulk

、

/tiktok/comments/bulk

。所有端点均通过

POST

接收

urls

数组。

Common Pitfalls

常见陷阱

Stats and comments need a single post URL, not a profile URL.
YouTube comments have no cursor input. Other supported comment endpoints may expose a cursor; stop when absent/repeated or the page budget is reached. A collected sample is not the full discussion.
Like counts and view counts are point-in-time. Note when the user needs a trend rather than a snapshot.
Sentiment is your analysis of the returned comments, not a field the API returns.

统计和评论接口需要提供单个帖子的 URL，而不是个人资料页 URL。
YouTube 评论不支持 cursor 输入。其他受支持的评论端点可能会公开 cursor；当 cursor 缺失或重复，或者已达到页面数量上限时停止采集。采集到的样本并不代表完整讨论。
点赞数和观看次数是时间点数据。如果用户需要趋势而非快照，应明确说明。
情感倾向是对返回评论进行分析得出的结果，并非 API 直接返回的字段。

Output Standards

输出标准

Lead with the headline numbers, then the comment themes.
When claiming sentiment, back it with a few quoted, high-engagement comments.
Keep the post URL and any IDs for follow-up.

Use only public supported content. Do not route posting, private-account access, login bypass, or unrelated website scraping here. See

socialkit-api

for authentication, endpoint-specific pagination, failure handling, and credits. Preserve unknown metrics and scope conclusions to the collected sample.

Use

/twitter/thread

twitter_thread

for a public author self-reply chain,

/twitter/article

twitter_article

for full native X Articles, and REST

/reddit/post

for a public Reddit submission. These do not imply Reddit comment collection or arbitrary website extraction.

先呈现核心数据，再介绍评论主题。
对情感倾向作出判断时，应引用几条互动量较高的评论作为依据。
保留帖子 URL 和所有 ID，以便后续操作。

仅使用公开且受支持的内容。不要使用此功能进行发帖、访问私有账号、绕过登录或抓取无关网站。有关身份验证、端点专属分页、失败处理和 credits 的详细信息，请参阅

socialkit-api

。保留未知指标，并将结论限定在已采集样本范围内。

对于公开作者的自回复链，使用

/twitter/thread

twitter_thread

；对于完整的原生 X Articles，使用

/twitter/article

twitter_article

；对于公开的 Reddit 帖子，使用 REST

/reddit/post

。这些端点不表示支持 Reddit 评论采集或任意网站内容提取。