SocialToAI免费开始控制台

返回格式

不管哪个平台,SocialToAI 的每个调用都返回同一种结构:外层说明调了什么、结果如何、扣了多少,里面是一个对象列表。对象有 38 种,每种在所有平台上字段相同。平台给不了的字段是 null,不会缺失。

外层结构

schema_version 是 v1。客户端应当忽略不认识的字段和代码。

字段类型说明
request_idstring这次调用的编号,报告问题时带上它。
schema_version"v1"固定是 "v1"。
fetched_atstring从平台取到数据的时间,ISO 8601(UTC)。
actionstring执行的动作。
opstring执行的平台独有接口,只在 call 时出现。(可能不出现)
platformstring这份结果来自哪个平台。
targetstring这份结果对应哪个目标,照你写的原样给出;请求里给了多个目标时才有。(可能不出现)
status"ok" | "empty" | "error" | "not_supported" | "timeout" | "skipped"ok、empty、error、not_supported、timeout 或 skipped。
reasonstring这份结果为什么被跳过;status 为 skipped 时才有。(可能不出现)
unavailablestring[]这个平台给不了的字段路径,这些字段在每一条里都是 null。
page.has_moreboolean后面还有下一页时为 true。(可能不出现)
page.cursorstring原样填进 cursor 取下一页;最后一页没有它。(可能不出现)
page.cursor_expires_atstringcursor 的失效时间,ISO 8601(UTC)。(可能不出现)
warningsarray不影响成功、但值得知道的提示。
applied_paramsobject实际生效的参数。
includesobject用 include 要的附加部分,按名字列出:各有自己的 status 和 cost_credits,取到的字段已经填进每一条。(可能不出现)
cost_creditsinteger这份结果扣了多少积分;失败时为 0。
billing.cost_creditsinteger整个请求扣了多少积分。
billing.balance_creditsinteger扣完之后的余额。
billing.today_spend_creditsinteger今天(UTC)已经花掉的积分。
billing.daily_limit_creditsinteger | null每日上限;没设时为 null。
billing.daily_remaining_creditsinteger | null每日上限还剩多少;没设时为 null。
billing.displaystring一句可以直接复述给你的话。
replayedboolean同一个幂等键重放已有结果时为 true,本次不扣。
replayed_cost_creditsinteger第一次返回时扣了多少积分;replayed 为 true 时才有。(可能不出现)
watch_hintstring一行提示:可以让它每天自动跑,每小时最多一次。HTTP 只在同一目标重复时才有,写的是建定时的请求。(可能不出现)
empty_reason"no_match" | "filtered"为什么是空的:no_match(没有匹配),或 filtered(被你设的条件筛掉)。status 为 empty 时才有。(可能不出现)

状态

status扣费含义
ok扣调用成功,结果在 items 里。
empty扣调用成功,但没有结果。搜索正常执行、只是没搜到,照常扣费。
error不扣调用失败。error 说明原因,fix 说明怎么办。
not_supported不扣这个平台没有这个动作。
timeout不扣结果不确定。我们不会自动重试。
skipped不扣这一部分没有执行。

对象

每个对象用 type 说明自己是什么。时间是 ISO 8601(UTC)。评论的作者一律匿名:评论带一个匿名标记,在同一次返回里保持一致。

content帖子、视频、笔记或文章

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"content"对象类型。
urlstring | null能直接打开的链接。
format"video" | "image" | "text" | "article" | nullvideo、image、text 或 article。
titlestring | null标题。
textstring | null正文或文案。
published_atstring | null发布时间,ISO 8601(UTC)。
author.idstring | null作者的账号编号。
author.usernamestring | null作者的账号名。
author.namestring | null作者的显示名。
author.verifiedboolean | null作者是否认证。
author.followersinteger | null作者的粉丝数。
metrics.likesinteger | null点赞数。
metrics.commentsinteger | null评论数。
metrics.sharesinteger | null分享数。
metrics.collectsinteger | null收藏数。
metrics.viewsinteger | null播放或阅读数。
metrics.repostsinteger | null转发数。
imagesstring[] | null图片地址。
hashtagsstring[] | null话题标签,不带 #。
is_pinnedboolean | null是否被作者置顶。

