raw.douyin.creator_videos

Douyin creator videos

LiveBetaNo free quota

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

Posts a creator published, pinned ones first and then newest first (or most popular first), about 20 a page, as the same records as video detail (same ids). Pass the previous page's cursor back to continue; stop when has_more is false. A creator without posts, or one that does not exist, answers empty and is not charged.

Price: $0.001 / call$1 per 1k · fixed price
Billing: Charged only for successful, non-empty resultsno free quota
Scope: raw:douyinThe API key needs this scope
Rate cap: Account limit onlyYour per-minute limit

Parameters

Sent as query parameters

Only these parameters are accepted; any other one returns 400.

user_idstringRequired

The user's sec_uid (starts with MS4wLjABAAAA; Douyin rejects numeric uids)

Pattern^MS4wLjABAAAA[0-9A-Za-z_-]{20,100}$

ExampleMS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs

cursorinteger

The cursor from the previous page's response; 0 for the first page

Default0Range0–…

sortstring · enum

Order: latest (the default) or popular

DefaultlatestOne oflatest · popular

curl 'https://api.qovia.ai/v1/raw/douyin/creator_videos?user_id=MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs' \
  -H "Authorization: Bearer $QOVIA_KEY"

Replace $QOVIA_KEY with your API key

Example response200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "items": [
      {
        "id": "soc_dou_e15ee224d064",
        "src": "social",
        "platform": "douyin",
        "lang": "zh-CN",
        "text": "小马长成了小马哥 静态体验奔腾小马五门版 曾经让鲍师傅爱不释手的奔腾小马，竟然推出了加长的五座版，不仅是尺寸的升级，更是把使用痛点进行了全面的消除，小马终于长成了小马哥。#奔腾小马…",
        "author": {
          "uid_hash": "d6f636c1d58b",
          "followers": null,
          "nickname": "爱车的BAO师傅",
          "uid": "108882376804",
          "sec_uid": "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs",
          "unique_id": "dydyttmfh8s2"
        },
        "metrics": {
          "likes": 10,
          "comments": 5,
          "shares": 6,
          "saves": 3
        },
        "extra": {
          "source_id": "7698963081988181257",
          "published_at": "2026-10-21T11:48:54+08:00",
          "video_dur_s": 425,
          "topic": "#奔腾小马",
          "topics": [
            "奔腾小马",
            "奔腾小马五门版",
            "小马哥",
            "小车"
          ],
          "content_type": "video",
          "cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/da35ff97007541d0a3d61badb24d451f~tplv-dy-resize-walign-adapt-aq:540:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=4JgHOHab8Ibp8B24hkrPRKernM4%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=20261021235008414FF27B970EAEBE0909",
          "url": "https://www.douyin.com/video/7698963081988181257"
        },
        "prov": {
          "hash": "0x91eadd340b12fce9",
          "ts": "2026-10-21T23:50:08+08:00",
          "source": "live"
        }
      },
      {
        "id": "soc_dou_5d11adb275ac",
        "src": "social",
        "platform": "douyin",
        "lang": "zh-CN",
        "text": "不要被外表欺骗这可是个狠角色 体验星钽5X 通常高颜值不意味着高性能，但星钽5X是个例外，特别是开上非铺装路面，这辆车才展现出它的真实实力。#北汽星钽5X #星钽5X #越野 #方…",
        "author": {
          "uid_hash": "d6f636c1d58b",
          "followers": null,
          "nickname": "爱车的BAO师傅",
          "uid": "108882376804",
          "sec_uid": "MS4wLjABAAAAAKgMNYSx2pL3ARundki9oB8pmdvX9hVgujii5bnZUXs",
          "unique_id": "dydyttmfh8s2"
        },
        "metrics": {
          "likes": 13,
          "comments": 2,
          "shares": 0,
          "saves": 1
        },
        "extra": {
          "source_id": "7698752037126802723",
          "published_at": "2026-10-20T22:10:09+08:00",
          "video_dur_s": 678,
          "topic": "#北汽星钽5X",
          "topics": [
            "北汽星钽5X",
            "星钽5X",
            "越野",
            "方盒子"
          ],
          "content_type": "video",
          "cover_url": "https://p3-sign.douyinpic.com/tos-cn-i-dy/5c2e9d385b1646f9b459007b94ad63d7~tplv-dy-resize-walign-adapt-aq:540:q75.heic?lk3s=138a59ce&x-expires=1793804400&x-signature=UZNm9x9JOTe1MNWDNA9zlRfW24M%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=false&sc=cover&biz_tag=aweme_video&l=20261021235008414FF27B970EAEBE0909",
          "url": "https://www.douyin.com/video/7698752037126802723"
        },
        "prov": {
          "hash": "0x755e43a674c7d2c1",
          "ts": "2026-10-21T23:50:08+08:00",
          "source": "live"
        }
      }
    ],
    "cursor": 1790514095000,
    "has_more": true,
    "prov": {
      "hash": "0xe81616f943e8d846",
      "ts": "2026-10-21T23:50:08+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.001000",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.999000",
    "empty": false
  }
}

Catalog sample, not live data

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
code	HTTP	Billing	Description
`scope_denied`	403	Not charged	This API key lacks the scope the endpoint requires.
`endpoint_unavailable`	503	Not charged	The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
`invalid_params`	400	Not charged	The parameters failed validation: a required one is missing, a type or format is wrong, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (`item_id: …`); a missing or unknown parameter starts with `params: …`.
`rate_limited`Retryable	429	Not charged	Over the account's per-minute limit (sliding 60-second window); wait for `Retry-After`.
`too_many_unbilled`Retryable	429	Not charged	In the last 10 minutes at least 50 of your calls to data sources, and over 80% of them, came back empty, not found or rejected; slow down.
`insufficient_balance`	402	Not charged	The balance cannot pay for this call (the free quota is used up, or the endpoint does not use it).
`upstream_busy`Retryable	503	Refunded	The data source is busy or cooling down; refunded. Retry after `Retry-After`.
`upstream_timeout`	504	Refunded	The data source timed out; refunded.
`upstream_error`	502 / 503	Refunded	The data source failed; refunded.
`upstream_rejected`	400	Refunded	The data source rejected these parameters (well-formed, but not accepted); refunded.
`not_found`	404	Refunded	The data source has no such item (deleted, or the ID does not exist); refunded.
`reservation_expired`	504	Refunded	The call took too long and was refunded automatically; no data is returned.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code

Call it from your browser

Needs an account; playground calls are billed like API calls.

Try in the playground Create an API key