---
title: "返回格式 · 文档 · SocialToAI"
canonical: https://socialtoai.app/zh/docs/api/response/
updated: 2026-11-20
---

# 返回格式

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

- 页面：https://socialtoai.app/zh/docs/api/response/
- 最近更新：2026-11-20

## 外层结构

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `request_id` | string | 这次调用的编号，报告问题时带上它。 |
| `schema_version` | "v1" | 固定是 "v1"。 |
| `fetched_at` | string | 从平台取到数据的时间，ISO 8601（UTC）。 |
| `action` | string | 执行的动作。 |
| `op` | string | 执行的平台独有接口，只在 call 时出现。（可能不出现） |
| `platform` | string | 这份结果来自哪个平台。 |
| `target` | string | 这份结果对应哪个目标，照你写的原样给出；请求里给了多个目标时才有。（可能不出现） |
| `status` | "ok" \| "empty" \| "error" \| "not_supported" \| "timeout" \| "skipped" | ok、empty、error、not_supported、timeout 或 skipped。 |
| `reason` | string | 这份结果为什么被跳过；status 为 skipped 时才有。（可能不出现） |
| `unavailable` | string[] | 这个平台给不了的字段路径，这些字段在每一条里都是 null。 |
| `page.has_more` | boolean | 后面还有下一页时为 true。（可能不出现） |
| `page.cursor` | string | 原样填进 cursor 取下一页；最后一页没有它。（可能不出现） |
| `page.cursor_expires_at` | string | cursor 的失效时间，ISO 8601（UTC）。（可能不出现） |
| `warnings` | array | 不影响成功、但值得知道的提示。 |
| `applied_params` | object | 实际生效的参数。 |
| `includes` | object | 用 include 要的附加部分，按名字列出：各有自己的 status 和 cost_credits，取到的字段已经填进每一条。（可能不出现） |
| `cost_credits` | integer | 这份结果扣了多少积分；失败时为 0。 |
| `billing.cost_credits` | integer | 整个请求扣了多少积分。 |
| `billing.balance_credits` | integer | 扣完之后的余额。 |
| `billing.today_spend_credits` | integer | 今天（UTC）已经花掉的积分。 |
| `billing.daily_limit_credits` | integer \| null | 每日上限；没设时为 null。 |
| `billing.daily_remaining_credits` | integer \| null | 每日上限还剩多少；没设时为 null。 |
| `billing.display` | string | 一句可以直接复述给你的话。 |
| `replayed` | boolean | 同一个幂等键重放已有结果时为 true，本次不扣。 |
| `replayed_cost_credits` | integer | 第一次返回时扣了多少积分；replayed 为 true 时才有。（可能不出现） |
| `watch_hint` | string | 一行提示：可以让它每天自动跑，每小时最多一次。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` (帖子、视频、笔记或文章)

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "content" | 对象类型。 |
| `url` | string \| null | 能直接打开的链接。 |
| `format` | "video" \| "image" \| "text" \| "article" \| null | video、image、text 或 article。 |
| `title` | string \| null | 标题。 |
| `text` | string \| null | 正文或文案。 |
| `published_at` | string \| null | 发布时间，ISO 8601（UTC）。 |
| `author.id` | string \| null | 作者的账号编号。 |
| `author.username` | string \| null | 作者的账号名。 |
| `author.name` | string \| null | 作者的显示名。 |
| `author.verified` | boolean \| null | 作者是否认证。 |
| `author.followers` | integer \| null | 作者的粉丝数。 |
| `metrics.likes` | integer \| null | 点赞数。 |
| `metrics.comments` | integer \| null | 评论数。 |
| `metrics.shares` | integer \| null | 分享数。 |
| `metrics.collects` | integer \| null | 收藏数。 |
| `metrics.views` | integer \| null | 播放或阅读数。 |
| `metrics.reposts` | integer \| null | 转发数。 |
| `images` | string[] \| null | 图片地址。 |
| `hashtags` | string[] \| null | 话题标签，不带 #。 |
| `is_pinned` | boolean \| null | 是否被作者置顶。 |

### `account` (账号)

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "account" | 对象类型。 |
| `username` | string \| null | 账号名。 |
| `name` | string \| null | 显示名。 |
| `url` | string \| null | 主页链接。 |
| `bio` | string \| null | 简介。 |
| `verified` | boolean \| null | 是否认证。 |
| `followers` | integer \| null | 粉丝数。 |
| `following` | integer \| null | 关注数。 |
| `posts_count` | integer \| null | 发布的内容数。 |

### `comment` (评论)

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "comment" | 对象类型。 |
| `url` | string \| null | 评论的链接，平台有才给。 |
| `text` | string \| null | 评论原文。 |
| `published_at` | string \| null | 发布时间，ISO 8601（UTC）。 |
| `author.label` | string | 匿名标记，在同一次返回里保持一致；写的人不具名。 |
| `metrics.likes` | integer \| null | 点赞数。 |
| `reply_count` | integer \| null | 回复数。 |
| `content_id` | string \| null | 评论所在内容的编号。 |
| `parent_id` | string \| null | 它直接回复的那条评论；一级评论为 null。 |
| `root_id` | string \| null | 所在回复串的一级评论。 |

### `entry:trend`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "trend" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields` | object | 热榜条目没有额外字段。 |