account账号

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"account"对象类型。
usernamestring | null账号名。
namestring | null显示名。
urlstring | null主页链接。
biostring | null简介。
verifiedboolean | null是否认证。
followersinteger | null粉丝数。
followinginteger | null关注数。
posts_countinteger | null发布的内容数。

comment评论

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"comment"对象类型。
urlstring | null评论的链接,平台有才给。
textstring | null评论原文。
published_atstring | null发布时间,ISO 8601(UTC)。
author.labelstring匿名标记,在同一次返回里保持一致;写的人不具名。
metrics.likesinteger | null点赞数。
reply_countinteger | null回复数。
content_idstring | null评论所在内容的编号。
parent_idstring | null它直接回复的那条评论;一级评论为 null。
root_idstring | null所在回复串的一级评论。

entry:trend

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"trend"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fieldsobject热榜条目没有额外字段。

entry:transcript

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"transcript"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.langstring | null逐字稿的语言。
fields.textstring | null全文。
fields.segmentsarray | null带时间的分段:start、end、text。

entry:creator_rates

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"creator_rates"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.currencystring | null金额的币种。
fields.ratesarray | null达人的报价:名称、金额、结算方式、是否开放。

entry:community

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"community"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.descriptionstring | null社区简介。
fields.nsfwboolean | null是否标为成人内容。
fields.created_atstring | null创建时间,ISO 8601(UTC)。
fields.membersinteger | null成员数。

entry:product

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"product"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.descriptionstring | null商品描述。
fields.pricestring | null现价,十进制字符串,币种见 fields.currency。
fields.original_pricestring | null折前价。
fields.currencystring | null价格的币种。
fields.imagesstring[] | null图片地址。
fields.ratingnumber | null评分。
fields.soldinteger | null销量。
fields.reviews_countinteger | null评价数。
fields.shop.idstring | null店铺编号。
fields.shop.namestring | null店铺名称。

entry:review

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"review"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.product_idstring | null评价所属的商品。
fields.textstring | null评价原文。
fields.ratingnumber | null给出的评分。
fields.published_atstring | null发布时间,ISO 8601(UTC)。
fields.author.labelstring匿名标记,在同一次返回里保持一致;写的人不具名。
fields.imagesstring[] | null图片地址。
fields.variantstring | null购买的规格。

entry:keyword_history

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"keyword_history"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.pointsarray | null逐日数据,每天一项,按日期从早到晚:date、search_index、composite_index、notes、impressions、views、engagements。

entry:keyword_related

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"keyword_related"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.related_tostring | null你查的那个关键词。
fields.relation"query" | "posts" | "prior" | "after" | "suggestion" | null关联方式:query 是和你查的词一起被搜,posts 是在内容里一起出现,prior 是人们搜它之前搜的词,after 是之后搜的词,suggestion 是在搜索框里输入你查的词时平台给的联想词。
fields.relevancenumber | null和你查的词的相关度,0 到 1。
fields.search_indexinteger | null这个关联词的搜索指数:平台算出的指数,不是搜索次数;平台没给这个词的数值时为 null。
fields.composite_indexinteger | null这个关联词的综合指数:平台按相关内容的热度算出的指数,不是次数。

entry:keyword_audience

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"keyword_audience"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.agearray | null按年龄段分:label、share、tgi。tgi 表示这个人群的偏好程度,100 为平均水平。
fields.genderarray | null按性别分:label、share、tgi。
fields.provincearray | null按省份分:label、share、tgi。
fields.cityarray | null按城市分,只列占比最高的一批,各项加起来不到 1:label、share、tgi。
fields.city_tierarray | null按城市等级分:label、share、tgi。
fields.interestarray | null按兴趣分。一个人可以有多个兴趣,各项加起来不等于 1:label、share、tgi。

entry:brand_history

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"brand_history"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.categorystring | null平台给这个品牌归的行业,用平台的原话。
fields.pointsarray | null逐日指数,每天一项,按日期从早到晚:date、search_index、content_index、spread_index。

