raw.cljx.hot_stars磁力聚星达人热榜
实时Beta：接口和返回字段仍可能调整不使用免费额度
GET
https://api.qovia.ai/v1/raw/cljx/hot_stars磁力聚星官方达人热榜（传播力、涨粉黑马、性价比、头部必选；直播带货实力、人气主播），按榜单顺序返回达人、排名变化、各项指数和报价。每次返回整张榜单，不分页。
- 价格
- $0.0015 / 次$1.5 / 千次 · 固定价格
- 计费
- 成功且有结果才扣费不使用免费额度
- 权限
raw:cljxAPI Key 需要这个 scope- 限速
- 全局 1 次/秒所有用户合计，另有账户每分钟上限
请求参数
作为查询参数发送
只接受下列参数，多出的参数会返回 400。
board榜单：105 传播力表现榜，104 涨粉黑马榜，5 性价比表现榜，106 头部必选榜（短视频达人）； 7 带货实力榜，8 人气主播榜（直播达人，需 star_type=4）
默认105可选值105 · 104 · 5 · 106 · 7 · 8star_type1 短视频达人，4 直播达人（榜单 7、8）
默认1可选值1 · 4tag_id内容一级分类 ID，如 670 美妆；不传为全部
范围1–9999
组合约束（JSON Schema）
{
"allOf": [
{
"if": {
"required": [
"board"
],
"properties": {
"board": {
"enum": [
7,
8
]
}
}
},
"then": {
"required": [
"star_type"
],
"properties": {
"star_type": {
"const": 4
}
}
},
"else": {
"properties": {
"star_type": {
"const": 1
}
}
}
}
]
}响应
成功返回 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 调用一样计费。