raw.xingtu.author_videos_v3抖音星图达人主页视频 V3
实时Beta:接口和返回字段仍可能调整
GET
https://api.qovia.ai/v1/raw/xingtu/author_videos_v3星图达人主页的视频列表(原样 JSON):items 中每条含 item_id、video_id、title、create_time、duration、播放数 watch_cnt、点赞数 like_cnt、评论数 comment_cnt、互动率 interact_rate、完播率 finish_rate、内容主题标签 content_theme_labels、封面和链接,另有 pagination(page、limit、total_count、has_more)和 base_resp。 可选 page(默认 1,has_more 为 true 时继续翻页)。响应较快,通常约 3 秒。 没有视频(items 缺失或为空,或只有 base_resp)时返回空结果。只对有数据的结果计费,空结果和出错都不计费。
常见用途:达人筛选与评估、账号监测、竞品账号分析。
- 价格
- $0.08451 / 次$84.51 / 千次 · 固定价格
- 计费
- 成功且有结果才扣费扣费写在 meta.charged_usd
- 权限
raw:xingtuAPI Key 需要这个 scope- 限速
- 仅账户限流账户每分钟上限
请求参数
作为查询参数发送
只接受下列参数,多出的参数会返回 400。
author_id星图作者 ID(o_author_id)
格式^[0-9]{15,20}$示例
6790158034132795406page页码,第一页为 1
默认1范围1–100
响应
成功返回 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% 以上,放慢后再试。 |
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 调用一样计费。