跳到正文
磁力聚星达人搜索
raw.cljx.star_search

磁力聚星达人搜索

实时Beta:接口和返回字段仍可能调整不使用免费额度
GEThttps://api.qovia.ai/v1/raw/cljx/star_search

按昵称关键词、内容分类和排序条件搜索快手磁力聚星达人,返回粉丝、预期播放、预期 CPM、互动率、完播率和报价(元)。按页翻页,每页最多 50 条。

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

请求参数

作为查询参数发送

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

keywordstring

达人昵称关键词;不传则按分类和排序浏览

最多 50 字

示例美食

tag_idstring

内容一级分类 ID,如 673 美食、677 生活、695 搞笑

格式^[0-9]{3}$
sub_idsstring

二级分类 ID,英文逗号分隔,需同时传 tag_id

格式^[0-9]{3}(,[0-9]{3}){0,19}$
sort_byinteger · enum

排序字段:3 默认,2 粉丝数,20 预期播放,21 预期 CPM,22 互动率,23 完播率,24 涨粉量,25 涨粉率, 42 深度连接用户数,1 报价;直播达人另有 26 预期观看人数、27 最高在线人数

默认3可选值3 · 1 · 2 · 20 · 21 · 22 · 23 · 24 · 25 · 26 · 27 · 42
sort_orderinteger · enum

排序方向:1 升序,2 降序;sort_by 为 3(默认排序)时只能是 0,其他 sort_by 必须传 1 或 2

默认0可选值0 · 1 · 2
star_typeinteger · enum

1 短视频达人,4 直播达人

默认1可选值1 · 4
pageinteger

页码;响应里的 cursor 就是下一页的 page

默认1范围1–50
page_sizeinteger

每页条数

默认20范围1–50
  • 传 sub_ids 时必须同时传 tag_id
组合约束(JSON Schema)
{
  "allOf": [
    {
      "if": {
        "required": [
          "sort_by"
        ],
        "properties": {
          "sort_by": {
            "not": {
              "const": 3
            }
          }
        }
      },
      "then": {
        "required": [
          "sort_order"
        ],
        "properties": {
          "sort_order": {
            "enum": [
              1,
              2
            ]
          }
        }
      },
      "else": {
        "properties": {
          "sort_order": {
            "const": 0
          }
        }
      }
    }
  ]
}

响应

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

响应结构详解

错误码

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

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

全部错误码
在浏览器里直接调用

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