### `entry:transcript`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "transcript" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.lang` | string \| null | 逐字稿的语言。 |
| `fields.text` | string \| null | 全文。 |
| `fields.segments` | array \| null | 带时间的分段：start、end、text。 |

### `entry:creator_rates`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "creator_rates" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.currency` | string \| null | 金额的币种。 |
| `fields.rates` | array \| null | 达人的报价：名称、金额、结算方式、是否开放。 |

### `entry:community`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "community" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.description` | string \| null | 社区简介。 |
| `fields.nsfw` | boolean \| null | 是否标为成人内容。 |
| `fields.created_at` | string \| null | 创建时间，ISO 8601（UTC）。 |
| `fields.members` | integer \| null | 成员数。 |

### `entry:product`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "product" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.description` | string \| null | 商品描述。 |
| `fields.price` | string \| null | 现价，十进制字符串，币种见 fields.currency。 |
| `fields.original_price` | string \| null | 折前价。 |
| `fields.currency` | string \| null | 价格的币种。 |
| `fields.images` | string[] \| null | 图片地址。 |
| `fields.rating` | number \| null | 评分。 |
| `fields.sold` | integer \| null | 销量。 |
| `fields.reviews_count` | integer \| null | 评价数。 |
| `fields.shop.id` | string \| null | 店铺编号。 |
| `fields.shop.name` | string \| null | 店铺名称。 |

### `entry:review`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "review" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.product_id` | string \| null | 评价所属的商品。 |
| `fields.text` | string \| null | 评价原文。 |
| `fields.rating` | number \| null | 给出的评分。 |
| `fields.published_at` | string \| null | 发布时间，ISO 8601（UTC）。 |
| `fields.author.label` | string | 匿名标记，在同一次返回里保持一致；写的人不具名。 |
| `fields.images` | string[] \| null | 图片地址。 |
| `fields.variant` | string \| null | 购买的规格。 |

### `entry:keyword_history`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "keyword_history" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.points` | array \| null | 逐日数据，每天一项，按日期从早到晚：date、search_index、composite_index、notes、impressions、views、engagements。 |

### `entry:keyword_related`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "keyword_related" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.related_to` | string \| null | 你查的那个关键词。 |
| `fields.relation` | "query" \| "posts" \| "prior" \| "after" \| "suggestion" \| null | 关联方式：query 是和你查的词一起被搜，posts 是在内容里一起出现，prior 是人们搜它之前搜的词，after 是之后搜的词，suggestion 是在搜索框里输入你查的词时平台给的联想词。 |
| `fields.relevance` | number \| null | 和你查的词的相关度，0 到 1。 |
| `fields.search_index` | integer \| null | 这个关联词的搜索指数：平台算出的指数，不是搜索次数；平台没给这个词的数值时为 null。 |
| `fields.composite_index` | integer \| null | 这个关联词的综合指数：平台按相关内容的热度算出的指数，不是次数。 |

### `entry:keyword_audience`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "keyword_audience" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.age` | array \| null | 按年龄段分：label、share、tgi。tgi 表示这个人群的偏好程度，100 为平均水平。 |
| `fields.gender` | array \| null | 按性别分：label、share、tgi。 |
| `fields.province` | array \| null | 按省份分：label、share、tgi。 |
| `fields.city` | array \| null | 按城市分，只列占比最高的一批，各项加起来不到 1：label、share、tgi。 |
| `fields.city_tier` | array \| null | 按城市等级分：label、share、tgi。 |
| `fields.interest` | array \| null | 按兴趣分。一个人可以有多个兴趣，各项加起来不等于 1：label、share、tgi。 |

### `entry:brand_history`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "brand_history" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.category` | string \| null | 平台给这个品牌归的行业，用平台的原话。 |
| `fields.points` | array \| null | 逐日指数，每天一项，按日期从早到晚：date、search_index、content_index、spread_index。 |

### `entry:brand_metrics`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "brand_metrics" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.category` | string \| null | 平台给这个品牌归的行业，用平台的原话。 |
| `fields.search_index` | integer \| null | 这段时间搜索指数的日均值。 |
| `fields.content_index` | integer \| null | 这段时间内容指数的日均值。 |
| `fields.spread_index` | integer \| null | 这段时间传播指数的日均值。 |
| `fields.benchmarks` | array \| null | 同行业的参照值：行业全部品牌的均值，和头部品牌的均值。每项有 scope、search_index、content_index、spread_index。 |