entry:brand_metrics

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"brand_metrics"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.categorystring | null平台给这个品牌归的行业,用平台的原话。
fields.search_indexinteger | null这段时间搜索指数的日均值。
fields.content_indexinteger | null这段时间内容指数的日均值。
fields.spread_indexinteger | null这段时间传播指数的日均值。
fields.benchmarksarray | null同行业的参照值:行业全部品牌的均值,和头部品牌的均值。每项有 scope、search_index、content_index、spread_index。

entry:account_history

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"account_history"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.daysinteger | null统计的是最近多少天。
fields.gained.followersinteger | null净增粉丝数,掉粉时为负。
fields.gained.likesinteger | null新增点赞数。
fields.gained.commentsinteger | null新增评论数。
fields.gained.sharesinteger | null新增分享数。
fields.gained.postsinteger | null新发布的内容数。
fields.change.followersnumber | null净增粉丝数相比上一个周期的变化比例。
fields.change.likesnumber | null新增点赞数相比上一个周期的变化比例。
fields.change.commentsnumber | null新增评论数相比上一个周期的变化比例。
fields.change.sharesnumber | null新增分享数相比上一个周期的变化比例。
fields.change.postsnumber | null新发布的内容数相比上一个周期的变化比例。
fields.totals.followersinteger | null现在的粉丝数。
fields.totals.likesinteger | null累计获赞数。
fields.totals.postsinteger | null累计作品数。

entry:index_creator_metrics

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"index_creator_metrics"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.average_7d.likesnumber | null最近一周平均每天新增的点赞数。
fields.average_7d.followsnumber | null最近一周平均每天的涨粉数,平台的口径:不是粉丝净增,比按粉丝增减算出来的大,掉粉的账号也是正数。
fields.average_7d.sharesnumber | null最近一周平均每天新增的分享数。
fields.average_7d.commentsnumber | null最近一周平均每天新增的评论数。
fields.average_30d.likesnumber | null最近一个月平均每天新增的点赞数。
fields.average_30d.followsnumber | null最近一个月平均每天的涨粉数,平台的口径(不是粉丝净增)。
fields.average_30d.sharesnumber | null最近一个月平均每天新增的分享数。
fields.average_30d.commentsnumber | null最近一个月平均每天新增的评论数。
fields.change_7d.likesnumber | null最近一周日均新增点赞数相比上一周的变化比例。
fields.change_7d.followsnumber | null最近一周日均涨粉数(平台的口径)相比上一周的变化比例。
fields.change_7d.sharesnumber | null最近一周日均新增分享数相比上一周的变化比例。
fields.change_7d.commentsnumber | null最近一周日均新增评论数相比上一周的变化比例。
fields.change_30d.likesnumber | null最近一个月日均新增点赞数相比上一个月的变化比例。
fields.change_30d.followsnumber | null最近一个月日均涨粉数(平台的口径)相比上一个月的变化比例。
fields.change_30d.sharesnumber | null最近一个月日均新增分享数相比上一个月的变化比例。
fields.change_30d.commentsnumber | null最近一个月日均新增评论数相比上一个月的变化比例。

entry:creator

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"creator"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.account_idstring | null这位达人的平台账号编号,可以传给同平台的账号类调用。
fields.usernamestring | null账号名。
fields.locationstring | null所在地,用平台的原话。
fields.categoriesstring[] | null内容类目(一级),用平台的原话。
fields.subcategoriesstring[] | null内容类目(二级),用平台的原话。
fields.followersinteger | null粉丝数。

entry:audience

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"audience"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.measured_atstring | null画像数据对应的日期,以北京时间当天零点表示。
fields.genderarray | null按性别分:name、share、count。
fields.agearray | null按年龄段分:name、share、count。
fields.provincearray | null按省份分:name、share、count。
fields.cityarray | null按城市分,只列粉丝最多的几个:name、share、count。
fields.interestarray | null按兴趣分:name、share、count。
fields.devicearray | null按手机品牌分:name、share、count。
fields.city_tierarray | null按城市等级分:name、share、count。
fields.crowdarray | null按平台划分的消费人群分:name、share、count。
fields.purchase_categoryarray | null按购买的品类分:name、share、count。
fields.purchase_amountarray | null按每单消费金额分:name、share、count。

