raw.xiaohongshu.kol_overview

小红书博主数据概览（蒲公英）

实时Beta不使用免费额度

GEThttps://api.qovia.ai/v1/raw/xiaohongshu/kol_overview

蒲公英达人数据概览：阅读/互动中位数及超过同类博主的百分比、近 7 天活跃、邀约响应率、粉丝 30 天增长、累计曝光与阅读，以及蒲公英预估的 CPM / CPUV / CPE（元）。*_pct 为 0–100 的百分数。无数据时返回空，不收费。

价格: $0.01 / 次$10 / 千次 · 固定价格
计费: 成功且有结果才扣费不使用免费额度
权限: raw:xiaohongshuAPI Key 需要这个 scope
限速: 全局 3 次/秒所有用户合计，另有账户每分钟上限

请求参数

作为查询参数发送

只接受下列参数，多出的参数会返回 400。

user_idstring必填

博主用户 ID（24 位十六进制）

格式^[0-9a-f]{24}$

示例5f4efa82000000000100717e

businessinteger · enum

笔记范围：0 日常笔记，1 合作笔记

默认0可选值0 · 1

curl 'https://api.qovia.ai/v1/raw/xiaohongshu/kol_overview?user_id=5f4efa82000000000100717e' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "user_id": "5f4efa82000000000100717e",
    "filters": {
      "business": 0
    },
    "as_of": "2026-10-19",
    "notes": 1,
    "content_mix": [
      {
        "tag": "家居家装",
        "pct": 100
      }
    ],
    "trade_names": [],
    "read_median": 63054,
    "read_median_beyond_pct": 99.3,
    "interaction_median": 10667,
    "interaction_beyond_pct": 99.8,
    "picture_read_beyond_pct": 98,
    "video_read_beyond_pct": 64.9,
    "picture_read_cost": 0.32,
    "video_read_cost": 1.55,
    "fans_30d_growth_pct": 0.7,
    "fans_30d_growth_beyond_pct": 78.9,
    "active_days_last_7": 7,
    "is_active": true,
    "response_rate_pct": 41.2,
    "invites": 34,
    "easy_connect": false,
    "advantage": "品效型博主",
    "advantage_hint": "外溢指标处于前20%水位",
    "picture_cases": 2,
    "video_cases": 0,
    "impressions": 244603,
    "reads": 63054,
    "engagements": 11627,
    "estimates": {
      "picture_cpm": 0,
      "picture_cpuv": 0,
      "picture_cpe": 0,
      "video_cpm": 12.26,
      "video_cpuv": 0,
      "video_cpe": 0.13
    },
    "prov": {
      "hash": "0xc26246ba63117ade",
      "ts": "2026-10-20T12:00:00+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.010000",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.990000",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。
`invalid_params`	400	不扣费	参数没有通过校验：缺少必填、类型或格式不对、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（`item_id: …`），缺少必填或多出参数以 `params: …` 开头。
`rate_limited`可重试	429	不扣费	超过账户每分钟请求上限（滑动 60 秒窗口），按 `Retry-After` 等待。
`too_many_unbilled`可重试	429	不扣费	最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。
`endpoint_busy`可重试	429	不扣费	这个接口所有用户合计的每秒请求已满，1 秒后重试；不占你的每分钟额度。
`insufficient_balance`	402	不扣费	余额不足以支付这次调用（免费额度已用完，或接口不使用免费额度）。
`upstream_busy`可重试	503	已退款	数据源繁忙或在冷却，已退款，按 `Retry-After` 重试。
`upstream_timeout`	504	已退款	数据源超时，已退款。
`upstream_error`	502 / 503	已退款	数据源返回失败，已退款。
`upstream_rejected`	400	已退款	数据源拒绝了这组参数（格式合法但不被接受），已退款。
`not_found`	404	已退款	数据源里没有这条数据（已删除或 ID 不存在），已退款。
`reservation_expired`	504	已退款	处理时间过长，已自动退款，没有返回数据。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码

在浏览器里直接调用

需要登录；调试台调用和 API 调用一样计费。

在调试台试用创建 API Key