### `entry:account_history`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "account_history" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.days` | integer \| null | 统计的是最近多少天。 |
| `fields.gained.followers` | integer \| null | 净增粉丝数，掉粉时为负。 |
| `fields.gained.likes` | integer \| null | 新增点赞数。 |
| `fields.gained.comments` | integer \| null | 新增评论数。 |
| `fields.gained.shares` | integer \| null | 新增分享数。 |
| `fields.gained.posts` | integer \| null | 新发布的内容数。 |
| `fields.change.followers` | number \| null | 净增粉丝数相比上一个周期的变化比例。 |
| `fields.change.likes` | number \| null | 新增点赞数相比上一个周期的变化比例。 |
| `fields.change.comments` | number \| null | 新增评论数相比上一个周期的变化比例。 |
| `fields.change.shares` | number \| null | 新增分享数相比上一个周期的变化比例。 |
| `fields.change.posts` | number \| null | 新发布的内容数相比上一个周期的变化比例。 |
| `fields.totals.followers` | integer \| null | 现在的粉丝数。 |
| `fields.totals.likes` | integer \| null | 累计获赞数。 |
| `fields.totals.posts` | integer \| null | 累计作品数。 |

### `entry:index_creator_metrics`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "index_creator_metrics" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.average_7d.likes` | number \| null | 最近一周平均每天新增的点赞数。 |
| `fields.average_7d.follows` | number \| null | 最近一周平均每天的涨粉数，平台的口径：不是粉丝净增，比按粉丝增减算出来的大，掉粉的账号也是正数。 |
| `fields.average_7d.shares` | number \| null | 最近一周平均每天新增的分享数。 |
| `fields.average_7d.comments` | number \| null | 最近一周平均每天新增的评论数。 |
| `fields.average_30d.likes` | number \| null | 最近一个月平均每天新增的点赞数。 |
| `fields.average_30d.follows` | number \| null | 最近一个月平均每天的涨粉数，平台的口径（不是粉丝净增）。 |
| `fields.average_30d.shares` | number \| null | 最近一个月平均每天新增的分享数。 |
| `fields.average_30d.comments` | number \| null | 最近一个月平均每天新增的评论数。 |
| `fields.change_7d.likes` | number \| null | 最近一周日均新增点赞数相比上一周的变化比例。 |
| `fields.change_7d.follows` | number \| null | 最近一周日均涨粉数（平台的口径）相比上一周的变化比例。 |
| `fields.change_7d.shares` | number \| null | 最近一周日均新增分享数相比上一周的变化比例。 |
| `fields.change_7d.comments` | number \| null | 最近一周日均新增评论数相比上一周的变化比例。 |
| `fields.change_30d.likes` | number \| null | 最近一个月日均新增点赞数相比上一个月的变化比例。 |
| `fields.change_30d.follows` | number \| null | 最近一个月日均涨粉数（平台的口径）相比上一个月的变化比例。 |
| `fields.change_30d.shares` | number \| null | 最近一个月日均新增分享数相比上一个月的变化比例。 |
| `fields.change_30d.comments` | number \| null | 最近一个月日均新增评论数相比上一个月的变化比例。 |

### `entry:creator`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "creator" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.account_id` | string \| null | 这位达人的平台账号编号，可以传给同平台的账号类调用。 |
| `fields.username` | string \| null | 账号名。 |
| `fields.location` | string \| null | 所在地，用平台的原话。 |
| `fields.categories` | string[] \| null | 内容类目（一级），用平台的原话。 |
| `fields.subcategories` | string[] \| null | 内容类目（二级），用平台的原话。 |
| `fields.followers` | integer \| null | 粉丝数。 |

### `entry:audience`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "audience" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.measured_at` | string \| null | 画像数据对应的日期，以北京时间当天零点表示。 |
| `fields.gender` | array \| null | 按性别分：name、share、count。 |
| `fields.age` | array \| null | 按年龄段分：name、share、count。 |
| `fields.province` | array \| null | 按省份分：name、share、count。 |
| `fields.city` | array \| null | 按城市分，只列粉丝最多的几个：name、share、count。 |
| `fields.interest` | array \| null | 按兴趣分：name、share、count。 |
| `fields.device` | array \| null | 按手机品牌分：name、share、count。 |
| `fields.city_tier` | array \| null | 按城市等级分：name、share、count。 |
| `fields.crowd` | array \| null | 按平台划分的消费人群分：name、share、count。 |
| `fields.purchase_category` | array \| null | 按购买的品类分：name、share、count。 |
| `fields.purchase_amount` | array \| null | 按每单消费金额分：name、share、count。 |