entry:xingtu_creator_metrics

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"xingtu_creator_metrics"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.videosinteger | null统计周期内的视频数。
fields.median_viewsinteger | null单条视频播放数的中位数。
fields.average_likesinteger | null单条视频的平均点赞数。
fields.average_commentsinteger | null单条视频的平均评论数。
fields.average_sharesinteger | null单条视频的平均分享数。
fields.engagement_ratenumber | null互动率,0 到 1。
fields.engagement_rate_percentilenumber | null互动率超过同类达人的比例,0 到 1。
fields.completion_ratenumber | null完播率,0 到 1。只算作者是星图达人、大约 2023 年以后发布的视频,0 也可能是没有数据。
fields.completion_rate_percentilenumber | null完播率超过同类达人的比例,0 到 1。
fields.currencystring | null下面四项成本的货币。
fields.cpm_integratedstring | null植入视频的预期千次播放成本。
fields.cpm_customstring | null定制视频的预期千次播放成本。
fields.cpe_integratedstring | null植入视频的预期单次互动成本。
fields.cpe_customstring | null定制视频的预期单次互动成本。

entry:xingtu_creator_post

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"xingtu_creator_post"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.published_atstring | null发布时间。
fields.durationnumber | null视频时长,秒。
fields.viewsinteger | null播放数。
fields.likesinteger | null点赞数。
fields.commentsinteger | null评论数。
fields.completion_ratenumber | null完播率,0 到 1。
fields.engagement_ratenumber | null互动率,0 到 1。

entry:pgy_creator_metrics

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"pgy_creator_metrics"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.notesinteger | null统计周期内的笔记数。
fields.median_impressionsinteger | null单篇笔记曝光数的中位数。
fields.median_readsinteger | null单篇笔记阅读数的中位数。
fields.median_engagementsinteger | null单篇笔记互动数的中位数。
fields.median_likesinteger | null单篇笔记点赞数的中位数。
fields.median_collectsinteger | null单篇笔记收藏数的中位数。
fields.median_commentsinteger | null单篇笔记评论数的中位数。
fields.median_sharesinteger | null单篇笔记分享数的中位数。
fields.engagement_ratenumber | null互动率,0 到 1。
fields.video_completion_ratenumber | null视频笔记的完播率,0 到 1。
fields.image_3s_read_ratenumber | null图文笔记的 3 秒阅读率,0 到 1。
fields.hundred_like_sharenumber | null点赞过百的笔记占比,0 到 1。
fields.thousand_like_sharenumber | null点赞过千的笔记占比,0 到 1。
fields.impressions_percentilenumber | null曝光中位数超过同类博主的比例,0 到 1。
fields.reads_percentilenumber | null阅读中位数超过同类博主的比例,0 到 1。
fields.engagements_percentilenumber | null互动中位数超过同类博主的比例,0 到 1。

entry:pgy_creator_post

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"pgy_creator_post"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.format"image" | "video" | nullimage 是图文笔记,video 是视频笔记。
fields.published_atstring | null发布日期。平台只给到日,以北京时间当天零点表示。
fields.cover_urlstring | null封面图地址。
fields.is_sponsoredboolean | null是否商业合作笔记:有合作品牌(brand)的就是。
fields.is_promotedboolean | null这篇笔记是否带过付费推广流量,和是不是合作笔记无关。
fields.brandstring | null合作的品牌,用平台的原话;不是合作笔记时为 null。
fields.viewsinteger | null阅读数。
fields.likesinteger | null点赞数。
fields.collectsinteger | null收藏数。

