统一对象
不管哪个平台,同一类数据都返回同样的字段。平台没有的字段是 null。
内容(帖子) post
用到它的接口:xiaohongshu.notes.get、xiaohongshu.users.notes.list、xiaohongshu.notes.search、douyin.videos.get、douyin.users.videos.list、douyin.videos.search、wechat_mp.articles.get、wechat_mp.accounts.articles.list、weibo.posts.get、weibo.users.posts.list、weibo.posts.search、bilibili.videos.get、bilibili.users.videos.list、bilibili.videos.search、tiktok.videos.search、tiktok.videos.get、tiktok.users.videos.list、youtube.videos.search、youtube.videos.get、youtube.channels.videos.list、instagram.users.posts.list、instagram.posts.get、instagram.hashtags.posts.list、instagram.reels.search、x.posts.search、x.posts.get、x.users.posts.list、threads.posts.search、threads.posts.get、threads.users.posts.list、telegram.channels.posts.list、telegram.posts.get、reddit.posts.search、reddit.subreddits.posts.list、reddit.posts.get、linkedin.posts.search、linkedin.posts.get、linkedin.companies.posts.list、facebook.pages.posts.list、facebook.posts.get、pinterest.pins.search、pinterest.pins.get、pinterest.boards.pins.list、kuaishou.videos.search、kuaishou.videos.get、kuaishou.users.videos.list、wechat_channels.users.videos.list、wechat_channels.videos.get、zhihu.posts.search、zhihu.questions.get、zhihu.questions.answers.list、zhihu.answers.get、zhihu.users.answers.list、douyin.xingtu.creators.videos.list、douyin.xingtu.videos.report.get、xiaohongshu.pgy.creators.notes.list、xiaohongshu.pgy.notes.get、xiaohongshu.pgy.notes.trending、douyin.index.videos.search、douyin.index.creators.videos.list、wechat_mp.articles.search、wechat_channels.videos.search、wechat_channels.users.live_replays.list、x.communities.posts.list、x.lists.posts.list、x.posts.quotes.list、x.users.mentions.list、x.posts.thread.list、x.posts.article.get
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 平台上的 ID,可以直接传给这个平台的详情接口:TikTok、抖音作品 ID,YouTube 视频 ID,Instagram、Threads 短码,X 帖子 ID,Telegram「频道/编号」,Reddit 短 ID,LinkedIn 帖子的 activity 数字,Pinterest Pin 数字 ID,快手 3x 开头的作品 ID,视频号作品 ID,知乎回答、问题或文章 ID,小红书笔记 ID,BV 号,微博 ID,公众号文章 ID |
platform |
string | 平台:tiktok、youtube、instagram、x、threads、telegram、reddit、linkedin、facebook、pinterest、xiaohongshu、douyin、kuaishou、wechat_mp、wechat_channels、weibo、zhihu、bilibili |
type |
string | video 视频、note 图文笔记、article 文章、post 帖子(微博、X、Threads、Telegram、Reddit、LinkedIn、Facebook、Pinterest、Instagram 图片帖)、question 知乎问题、answer 知乎回答 |
url |
string | 原文链接 |
title |
string | null | 标题(YouTube、Reddit、Pinterest、B 站、小红书、公众号有;知乎回答是所属问题的标题;其他平台为 null) |
text |
string | null | 正文或文案 |
created_at |
string | null | 发布时间,ISO 8601,UTC |
author.id |
string | null | 作者 ID,可以直接传给这个平台的账号接口 |
author.name |
string | null | 作者昵称 |
metrics.views |
number | null | 播放或阅读数(平台不公开时为 null) |
metrics.likes |
number | null | 点赞数(Reddit 是得分,Facebook 是表情回应总数) |
metrics.comments |
number | null | 评论数 |
metrics.shares |
number | null | 分享或转发数(X 是转帖数) |
metrics.quotes |
number | null | 引用数(X、Threads) |
metrics.reactions |
number | null | 表情回应总数(只有 Telegram) |
metrics.answers |
number | null | 回答数(只有知乎问题) |
metrics.upvote_ratio |
number | null | 点赞比例,0 到 1(只有 Reddit) |
metrics.repins |
number | null | 转存数(只有 Pinterest) |
metrics.favorites |
number | null | 收藏数(X 是书签数,Pinterest 是保存数) |
cover |
string | null | 封面图地址 |
duration_seconds |
number | null | 视频时长(秒) |
tags |
string[] | 话题标签(Reddit 是帖子的分类标签) |
community |
string | null | 所在版块(只有 Reddit) |
link |
string | null | Pin 指向的网页(只有 Pinterest) |
评论 comment
用到它的接口:xiaohongshu.notes.comments.list、douyin.videos.comments.list、wechat_mp.articles.comments.list、weibo.posts.comments.list、bilibili.videos.comments.list、tiktok.videos.comments.list、tiktok.shop.products.reviews.list、youtube.videos.comments.list、instagram.posts.comments.list、x.posts.replies.list、threads.posts.replies.list、reddit.posts.comments.list、facebook.posts.comments.list、kuaishou.videos.comments.list、wechat_channels.videos.comments.list、zhihu.answers.comments.list、tiktok.videos.comments.replies.list、douyin.videos.comments.replies.list、xiaohongshu.notes.comments.replies.list、kuaishou.videos.comments.replies.list、zhihu.comments.replies.list、weibo.comments.replies.list、instagram.posts.comments.replies.list、bilibili.videos.comments.replies.list、wechat_mp.articles.comments.replies.list、youtube.videos.comments.replies.list、wechat_channels.videos.comments.replies.list
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 评论 ID |
platform |
string | 平台 |
text |
string | null | 评论内容 |
created_at |
string | null | 发布时间,ISO 8601,UTC |
author.id |
string | null | 评论者 ID(公众号留言没有) |
author.name |
string | null | 评论者昵称 |
likes |
number | null | 点赞数(Reddit 是得分,Facebook 是表情回应数) |
reply_count |
number | null | 回复数 |
replies_token |
string | null | 取这条评论的回复要传的令牌(只有 YouTube,传给评论的回复) |
rating |
number | null | 星级,1–5(只有 TikTok Shop 商品评价) |
variant |
string | null | 买的规格(只有 TikTok Shop 商品评价) |
images |
string[] | 买家晒图(只有 TikTok Shop 商品评价) |
verified_purchase |
boolean | null | 是否已验证购买(只有 TikTok Shop 商品评价) |
账号 account
用到它的接口:xiaohongshu.users.get、douyin.users.get、wechat_mp.accounts.get、weibo.users.get、bilibili.users.get、tiktok.users.get、youtube.channels.get、instagram.users.get、x.users.get、threads.users.get、telegram.channels.get、reddit.subreddits.get、linkedin.users.get、linkedin.companies.get、facebook.pages.get、meta.advertisers.search、google.advertisers.search、kuaishou.users.get、wechat_channels.users.get、zhihu.users.get、tiktok.users.search、douyin.users.search、xiaohongshu.users.search、kuaishou.users.search、zhihu.users.search、weibo.users.search、instagram.users.search、youtube.channels.search、bilibili.users.search、wechat.accounts.search、wechat_mp.accounts.owner.get、x.users.followers.list、x.users.following.list、x.posts.retweeters.list、x.communities.get、x.communities.members.list、x.lists.members.list、x.lists.followers.list、x.users.search
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 账号 ID,就是这个平台账号接口要的 id:TikTok、Instagram、X、Threads 是用户名,Telegram 是频道名,Reddit 是版块名,LinkedIn 是主页链接 /in/ 或 /company/ 后面那一串,Facebook 是主页名或数字 ID,YouTube 是 UC 开头的频道 ID,抖音是 sec_user_id,快手是数字用户 ID,视频号是 v2_…@finder,知乎是主页链接里的用户 ID,小红书是用户 ID,B 站和微博是 UID,公众号是原始 ID |
platform |
string | 平台 |
name |
string | null | 昵称 |
handle |
string | null | 平台号:用户名、抖音号、小红书号、微信号 |
uid |
string | null | 抖音数字 uid(只有抖音账号;巨量算数的达人接口要用) |
bio |
string | null | 简介 |
avatar |
string | null | 头像地址 |
url |
string | null | 主页链接 |
verified |
boolean | null | 是否认证 |
verified_reason |
string | null | 认证说明或认证主体 |
metrics.followers |
number | null | 粉丝数 |
metrics.following |
number | null | 关注数 |
metrics.posts |
number | null | 作品或文章数 |
metrics.likes |
number | null | 获赞数 |
metrics.views |
number | null | 总播放量(只有 YouTube 频道) |
metrics.employees |
number | null | 员工数(只有 LinkedIn 公司) |
metrics.weekly_active_users |
number | null | 每周活跃人数(只有 Reddit 版块) |
metrics.articles |
number | null | 文章数(只有知乎账号搜索) |
private |
boolean | null | 是否私密账号(只有 Instagram 账号搜索) |
owner |
object | null | 公众号注册主体:name 公司名、country、registered_at 注册时间、verified_at 认证日期、third_party_services 授权的第三方(只有公众号主体接口) |
metrics.ads |
number | null | 大约有多少条广告(只有 Google 广告主) |
metrics.instagram_followers |
number | null | 关联的 Instagram 粉丝数(只有 Meta 广告主) |
location |
string | null | 地区(LinkedIn、Facebook) |
category |
string | null | 类别:Facebook 主页类别、LinkedIn 公司行业、微信账号类型(公众号、服务号、视频号、小程序) |
website |
string | null | 官网(LinkedIn 公司、Facebook 主页) |
experience |
object[] | LinkedIn 个人公开的任职组织:organization、location、start、end |
education |
object[] | LinkedIn 个人公开的学校和组织:school、start、end |
热榜条目 trend
用到它的接口:douyin.trends.list、weibo.trends.list、bilibili.trends.list、tiktok.trends.list、x.trends.list、kuaishou.trends.list、zhihu.trends.list、xiaohongshu.pgy.keywords.related、douyin.index.keywords.related、douyin.index.trends.list、wechat.keywords.related
| 字段 | 类型 | 说明 |
|---|---|---|
rank |
number | 排名;0 表示置顶 |
platform |
string | 平台 |
keyword |
string | 热搜词 |
heat |
number | null | 热度值(各平台口径不同) |
label |
string | null | 标签,例如「置顶」「热」 |
url |
string | null | 在平台上搜索这个词的链接 |
广告 ad
用到它的接口:tiktok.ads.search、tiktok.ads.get、linkedin.ads.search、linkedin.ads.get、meta.ads.search、meta.advertisers.ads.list、meta.ads.get、google.advertisers.ads.list、google.ads.get
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 广告 ID,可以直接传给这个广告库的详情接口:Meta 是广告库 ID,Google 是「AR…/CR…」,LinkedIn 和 TikTok 是数字 ID |
platform |
string | 广告库:meta、google、linkedin、tiktok |
url |
string | null | 广告在广告库里的链接 |
advertiser.id |
string | null | 广告主 ID:Meta 是 Facebook 主页 ID,Google 是 AR 开头的 ID,可以直接传给广告主的广告列表 |
advertiser.name |
string | null | 广告主名字 |
format |
string | null | 广告格式,例如 image、video、text、dpa(动态商品广告)、Carousel Ad |
headline |
string | null | 标题 |
text |
string | null | 正文文案 |
cta |
string | null | 按钮文字,例如 Shop now |
landing_url |
string | null | 落地页 |
images |
string[] | 图片地址 |
videos |
string[] | 视频地址 |
first_shown |
string | null | 开始投放的时间,ISO 8601,UTC |
last_shown |
string | null | 最近一次投放的时间(还在投放的广告是今天) |
active |
boolean | null | 是否还在投放(只有 Meta) |
placements |
string[] | 投放位置(只有 Meta):facebook、instagram、messenger、threads、audience_network |
countries |
string[] | 投放的国家,两位代码(平台公开时才有) |
impressions |
{min, max} | null | 展示量区间(平台公开时才有;TikTok 是触达人数区间) |
paid_by |
string | null | 出资方(LinkedIn,以及 Meta 的政治广告) |
商品 product
用到它的接口:tiktok.shop.products.search、tiktok.shop.products.get、tiktok.shop.sellers.products.list
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 商品 ID,可以直接传给商品详情和商品评价接口 |
platform |
string | 平台:tiktok |
url |
string | null | 商品页链接 |
title |
string | null | 商品标题 |
images |
string[] | 商品图片(列表里只有主图) |
price.amount |
number | null | 售价 |
price.original |
number | null | 原价(有折扣时才有) |
price.currency |
string | null | 币种,例如 USD |
rating |
number | null | 评分,满分 5 |
review_count |
number | null | 评价数 |
sold_count |
number | null | 销量 |
category |
string | null | 最细一级的类目 |
shop.id |
string | null | 店铺 ID,可以直接传给店铺的商品接口 |
shop.name |
string | null | 店铺名 |
shop.rating |
number | null | 店铺评分(只有商品详情) |
shop.followers |
number | null | 店铺粉丝数(只有商品详情) |
shop.sold_count |
number | null | 店铺总销量(只有商品详情) |
country |
string | null | 国家站,例如 US |
达人 creator
用到它的接口:douyin.xingtu.creators.lookup、douyin.xingtu.creators.search、douyin.xingtu.creators.get、douyin.xingtu.creators.similar.list、xiaohongshu.pgy.creators.search、xiaohongshu.pgy.creators.get、xiaohongshu.pgy.creators.similar.list
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 营销平台上的达人 ID:抖音是星图 ID,小红书是用户 ID;同一平台的达人类接口都用它 |
platform |
string | 内容平台:douyin、xiaohongshu |
name |
string | null | 昵称 |
avatar |
string | null | 头像 |
gender |
'male' | 'female' | null | 性别 |
location |
string | null | 地区 |
account_id |
string | null | 对应的内容平台账号 ID(抖音 sec_user_id、小红书用户 ID),可以传给账号接口 |
handle |
string | null | 抖音号、小红书号 |
url |
string | null | 星图或蒲公英上的达人主页 |
mcn |
string | null | 签约机构(只有蒲公英博主资料) |
uid |
string | null | 抖音数字 uid(只有星图;巨量算数的达人接口要用) |
tags |
string[] | 内容标签 |
followers |
number | null | 粉丝数 |
prices |
{type, price}[] | 报价(人民币):星图是 21–60 秒和 60 秒以上视频(只有搜索结果带,完整报价用报价接口),蒲公英是图文和视频笔记 |
metrics.expected_views |
number | null | 星图预估的单条播放量 |
metrics.views_median_30d |
number | null | 近 30 天播放中位数 |
metrics.interaction_rate_30d |
number | null | 近 30 天互动率,0–1 |
metrics.completion_rate_30d |
number | null | 近 30 天完播率,0–1 |
metrics.cpm_21_60s |
number | null | 21–60 秒视频的预估 CPM(元) |
metrics.star_index |
number | null | 星图指数 |
metrics.read_median |
number | null | 蒲公英:阅读中位数 |
metrics.engagement_median |
number | null | 蒲公英:互动中位数 |
metrics.picture_read_cost |
number | null | 蒲公英:图文单次阅读成本(元) |
报价 rate
用到它的接口:douyin.xingtu.creators.rates.get
| 字段 | 类型 | 说明 |
|---|---|---|
platform |
string | 平台 |
type |
string | 合作类型,例如植入视频、定制视频 |
price |
number | null | 报价 |
original_price |
number | null | 原价 |
currency |
string | 币种:CNY |
settlement |
string | null | 结算方式,例如固定价格 |
available |
boolean | null | 是否开放接单 |
分布 breakdown
用到它的接口:douyin.xingtu.creators.followers.get、douyin.xingtu.creators.audience.get、douyin.xingtu.creators.content_mix.get、xiaohongshu.pgy.creators.followers.get、douyin.index.keywords.audience.get、douyin.index.creators.audience.get
| 字段 | 类型 | 说明 |
|---|---|---|
platform |
string | 平台 |
dimension |
string | 维度:gender、age、province、city、city_tier、device、interest、crowd(八大人群)、content |
title |
string | null | 平台上的名称,例如年龄分布 |
summary |
string | null | 平台给的一句话结论,例如「31到40岁居多,占比42%」 |
items |
{label, value, share, tgi}[] | 每一项的人数(或条数)、占比(0–1)和 TGI(偏好度,100 是平均,大于 100 表示更偏好;只有巨量算数给),从多到少 |
数据指标 stats
用到它的接口:douyin.xingtu.creators.metrics、douyin.xingtu.creators.costs.get、xiaohongshu.pgy.creators.metrics、xiaohongshu.pgy.creators.performance、xiaohongshu.pgy.creators.costs.history、xiaohongshu.pgy.creators.followers.metrics、xiaohongshu.pgy.creators.followers.history、xiaohongshu.pgy.keywords.metrics、xiaohongshu.pgy.keywords.history、douyin.index.keywords.history、douyin.index.creators.metrics、douyin.users.history、wechat.index.history
| 字段 | 类型 | 说明 |
|---|---|---|
platform |
string | 平台 |
subject_id |
string | 这组数据属于谁:达人 ID 或关键词 |
period |
string | null | 统计周期;按天列出的数据是那一天(YYYY-MM-DD) |
metrics |
object | 指标,名字见每个接口页;比例都是 0–1,金额都是人民币元 |
字幕 transcript
用到它的接口:youtube.videos.transcript.get、tiktok.videos.transcript.get、instagram.posts.transcript.get、x.posts.transcript.get、linkedin.posts.transcript.get、reddit.posts.transcript.get、meta.ads.transcript.get
| 字段 | 类型 | 说明 |
|---|---|---|
id |
string | 视频或帖子的 ID,和这个平台详情接口用的一样 |
platform |
string | 平台 |
url |
string | null | 视频或帖子链接 |
language |
string | null | 字幕语言(平台给的时候才有) |
text |
string | 字幕全文 |
segments |
{start, end, text}[] | 带时间的分段,单位秒(YouTube、TikTok、Instagram、Reddit 有,其他平台为空) |
duration_seconds |
number | null | 视频时长(秒) |
source |
'captions' | 'ai' | null | captions 平台自带字幕、ai AI 转写、null 不确定 |
文章互动数据 article_stats
用到它的接口:wechat_mp.articles.stats
| 字段 | 类型 | 说明 |
|---|---|---|
platform |
string | 平台 |
url |
string | 文章链接 |
reads |
number | null | 阅读数 |
likes |
number | null | 点赞数 |
wows |
number | null | 「在看」数 |
shares |
number | null | 分享数 |
favorites |
number | null | 收藏数 |
comments |
number | null | 留言数 |