### `entry:xingtu_creator_metrics`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "xingtu_creator_metrics" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.videos` | integer \| null | 统计周期内的视频数。 |
| `fields.median_views` | integer \| null | 单条视频播放数的中位数。 |
| `fields.average_likes` | integer \| null | 单条视频的平均点赞数。 |
| `fields.average_comments` | integer \| null | 单条视频的平均评论数。 |
| `fields.average_shares` | integer \| null | 单条视频的平均分享数。 |
| `fields.engagement_rate` | number \| null | 互动率，0 到 1。 |
| `fields.engagement_rate_percentile` | number \| null | 互动率超过同类达人的比例，0 到 1。 |
| `fields.completion_rate` | number \| null | 完播率，0 到 1。只算作者是星图达人、大约 2023 年以后发布的视频，0 也可能是没有数据。 |
| `fields.completion_rate_percentile` | number \| null | 完播率超过同类达人的比例，0 到 1。 |
| `fields.currency` | string \| null | 下面四项成本的货币。 |
| `fields.cpm_integrated` | string \| null | 植入视频的预期千次播放成本。 |
| `fields.cpm_custom` | string \| null | 定制视频的预期千次播放成本。 |
| `fields.cpe_integrated` | string \| null | 植入视频的预期单次互动成本。 |
| `fields.cpe_custom` | string \| null | 定制视频的预期单次互动成本。 |

### `entry:xingtu_creator_post`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "xingtu_creator_post" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.published_at` | string \| null | 发布时间。 |
| `fields.duration` | number \| null | 视频时长，秒。 |
| `fields.views` | integer \| null | 播放数。 |
| `fields.likes` | integer \| null | 点赞数。 |
| `fields.comments` | integer \| null | 评论数。 |
| `fields.completion_rate` | number \| null | 完播率，0 到 1。 |
| `fields.engagement_rate` | number \| null | 互动率，0 到 1。 |

### `entry:pgy_creator_metrics`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "pgy_creator_metrics" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.notes` | integer \| null | 统计周期内的笔记数。 |
| `fields.median_impressions` | integer \| null | 单篇笔记曝光数的中位数。 |
| `fields.median_reads` | integer \| null | 单篇笔记阅读数的中位数。 |
| `fields.median_engagements` | integer \| null | 单篇笔记互动数的中位数。 |
| `fields.median_likes` | integer \| null | 单篇笔记点赞数的中位数。 |
| `fields.median_collects` | integer \| null | 单篇笔记收藏数的中位数。 |
| `fields.median_comments` | integer \| null | 单篇笔记评论数的中位数。 |
| `fields.median_shares` | integer \| null | 单篇笔记分享数的中位数。 |
| `fields.engagement_rate` | number \| null | 互动率，0 到 1。 |
| `fields.video_completion_rate` | number \| null | 视频笔记的完播率，0 到 1。 |
| `fields.image_3s_read_rate` | number \| null | 图文笔记的 3 秒阅读率，0 到 1。 |
| `fields.hundred_like_share` | number \| null | 点赞过百的笔记占比，0 到 1。 |
| `fields.thousand_like_share` | number \| null | 点赞过千的笔记占比，0 到 1。 |
| `fields.impressions_percentile` | number \| null | 曝光中位数超过同类博主的比例，0 到 1。 |
| `fields.reads_percentile` | number \| null | 阅读中位数超过同类博主的比例，0 到 1。 |
| `fields.engagements_percentile` | number \| null | 互动中位数超过同类博主的比例，0 到 1。 |

### `entry:pgy_creator_post`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "pgy_creator_post" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.format` | "image" \| "video" \| null | image 是图文笔记，video 是视频笔记。 |
| `fields.published_at` | string \| null | 发布日期。平台只给到日，以北京时间当天零点表示。 |
| `fields.cover_url` | string \| null | 封面图地址。 |
| `fields.is_sponsored` | boolean \| null | 是否商业合作笔记：有合作品牌（brand）的就是。 |
| `fields.is_promoted` | boolean \| null | 这篇笔记是否带过付费推广流量，和是不是合作笔记无关。 |
| `fields.brand` | string \| null | 合作的品牌，用平台的原话；不是合作笔记时为 null。 |
| `fields.views` | integer \| null | 阅读数。 |
| `fields.likes` | integer \| null | 点赞数。 |
| `fields.collects` | integer \| null | 收藏数。 |