entry:pgy_creator_costs

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"pgy_creator_costs"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.datestring | null数据算到哪一天:北京时间的一个自然日,写成这个日期的 UTC 零点。
fields.currencystring | null各项花费的货币。
fields.image_cpmstring | null图文笔记的预估 CPM;蒲公英没有估出来时为 null。
fields.image_cpm_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.video_cpmstring | null视频笔记的预估 CPM;蒲公英没有估出来时为 null。
fields.video_cpm_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.image_cpestring | null图文笔记的预估互动单价;蒲公英没有估出来时为 null。
fields.image_cpe_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.video_cpestring | null视频笔记的预估互动单价;蒲公英没有估出来时为 null。
fields.video_cpe_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.image_read_coststring | null图文笔记的预估阅读单价;蒲公英没有估出来时为 null。
fields.image_read_cost_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.video_read_coststring | null视频笔记的预估阅读单价;蒲公英没有估出来时为 null。
fields.video_read_cost_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.image_shop_visit_coststring | null图文笔记的预估外溢进店单价;蒲公英没有估出来时为 null。
fields.image_shop_visit_cost_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.video_shop_visit_coststring | null视频笔记的预估外溢进店单价;蒲公英没有估出来时为 null。
fields.video_shop_visit_cost_percentilenumber | null低于多少同类博主(蒲公英的“优于同行”),0 到 1。
fields.median_impressionsinteger | null单篇笔记曝光数的中位数。
fields.median_impressions_percentilenumber | null超过了多少同类博主,0 到 1。
fields.median_readsinteger | null单篇笔记阅读数的中位数。
fields.median_reads_percentilenumber | null超过了多少同类博主,0 到 1。
fields.median_engagementsinteger | null单篇笔记互动数的中位数。
fields.median_engagements_percentilenumber | null超过了多少同类博主,0 到 1。
fields.median_shop_visitsinteger | null单篇笔记带来的外溢进店人数的中位数。
fields.median_shop_visits_percentilenumber | null超过了多少同类博主,0 到 1。
fields.follower_growthnumber | null近 30 天粉丝增长率:0.037 是涨了 3.7%,掉粉时为负。
fields.follower_growth_percentilenumber | null超过了多少同类博主,0 到 1。
fields.invite_reply_ratenumber | null合作邀约在 48 小时内回复的比例,0 到 1。
fields.easy_to_reachboolean | null蒲公英是否标了“好联系”。
fields.active_days_7dinteger | null近 7 天里活跃的天数。
fields.is_activeboolean | null蒲公英是否标了“活跃”。
fields.notes_30dinteger | null近 30 天发布的笔记数,日常和合作笔记都算。
fields.highlightstring | null蒲公英标的优势,平台的原话;没有时为 null。
fields.highlight_reasonstring | null这个优势的说明,平台的原话。
fields.content_mixarray | null内容类型占比,占比高的在前:category、share。
fields.industriesstring[] | null合作过的行业,平台的原话。

entry:pgy_creator_followers

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"pgy_creator_followers"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.followersinteger | null粉丝数。
fields.gainedinteger | null近 30 天粉丝净增,掉粉时为负。
fields.growthnumber | null近 30 天粉丝增长率:0.008 是涨了 0.8%。
fields.growth_percentilenumber | null超过了多少同类博主,0 到 1。
fields.active_followersinteger | null近 28 天在小红书上活跃过的粉丝数。
fields.active_sharenumber | null占全部粉丝的比例,0 到 1。
fields.active_percentilenumber | null这个占比超过了多少同类博主,0 到 1。
fields.engaged_followersinteger | null近 30 天和博主笔记有过互动的粉丝数。
fields.engaged_sharenumber | null占全部粉丝的比例,0 到 1。
fields.engaged_percentilenumber | null这个占比超过了多少同类博主,0 到 1。
fields.reading_followersinteger | null近 30 天读过博主笔记的粉丝数。
fields.reading_sharenumber | null占全部粉丝的比例,0 到 1。
fields.reading_percentilenumber | null这个占比超过了多少同类博主,0 到 1。
fields.buying_followersinteger | null近 30 天在小红书上买过东西的粉丝数。
fields.buying_sharenumber | null占全部粉丝的比例,0 到 1。

