raw.douyin.video_v2

抖音作品详情 V2

实时Beta

GEThttps://api.qovia.ai/v1/raw/douyin/video_v2

单个抖音作品（视频或图文），原样返回抖音自己的 JSON（aweme_detail）：文案 desc、作者、点赞/评论/分享/收藏等统计、音乐；视频带 video 字段，图文（aweme_type 68）带完整的 images 列表（每张图都有 url_list）。 item_id 可填作品 ID，或作品链接：douyin.com/video/<ID>、douyin.com/note/<ID>（可带查询参数）、 iesdouyin.com/share/(video|note|slides)/<ID>、v.douyin.com 短链接，也可以直接粘贴整段分享文案（含上述链接）。作品不存在时返回 404，不计费。

常见用途：追踪单条内容或商品的数据：传播效果、互动变化和归档。

价格: $0.0012 / 次$1.2 / 千次 · 固定价格
计费: 成功且有结果才扣费扣费写在 meta.charged_usd
权限: raw:douyinAPI Key 需要这个 scope
限速: 不限流不按账户或接口限制每分钟请求数

请求参数

作为查询参数发送

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

item_idstring必填

作品 ID 或作品链接/分享文案（douyin.com/video/<ID>、douyin.com/note/<ID>、v.douyin.com 短链接均可）

最多 2000 字

示例7705744790155735545

curl 'https://api.qovia.ai/v1/raw/douyin/video_v2?item_id=7705744790155735545' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "aweme_id": "7705744790155735545",
    "aweme_type": 68,
    "desc": "给集大学弟整理的一份好吃的清单🧾",
    "create_time": 1794133519,
    "author": {
      "nickname": "胖兔吃不胖",
      "uid": "7697521569191347237",
      "sec_uid": "MS4wLjABAAAAl4zCZaJnmb64U38lhJvdwsECMnPQErMR5kknYkOGVN5A1f7ie-r2eTN88M6NFWrW",
      "unique_id": "54676984446"
    },
    "statistics": {
      "digg_count": 545,
      "comment_count": 90,
      "share_count": 591,
      "collect_count": 397
    },
    "images": [
      {
        "url_list": [
          "https://p26-sign.douyinpic.com/tos-cn-i-wftb4kr1i9/example-1~tplv-wftb4kr1i9-origin.image"
        ],
        "width": 1440,
        "height": 3130
      },
      {
        "url_list": [
          "https://p3-sign.douyinpic.com/tos-cn-i-wftb4kr1i9/example-2~tplv-wftb4kr1i9-origin.image"
        ],
        "width": 1440,
        "height": 3130
      }
    ],
    "share_url": "https://www.iesdouyin.com/share/note/7705744790155735545/"
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.001200",
    "balance_usd": "9.998800",
    "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% 以上，放慢后再试。
`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

请求参数

响应

错误码

抖音的其他接口