### `entry:pgy_creator_costs`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "pgy_creator_costs" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.date` | string \| null | 数据算到哪一天：北京时间的一个自然日，写成这个日期的 UTC 零点。 |
| `fields.currency` | string \| null | 各项花费的货币。 |
| `fields.image_cpm` | string \| null | 图文笔记的预估 CPM；蒲公英没有估出来时为 null。 |
| `fields.image_cpm_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.video_cpm` | string \| null | 视频笔记的预估 CPM；蒲公英没有估出来时为 null。 |
| `fields.video_cpm_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.image_cpe` | string \| null | 图文笔记的预估互动单价；蒲公英没有估出来时为 null。 |
| `fields.image_cpe_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.video_cpe` | string \| null | 视频笔记的预估互动单价；蒲公英没有估出来时为 null。 |
| `fields.video_cpe_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.image_read_cost` | string \| null | 图文笔记的预估阅读单价；蒲公英没有估出来时为 null。 |
| `fields.image_read_cost_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.video_read_cost` | string \| null | 视频笔记的预估阅读单价；蒲公英没有估出来时为 null。 |
| `fields.video_read_cost_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.image_shop_visit_cost` | string \| null | 图文笔记的预估外溢进店单价；蒲公英没有估出来时为 null。 |
| `fields.image_shop_visit_cost_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.video_shop_visit_cost` | string \| null | 视频笔记的预估外溢进店单价；蒲公英没有估出来时为 null。 |
| `fields.video_shop_visit_cost_percentile` | number \| null | 低于多少同类博主（蒲公英的“优于同行”），0 到 1。 |
| `fields.median_impressions` | integer \| null | 单篇笔记曝光数的中位数。 |
| `fields.median_impressions_percentile` | number \| null | 超过了多少同类博主，0 到 1。 |
| `fields.median_reads` | integer \| null | 单篇笔记阅读数的中位数。 |
| `fields.median_reads_percentile` | number \| null | 超过了多少同类博主，0 到 1。 |
| `fields.median_engagements` | integer \| null | 单篇笔记互动数的中位数。 |
| `fields.median_engagements_percentile` | number \| null | 超过了多少同类博主，0 到 1。 |
| `fields.median_shop_visits` | integer \| null | 单篇笔记带来的外溢进店人数的中位数。 |
| `fields.median_shop_visits_percentile` | number \| null | 超过了多少同类博主，0 到 1。 |
| `fields.follower_growth` | number \| null | 近 30 天粉丝增长率：0.037 是涨了 3.7%，掉粉时为负。 |
| `fields.follower_growth_percentile` | number \| null | 超过了多少同类博主，0 到 1。 |
| `fields.invite_reply_rate` | number \| null | 合作邀约在 48 小时内回复的比例，0 到 1。 |
| `fields.easy_to_reach` | boolean \| null | 蒲公英是否标了“好联系”。 |
| `fields.active_days_7d` | integer \| null | 近 7 天里活跃的天数。 |
| `fields.is_active` | boolean \| null | 蒲公英是否标了“活跃”。 |
| `fields.notes_30d` | integer \| null | 近 30 天发布的笔记数，日常和合作笔记都算。 |
| `fields.highlight` | string \| null | 蒲公英标的优势，平台的原话；没有时为 null。 |
| `fields.highlight_reason` | string \| null | 这个优势的说明，平台的原话。 |
| `fields.content_mix` | array \| null | 内容类型占比，占比高的在前：category、share。 |
| `fields.industries` | string[] \| null | 合作过的行业，平台的原话。 |

### `entry:pgy_creator_followers`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "pgy_creator_followers" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.followers` | integer \| null | 粉丝数。 |
| `fields.gained` | integer \| null | 近 30 天粉丝净增，掉粉时为负。 |
| `fields.growth` | number \| null | 近 30 天粉丝增长率：0.008 是涨了 0.8%。 |
| `fields.growth_percentile` | number \| null | 超过了多少同类博主，0 到 1。 |
| `fields.active_followers` | integer \| null | 近 28 天在小红书上活跃过的粉丝数。 |
| `fields.active_share` | number \| null | 占全部粉丝的比例，0 到 1。 |
| `fields.active_percentile` | number \| null | 这个占比超过了多少同类博主，0 到 1。 |
| `fields.engaged_followers` | integer \| null | 近 30 天和博主笔记有过互动的粉丝数。 |
| `fields.engaged_share` | number \| null | 占全部粉丝的比例，0 到 1。 |
| `fields.engaged_percentile` | number \| null | 这个占比超过了多少同类博主，0 到 1。 |
| `fields.reading_followers` | integer \| null | 近 30 天读过博主笔记的粉丝数。 |
| `fields.reading_share` | number \| null | 占全部粉丝的比例，0 到 1。 |
| `fields.reading_percentile` | number \| null | 这个占比超过了多少同类博主，0 到 1。 |
| `fields.buying_followers` | integer \| null | 近 30 天在小红书上买过东西的粉丝数。 |
| `fields.buying_share` | number \| null | 占全部粉丝的比例，0 到 1。 |