entry:pgy_creator_cost_history

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"pgy_creator_cost_history"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.daysinteger | null统计的是最近多少天。
fields.currencystring | null各项花费的货币。
fields.datestring | null整段的数算到哪一天,写成这个日期(北京时间)的 UTC 零点。
fields.cpmstring | nullCPM:每千次曝光的花费;没有时为 null。
fields.cpestring | nullCPE:每次互动的花费;没有时为 null。
fields.cpvstring | nullCPV:每次阅读的花费;没有时为 null。
fields.shop_visit_coststring | null外溢进店单价;没有时为 null。
fields.median_impressionsinteger | null单篇笔记曝光数的中位数。
fields.median_readsinteger | null单篇笔记阅读数的中位数。
fields.median_engagementsinteger | null单篇笔记互动数的中位数。
fields.median_shop_visitsinteger | null单篇笔记带来的外溢进店人数的中位数。
fields.pointsarray | null逐日的同样这些数,从早到晚:date、cpm、cpe、cpv、shop_visit_cost 和四个中位数。

entry:pgy_note

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"pgy_note"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.format"image" | "video" | nullimage 是图文笔记,video 是视频笔记。
fields.textstring | null笔记正文。
fields.published_atstring | null发布时间。
fields.imagesstring[] | null图片地址,按笔记里的顺序。
fields.creator_idstring | null博主的蒲公英博主编号,其他蒲公英博主接口可直接用。
fields.creator_namestring | null博主昵称。
fields.brandstring | null报备的合作品牌;不是报备的合作笔记时为 null。
fields.brand_idstring | null报备品牌的小红书账号编号;没有时为 null。
fields.impressionsinteger | null曝光数。
fields.viewsinteger | null阅读数。
fields.likesinteger | null点赞数。
fields.collectsinteger | null收藏数。
fields.commentsinteger | null评论数。
fields.sharesinteger | null分享数。
fields.followsinteger | null这篇笔记带来的涨粉数。
fields.component_clicks.comment_area"normal" | "high" | "very_high" | null评论区组件的点击率档位:normal(0–2%)、high(2–10%)、very_high(10% 以上);没挂时为 null。
fields.component_clicks.content"normal" | "high" | "very_high" | null正文组件的点击率档位;没挂时为 null。
fields.component_clicks.note_bottom"normal" | "high" | "very_high" | null笔记底部组件的点击率档位;没挂时为 null。

entry:xingtu_creator_keywords

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"xingtu_creator_keywords"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.keywordsarray | null高频词,每个词一项:keyword、mentions。

entry:xingtu_creator_scores

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"xingtu_creator_scores"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.overall.scorenumber | null星图指数(综合)得分,0 到 100。
fields.overall.averagenumber | null同类达人星图指数(综合)的平均分。
fields.overall.rankinteger | null星图指数(综合)的名次,1 为最高。
fields.overall.rank_sharenumber | null这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。
fields.reach.scorenumber | null传播指数得分,0 到 100。
fields.reach.averagenumber | null同类达人传播指数的平均分。
fields.reach.rankinteger | null传播指数的名次,1 为最高。
fields.reach.rank_sharenumber | null这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。
fields.seeding.scorenumber | null种草指数得分,0 到 100。
fields.seeding.averagenumber | null同类达人种草指数的平均分。
fields.seeding.rankinteger | null种草指数的名次,1 为最高。
fields.seeding.rank_sharenumber | null这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。
fields.conversion.scorenumber | null转化指数得分,0 到 100。
fields.conversion.averagenumber | null同类达人转化指数的平均分。
fields.conversion.rankinteger | null转化指数的名次,1 为最高。
fields.conversion.rank_sharenumber | null这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。
fields.cooperation.scorenumber | null合作指数得分,0 到 100。
fields.cooperation.averagenumber | null同类达人合作指数的平均分。
fields.cooperation.rankinteger | null合作指数的名次,1 为最高。
fields.cooperation.rank_sharenumber | null这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。
fields.value_for_money.scorenumber | null性价比指数得分,0 到 100。
fields.value_for_money.averagenumber | null同类达人性价比指数的平均分。
fields.value_for_money.rankinteger | null性价比指数的名次,1 为最高。
fields.value_for_money.rank_sharenumber | null这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。

