Skip to main content

术语表

社交媒体数据术语表

用大白话解释你在通过 TikHub 对接 TikTok、抖音、小红书等 16 个平台时会遇到的标识符、数据概念与 API 术语。

平台标识符

aweme_id

抖音/TikTok 视频的唯一数字 ID(aweme 源自产品早期名称)。它出现在分享链接和所有视频类接口的响应中,是获取单条视频详情、统计数据或评论的主键。

抖音 API

sec_uid

抖音/TikTok 的加密用户标识(secure user ID),URL 安全且跨会话稳定。与纯数字 uid 不同,主页链接和大多数用户类接口都以它作为入参。

item_id

TikTok 视频唯一 ID 的另一种叫法,多数场景下与 aweme_id 等价。分享链接、嵌入代码和网页播放器都会引用它。

note_id(笔记 ID)

小红书笔记的唯一 ID,出现在分享链接的 /item/ 或 /discovery/item/ 之后,获取笔记详情或评论时必须提供。

小红书 API

xsec_token

小红书附加在分享链接上的短期签名令牌。部分笔记接口需要与 note_id 一同提交有效的 xsec_token;TikHub 的分享链接解析接口会自动提取。

BV 号 / AV 号

哔哩哔哩的两种视频 ID:早期的数字 AV 号与现行链接使用的 Base58 编码 BV 号,两者一一对应。TikHub 提供 bv_to_av 转换接口,任一格式均可使用。

哔哩哔哩 API

room_id(直播间 ID)

抖音/TikTok/快手/B站直播间的唯一 ID,是调用直播间接口和 WebSocket 弹幕流的入场券。

直播间 API

music_id

抖音/TikTok 音频的唯一 ID。音乐类接口用它返回音轨信息及使用该音频创作的视频列表——趋势分析的常用切入点。

challenge_id(话题/挑战 ID)

抖音/TikTok 话题(挑战)的唯一 ID。话题类接口以它为入参,返回话题信息、播放量与关联视频。

数据概念

弹幕

在视频或直播画面上滚动的实时评论(bullet comments)。B站视频有历史弹幕,直播间则是实时聊天流。TikHub 同时提供视频弹幕接口和 WebSocket 实时直播弹幕流。

直播间 API

互动指标

内容的可量化互动数据:点赞(digg_count)、评论、转发、收藏与播放量。其中播放量最稀缺——抖音已从多数接口中移除,需通过专门的统计接口获取。

粉丝画像

创作者粉丝群体的聚合画像:年龄段、性别比、地域、设备与兴趣标签。达人筛选与广告定向的核心依据。

API 概念

非官方 API

无需平台开发者资质、应用审核或 OAuth,即可访问平台公开数据的第三方接口。TikHub 提供的是对公开数据的只读非官方 API——不支持代替用户发布或操作账号。

API 总览

端点

API 中一个可调用的 URL 路径,如 /api/v1/tiktok/app/v3/fetch_one_video。TikHub 提供覆盖 16 个平台的 1,000+ 端点,每个端点有独立的价格、限速与免费额度资格。

游标分页

用上一次响应返回的游标(cursor/max_cursor/offset)逐页拉取评论、粉丝、Feed 等长列表,而非数字页码。把游标原样带回下一次请求,直到 has_more 为 false。

速率限制(RPS)

端点每秒可接受的最大请求数——TikHub 默认 10/秒,可通过 RPS 方案提升。超限返回 HTTP 429,应退避后重试。

定价

API 密钥 / Bearer 令牌

验证请求身份的凭据,以 Authorization: Bearer <token> 请求头发送。密钥在 TikHub 用户后台创建、仅创建时显示一次,并携带可配置的权限范围(Scopes)。

权限范围(Scopes)

控制 API 密钥可调用哪些端点族的开关。调用范围之外的端点会返回 403——使用新上线接口前,请先在后台更新密钥的 Scopes。

request_id

TikHub 每个 API 响应都携带的唯一标识(也在 X-Request-ID 响应头中)。联系技术支持时附上它,团队可在数秒内定位到你的具体请求。

cache_url

每个成功的 TikHub 响应都附带的链接,可在 24 小时内免费重新打开那一次响应。它是调试与分享工具 —— 当你的代码处理响应出错时(例如 JSON path 写错),可找回你已付费的那次响应,或把复现场景分享给同事。它并不意味着接口是缓存的:每次请求都返回全新的实时数据并独立计费,因此用相同参数再次调用是一次全新的实时请求,而非命中缓存。

MCP (Model Context Protocol)

让 AI 智能体(Claude、Cursor、VS Code 等)直接调用外部工具的开放协议。TikHub 提供 990+ 社媒数据 MCP 工具,一段配置即可让智能体实时获取 TikTok/抖音数据。

MCP 集成

WebSocket 实时流

以持久 ws/wss 连接实时推送直播间事件(弹幕、礼物、点赞、进场),无需轮询。TikHub 提供免费的 HTTP 组参端点,为你生成已签名的 WebSocket 连接地址。

直播间 API

计费概念

按量付费

TikHub 的计费模式:充值余额、按成功请求计费——无订阅、余额永不过期。失败请求(非 200)不扣费。

定价

rpd(每日请求量)

账户一天内的成功请求总数——阶梯折扣的计算变量。每日计数按后端计费时区(America/Los_Angeles)重置。

阶梯折扣

按每日请求量分段累进的自动折扣:1,000 次/日内原价,之后逐档 −10% 直至 30,000 次以上 −50%。每一段的请求按该段折后价计费,而非整日一个价。注意并非所有端点都参与折扣。

成本计算器

免费额度

无需付费获得的余额——注册赠送、每日签到与推荐奖励。标记 allow_free_credit 的端点可用;部分高级端点(如部分 Instagram、小红书接口)仅限付费余额。

准备好把这些术语用起来了?