### `entry:pgy_creator_cost_history`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "pgy_creator_cost_history" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.days` | integer \| null | 统计的是最近多少天。 |
| `fields.currency` | string \| null | 各项花费的货币。 |
| `fields.date` | string \| null | 整段的数算到哪一天，写成这个日期（北京时间）的 UTC 零点。 |
| `fields.cpm` | string \| null | CPM：每千次曝光的花费；没有时为 null。 |
| `fields.cpe` | string \| null | CPE：每次互动的花费；没有时为 null。 |
| `fields.cpv` | string \| null | CPV：每次阅读的花费；没有时为 null。 |
| `fields.shop_visit_cost` | string \| null | 外溢进店单价；没有时为 null。 |
| `fields.median_impressions` | integer \| null | 单篇笔记曝光数的中位数。 |
| `fields.median_reads` | integer \| null | 单篇笔记阅读数的中位数。 |
| `fields.median_engagements` | integer \| null | 单篇笔记互动数的中位数。 |
| `fields.median_shop_visits` | integer \| null | 单篇笔记带来的外溢进店人数的中位数。 |
| `fields.points` | array \| null | 逐日的同样这些数，从早到晚：date、cpm、cpe、cpv、shop_visit_cost 和四个中位数。 |

### `entry:pgy_note`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "pgy_note" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.format` | "image" \| "video" \| null | image 是图文笔记，video 是视频笔记。 |
| `fields.text` | string \| null | 笔记正文。 |
| `fields.published_at` | string \| null | 发布时间。 |
| `fields.images` | string[] \| null | 图片地址，按笔记里的顺序。 |
| `fields.creator_id` | string \| null | 博主的蒲公英博主编号，其他蒲公英博主接口可直接用。 |
| `fields.creator_name` | string \| null | 博主昵称。 |
| `fields.brand` | string \| null | 报备的合作品牌；不是报备的合作笔记时为 null。 |
| `fields.brand_id` | string \| null | 报备品牌的小红书账号编号；没有时为 null。 |
| `fields.impressions` | integer \| null | 曝光数。 |
| `fields.views` | integer \| null | 阅读数。 |
| `fields.likes` | integer \| null | 点赞数。 |
| `fields.collects` | integer \| null | 收藏数。 |
| `fields.comments` | integer \| null | 评论数。 |
| `fields.shares` | integer \| null | 分享数。 |
| `fields.follows` | integer \| 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`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "xingtu_creator_keywords" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.keywords` | array \| null | 高频词，每个词一项：keyword、mentions。 |

### `entry:xingtu_creator_scores`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "xingtu_creator_scores" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.overall.score` | number \| null | 星图指数（综合）得分，0 到 100。 |
| `fields.overall.average` | number \| null | 同类达人星图指数（综合）的平均分。 |
| `fields.overall.rank` | integer \| null | 星图指数（综合）的名次，1 为最高。 |
| `fields.overall.rank_share` | number \| null | 这个名次处在前百分之多少，0 到 1：0.05 表示前 5%。 |
| `fields.reach.score` | number \| null | 传播指数得分，0 到 100。 |
| `fields.reach.average` | number \| null | 同类达人传播指数的平均分。 |
| `fields.reach.rank` | integer \| null | 传播指数的名次，1 为最高。 |
| `fields.reach.rank_share` | number \| null | 这个名次处在前百分之多少，0 到 1：0.05 表示前 5%。 |
| `fields.seeding.score` | number \| null | 种草指数得分，0 到 100。 |
| `fields.seeding.average` | number \| null | 同类达人种草指数的平均分。 |
| `fields.seeding.rank` | integer \| null | 种草指数的名次，1 为最高。 |
| `fields.seeding.rank_share` | number \| null | 这个名次处在前百分之多少，0 到 1：0.05 表示前 5%。 |
| `fields.conversion.score` | number \| null | 转化指数得分，0 到 100。 |
| `fields.conversion.average` | number \| null | 同类达人转化指数的平均分。 |
| `fields.conversion.rank` | integer \| null | 转化指数的名次，1 为最高。 |
| `fields.conversion.rank_share` | number \| null | 这个名次处在前百分之多少，0 到 1：0.05 表示前 5%。 |
| `fields.cooperation.score` | number \| null | 合作指数得分，0 到 100。 |
| `fields.cooperation.average` | number \| null | 同类达人合作指数的平均分。 |
| `fields.cooperation.rank` | integer \| null | 合作指数的名次，1 为最高。 |
| `fields.cooperation.rank_share` | number \| null | 这个名次处在前百分之多少，0 到 1：0.05 表示前 5%。 |
| `fields.value_for_money.score` | number \| null | 性价比指数得分，0 到 100。 |
| `fields.value_for_money.average` | number \| null | 同类达人性价比指数的平均分。 |
| `fields.value_for_money.rank` | integer \| null | 性价比指数的名次，1 为最高。 |
| `fields.value_for_money.rank_share` | number \| null | 这个名次处在前百分之多少，0 到 1：0.05 表示前 5%。 |