entry:xingtu_creator_content_mix

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"xingtu_creator_content_mix"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.categoriesarray | null内容分类,每类一项:name、share、videos。

entry:xingtu_campaign

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"xingtu_campaign"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.descriptionstring | null活动介绍。
fields.category"platform_event" | "ecommerce" | "seasonal" | "creative" | "industry" | null活动类型:平台大事件、电商节点、情绪节点、创意营销或行业活动。
fields.stage"preparing" | "open" | "live" | "ended" | null活动进行到哪一步:筹备中、招商中、已上线或已结束。
fields.signup_starts_atstring | null招商开始时间。
fields.signup_ends_atstring | null招商结束时间。
fields.starts_atstring | null活动开始时间。
fields.ends_atstring | null活动结束时间。
fields.image_urlstring | null活动主图。

entry:ad

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"ad"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.format"video" | "image" | "carousel" | "text" | "other" | null广告形态:文字、图片或视频;other 是平台自有的其他形式。
fields.textstring | null广告文案。
fields.landing_urlstring | null点击广告后打开的地址。
fields.advertiser.idstring | null广告主编号。
fields.advertiser.namestring | null广告主名称。
fields.advertiser.urlstring | null广告主在平台上的主页。
fields.imagesstring[] | null图片素材的地址。
fields.first_shown_atstring | null广告首次展示的时间。
fields.last_shown_atstring | null广告最近一次展示的时间;还在投放的广告,是平台最近一次看到它的时间。

entry:advertiser

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"advertiser"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.regionstring | null广告主登记的国家或地区代码。

entry:channels_collection

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"channels_collection"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.descriptionstring | null合集的简介;没有时为 null。
fields.cover_urlstring | null合集封面图地址。
fields.updated_atstring | null合集最近一次更新的时间。
fields.videosinteger | null合集里的视频数。

entry:topic

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"topic"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.descriptionstring | null话题的简介;没有时为 null。
fields.viewsinteger | null话题的浏览数。
fields.postsinteger | null话题下的内容数。

entry:account_owner

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"account_owner"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.owner_type"company" | "government" | "media" | "individual" | "other" | null主体类型:company 企业、government 政府、media 媒体、individual 个人、other 其他组织。
fields.registration_idstring | null主体登记的证照号码,如统一社会信用代码;平台没给时为 null。
fields.countrystring | null主体所在的国家或地区,平台的原话。
fields.verification"verified" | "unverified" | "expired" | null账号的认证状态:verified 已认证,unverified 未认证,expired 认证过期。
fields.verification_typestring | null认证的种类,平台的原话;没认证时为 null。
fields.verified_atstring | null通过认证的日期。
fields.account_idstring | null你查的那个账号的编号。
fields.account_created_atstring | null账号的注册日期。

entry:miniprogram

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"miniprogram"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.app_idstring | nullAppID(wx 开头),打开或跳转小程序时用;平台没给时为 null。
fields.descriptionstring | null小程序简介。
fields.owner_namestring | null开发、运营它的公司或机构。
fields.owner_verifiedboolean | null主体是否通过认证。
fields.recent_usersinteger | null平台显示的最近使用人数;“1万+”这类是下限。
fields.is_gameboolean | null是否小游戏。

entry:follower_history

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"follower_history"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.daysinteger | null统计的是最近多少天。
fields.gainedinteger | null这段时间粉丝净增多少,掉粉时为负。
fields.growthnumber | null净增占开始时粉丝数的比例:0.01 是涨了 1%。
fields.pointsarray | null逐日的粉丝数,从早到晚:date、followers。

entry:channels_share_link

字段类型说明
platformstring这一条来自哪个平台。
idstring | null平台自己的编号。
refstring | null可以原样填回请求里、指向这一条的值。
approxarray这一条里哪些数字是约数或下限;都精确时为空。
extraobject平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。
type"entry"对象类型。
entry_type"channels_share_link"条目的种类。
titlestring | null条目的标题或名称。
urlstring | null能打开它的链接;平台的列表不带链接时为 null。
rankinteger | null榜上的名次,从 1 起。
heatinteger | null平台给的热度值。
fields.share_urlstring | null能在微信里打开这个视频的分享链接(也就是条目的 url):每次都给新的,旧的仍能打开。