### `entry:xingtu_creator_content_mix`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "xingtu_creator_content_mix" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.categories` | array \| null | 内容分类，每类一项：name、share、videos。 |

### `entry:xingtu_campaign`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "xingtu_campaign" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.description` | string \| null | 活动介绍。 |
| `fields.category` | "platform_event" \| "ecommerce" \| "seasonal" \| "creative" \| "industry" \| null | 活动类型：平台大事件、电商节点、情绪节点、创意营销或行业活动。 |
| `fields.stage` | "preparing" \| "open" \| "live" \| "ended" \| null | 活动进行到哪一步：筹备中、招商中、已上线或已结束。 |
| `fields.signup_starts_at` | string \| null | 招商开始时间。 |
| `fields.signup_ends_at` | string \| null | 招商结束时间。 |
| `fields.starts_at` | string \| null | 活动开始时间。 |
| `fields.ends_at` | string \| null | 活动结束时间。 |
| `fields.image_url` | string \| null | 活动主图。 |

### `entry:ad`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "ad" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.format` | "video" \| "image" \| "carousel" \| "text" \| "other" \| null | 广告形态：文字、图片或视频；other 是平台自有的其他形式。 |
| `fields.text` | string \| null | 广告文案。 |
| `fields.landing_url` | string \| null | 点击广告后打开的地址。 |
| `fields.advertiser.id` | string \| null | 广告主编号。 |
| `fields.advertiser.name` | string \| null | 广告主名称。 |
| `fields.advertiser.url` | string \| null | 广告主在平台上的主页。 |
| `fields.images` | string[] \| null | 图片素材的地址。 |
| `fields.first_shown_at` | string \| null | 广告首次展示的时间。 |
| `fields.last_shown_at` | string \| null | 广告最近一次展示的时间；还在投放的广告，是平台最近一次看到它的时间。 |

### `entry:advertiser`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "advertiser" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.region` | string \| null | 广告主登记的国家或地区代码。 |

### `entry:channels_collection`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "channels_collection" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.description` | string \| null | 合集的简介；没有时为 null。 |
| `fields.cover_url` | string \| null | 合集封面图地址。 |
| `fields.updated_at` | string \| null | 合集最近一次更新的时间。 |
| `fields.videos` | integer \| null | 合集里的视频数。 |

### `entry:topic`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "topic" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.description` | string \| null | 话题的简介；没有时为 null。 |
| `fields.views` | integer \| null | 话题的浏览数。 |
| `fields.posts` | integer \| null | 话题下的内容数。 |

### `entry:account_owner`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "account_owner" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.owner_type` | "company" \| "government" \| "media" \| "individual" \| "other" \| null | 主体类型：company 企业、government 政府、media 媒体、individual 个人、other 其他组织。 |
| `fields.registration_id` | string \| null | 主体登记的证照号码，如统一社会信用代码；平台没给时为 null。 |
| `fields.country` | string \| null | 主体所在的国家或地区，平台的原话。 |
| `fields.verification` | "verified" \| "unverified" \| "expired" \| null | 账号的认证状态：verified 已认证，unverified 未认证，expired 认证过期。 |
| `fields.verification_type` | string \| null | 认证的种类，平台的原话；没认证时为 null。 |
| `fields.verified_at` | string \| null | 通过认证的日期。 |
| `fields.account_id` | string \| null | 你查的那个账号的编号。 |
| `fields.account_created_at` | string \| null | 账号的注册日期。 |

### `entry:miniprogram`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "miniprogram" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.app_id` | string \| null | AppID（wx 开头），打开或跳转小程序时用；平台没给时为 null。 |
| `fields.description` | string \| null | 小程序简介。 |
| `fields.owner_name` | string \| null | 开发、运营它的公司或机构。 |
| `fields.owner_verified` | boolean \| null | 主体是否通过认证。 |
| `fields.recent_users` | integer \| null | 平台显示的最近使用人数；“1万+”这类是下限。 |
| `fields.is_game` | boolean \| null | 是否小游戏。 |

### `entry:follower_history`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "follower_history" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.days` | integer \| null | 统计的是最近多少天。 |
| `fields.gained` | integer \| null | 这段时间粉丝净增多少，掉粉时为负。 |
| `fields.growth` | number \| null | 净增占开始时粉丝数的比例：0.01 是涨了 1%。 |
| `fields.points` | array \| null | 逐日的粉丝数，从早到晚：date、followers。 |

### `entry:channels_share_link`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `platform` | string | 这一条来自哪个平台。 |
| `id` | string \| null | 平台自己的编号。 |
| `ref` | string \| null | 可以原样填回请求里、指向这一条的值。 |
| `approx` | array | 这一条里哪些数字是约数或下限；都精确时为空。 |
| `extra` | object | 平台在下面这些字段之外给的内容，用平台自己的字段名（IP 属地、uid、有没有橱窗等），每个是什么见接口的 extra_fields；没有就是空对象。评论和评价里不会有写的人是谁。 |
| `type` | "entry" | 对象类型。 |
| `entry_type` | "channels_share_link" | 条目的种类。 |
| `title` | string \| null | 条目的标题或名称。 |
| `url` | string \| null | 能打开它的链接；平台的列表不带链接时为 null。 |
| `rank` | integer \| null | 榜上的名次，从 1 起。 |
| `heat` | integer \| null | 平台给的热度值。 |
| `fields.share_url` | string \| null | 能在微信里打开这个视频的分享链接（也就是条目的 url）：每次都给新的，旧的仍能打开。 |

## 版本和弃用规则

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

## 错误结构

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

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `request_id` | string | 这次调用的编号，报告问题时带上它。 |
| `schema_version` | "v1" | 固定是 "v1"。 |
| `error.code` | string | 错误代码，对应错误表里的一行。 |
| `error.message` | string | 出了什么问题，中英文各一句。 |
| `error.retryable` | boolean | 原样再发一次有没有可能成功。 |
| `error.reason` | string | 同一个代码有多种情况时，说明是哪一种。（可能不出现） |
| `error.quote_credits` | integer | 被拒绝的这次请求本来要花多少积分。（可能不出现） |
| `error.resets_at` | string | 每日上限重新开始计的时间，ISO 8601（UTC）。（可能不出现） |
| `error.retry_at` | string | free_failure_limit 时给出：从什么时候起可以再发调用，ISO 8601（UTC）。（可能不出现） |
| `error.retry_after_seconds` | integer | 值得再试一次的 upstream_error 带它：等多少秒再发一次。（可能不出现） |
| `error.why` | string | not_found 在平台说了原因时带它：deleted（已删除）、self_only（仅作者可见）、partial（仅部分人可见）、withheld（平台不提供）、no_such（没有这个编号或链接）、closed（账号已注销）或 link_refused（微信打不开链接）。（可能不出现） |
| `error.platform_says` | string | 平台自己对这件事的原话，原样给出（最多 200 个字）。（可能不出现） |
| `error.charged` | "true" | 这次失败扣了费时为 true：查的内容不存在，而数据来源对这种查询照常收费。不出现就是没扣。（可能不出现） |
| `error.alternative.op` | string | 有备用线路的调用出现 upstream_error 时带它：备用调用的名字。（可能不出现） |
| `error.alternative.credits` | integer | 备用调用的积分价。（可能不出现） |
| `error.alternative.call` | object | 同一个请求的备用调用，可以直接发；你不发就不会调用。（可能不出现） |
| `error.alternative.note` | string | 给 AI 看的一句话说明。（可能不出现） |
| `error.fix.param` | string | 需要改的参数。（可能不出现） |
| `error.fix.allowed` | array | 这个参数允许的取值。（可能不出现） |
| `error.fix.example_call` | object | 一个可以照抄的正确调用，里面不会回显 Key。（可能不出现） |
| `error.fix.mcp_call.tool` | string | 要调的 MCP 工具。（可能不出现） |
| `error.fix.mcp_call.arguments` | object | 它的参数。（可能不出现） |
| `error.fix.action_url` | string | 去哪里处理：控制台、账单页或状态页。（可能不出现） |
| `error.fix.note` | string | 一句话说明该怎么做。（可能不出现） |
| `billing.cost_credits` | integer | 固定为 0：整个请求失败时不扣费。（可能不出现） |
| `billing.balance_credits` | integer | 你的余额；认得出 Key 时才有。（可能不出现） |
| `billing.today_spend_credits` | integer | 今天（UTC）已经花掉的积分。（可能不出现） |
| `billing.daily_limit_credits` | integer \| null | 每日上限；没设时为 null。（可能不出现） |
| `billing.daily_remaining_credits` | integer \| null | 每日上限还剩多少；没设时为 null。（可能不出现） |
| `billing.display` | string | 一句可以直接复述给你的话。（可能不出现） |

[错误](https://socialtoai.app/zh/docs/api/errors.md) 页列出了全部代码。

## 结果还没出来的时候

一次调用没法在请求里答完时，返回的是 HTTP 202 和一个句柄，而不是这个外层结构；之后凭句柄来读它。见[结果与句柄](https://socialtoai.app/zh/docs/api/results.md)。