版本和弃用规则

  • API 的版本写在地址(/v1)和每个回答(schema_version: "v1")里。
  • 同一个版本里,字段和错误代码只增加不改动:你的代码要忽略不认识的。已有的字段一直在,平台给不了的值是 null。
  • 已发布的 MCP 工具名和 op 名不会删除,也不会挪作他用。接口可能暂停:目录、接口页和回答都会写明,暂停时调用不扣费。
  • 会让现有调用出错的改动走新版本,旧版本停用之前先在更新日志 公告。

错误结构

整个请求失败时,返回的是这个结构而不是外层结构,HTTP 状态码按错误代码定。200 返回里某个结果失败时,带的是同样的 error 对象。

字段类型说明
request_idstring这次调用的编号,报告问题时带上它。
schema_version"v1"固定是 "v1"。
error.codestring错误代码,对应错误表里的一行。
error.messagestring出了什么问题,中英文各一句。
error.retryableboolean原样再发一次有没有可能成功。
error.reasonstring同一个代码有多种情况时,说明是哪一种。(可能不出现)
error.quote_creditsinteger被拒绝的这次请求本来要花多少积分。(可能不出现)
error.resets_atstring每日上限重新开始计的时间,ISO 8601(UTC)。(可能不出现)
error.retry_atstringfree_failure_limit 时给出:从什么时候起可以再发调用,ISO 8601(UTC)。(可能不出现)
error.retry_after_secondsinteger值得再试一次的 upstream_error 带它:等多少秒再发一次。(可能不出现)
error.whystringnot_found 在平台说了原因时带它:deleted(已删除)、self_only(仅作者可见)、partial(仅部分人可见)、withheld(平台不提供)、no_such(没有这个编号或链接)、closed(账号已注销)或 link_refused(微信打不开链接)。(可能不出现)
error.platform_saysstring平台自己对这件事的原话,原样给出(最多 200 个字)。(可能不出现)
error.charged"true"这次失败扣了费时为 true:查的内容不存在,而数据来源对这种查询照常收费。不出现就是没扣。(可能不出现)
error.alternative.opstring有备用线路的调用出现 upstream_error 时带它:备用调用的名字。(可能不出现)
error.alternative.creditsinteger备用调用的积分价。(可能不出现)
error.alternative.callobject同一个请求的备用调用,可以直接发;你不发就不会调用。(可能不出现)
error.alternative.notestring给 AI 看的一句话说明。(可能不出现)
error.fix.paramstring需要改的参数。(可能不出现)
error.fix.allowedarray这个参数允许的取值。(可能不出现)
error.fix.example_callobject一个可以照抄的正确调用,里面不会回显 Key。(可能不出现)
error.fix.mcp_call.toolstring要调的 MCP 工具。(可能不出现)
error.fix.mcp_call.argumentsobject它的参数。(可能不出现)
error.fix.action_urlstring去哪里处理:控制台、账单页或状态页。(可能不出现)
error.fix.notestring一句话说明该怎么做。(可能不出现)
billing.cost_creditsinteger固定为 0:整个请求失败时不扣费。(可能不出现)
billing.balance_creditsinteger你的余额;认得出 Key 时才有。(可能不出现)
billing.today_spend_creditsinteger今天(UTC)已经花掉的积分。(可能不出现)
billing.daily_limit_creditsinteger | null每日上限;没设时为 null。(可能不出现)
billing.daily_remaining_creditsinteger | null每日上限还剩多少;没设时为 null。(可能不出现)
billing.displaystring一句可以直接复述给你的话。(可能不出现)

错误 页列出了全部代码。

结果还没出来的时候

一次调用没法在请求里答完时,返回的是 HTTP 202 和一个句柄,而不是这个外层结构;之后凭句柄来读它。见结果与句柄。

最近更新: