Douyin Video

Retrieve video with the Douyin API. Input fields and response shapes depend on the selected implementation. Use it in a video discovery or content monitoring workflow. Choose an implementation and check its published request fields, examples, and usage pricing before integrating.

Selected price
$0.012 / callPublished pricing
Sellers / implementations
2 / 44
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
body*object

body

Search public Douyin videos by keyword with sorting, time, duration, and content filters.
Optional parameters (6)
Optional. Comma-separated keys (dotted paths like `author.name` descend into nested objects) to keep on each result item: each row of the API's result list, or the `data` object itself for an API that returns one record. Keys are matched relative to that item, not against the top-level response envelope, so use `jq` to reshape the whole envelope. Shrinks the response without changing cost.
Optional. Cap the number of result rows returned; a `_truncated` note reports how many were withheld so you can page via the API's own `limit`. An API that returns one record is not trimmed. Does not change cost.
Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.
Optional. A jq expression applied to the result envelope; its output replaces `output` (multiple outputs collect into an array). Reshape freely, e.g. `jq=.data | {title, description, md: .markdown[:3500]}`. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a `jqError`. Does not change cost.
Optional. The most you are willing to pay for this one request, in US dollars (for example 0.05). Any route that would charge more than this is not used, so a request only ever runs on something you can afford. If nothing is available at or below your amount, the request is refused before it runs, nothing is charged, and the message tells you the cheapest price per request so you can raise it. Leave it out to accept the normal price.
Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict.

Sample response

{
  "output": {
    "data": {
      "backtrace": "eyJyZXFJZCI6ImV4YW1wbGUtc2VhcmNoLXRyYWNlLTEyMyJ9",
      "hasMore": true,
      "nextCursor": "20",
      "searchId": "6890123457812345678",
      "videos": [
        {
          "authorImage": "https://p3-pc.douyinpic.com/img/aweme-avatar/example_robotwatcher_avatar~c5_300x300.jpeg",
          "authorNickname": "机器人观察员",
          "authorUniqueId": "robot_watcher_cn",
          "authorUserId": "51923847610283746",
          "authorVerified": true,
          "caption": "国产人形机器人最新进展,已经能对话又能干活了 #机器人 #科技前沿",
          "comments": 8900,
          "createdUtc": 1758211200,
          "durationMs": 58000,
          "height": 1920,
          "id": "7449028193746501234",
          "image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_humanoid_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
          "likes": 246000,
          "region": "CN",
          "saves": 41000,
          "shares": 15200,
          "url": "https://www.douyin.com/video/7449028193746501234",
          "videoUrl": "https://v3-web.douyinvod.com/example_token_a1b2c3/video/tos/cn/tos-cn-ve-15/exampleHumanoidVideoId/?a=6383&ch=0&cr=0&dr=0&lr=all&cd=0%7C0%7C0%7C3",
          "views": 3820000,
          "width": 1080
        },
        {
          "authorImage": "https://p3-pc.douyinpic.com/img/aweme-avatar/example_geeklab_avatar~c5_300x300.jpeg",
          "authorNickname": "极客实验室",
          "authorUniqueId": "geek_lab_official",
          "authorUserId": "40381927465102938",
          "authorVerified": true,
          "caption": "机器人舞蹈大赛总决赛现场,这个转圈太丝滑了",
          "comments": 3400,
          "createdUtc": 1757952000,
          "durationMs": 73000,
          "height": 1920,
          "id": "7448611029384756123",
          "image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_robotdance_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
          "likes": 98000,
          "region": "CN",
          "saves": 12800,
          "shares": 6200,
          "url": "https://www.douyin.com/video/7448611029384756123",
          "videoUrl": "https://v3-web.douyinvod.com/example_token_d4e5f6/video/tos/cn/tos-cn-ve-15/exampleRobotDanceVideoId/?a=6383&ch=0&cr=0&dr=0&lr=all&cd=0%7C0%7C0%7C3",
          "views": 1560000,
          "width": 1080
        },
        {
          "authorImage": "https://p3-pc.douyinpic.com/img/aweme-avatar/example_homegadgets_avatar~c5_300x300.jpeg",
          "authorNickname": "居家好物研究所",
          "authorUniqueId": "home_gadgets_lab",
          "authorUserId": "29384756102938475",
          "authorVerified": false,
          "caption": "扫地机器人买贵的还是买便宜的?三款实测对比",
          "comments": 2700,
          "createdUtc": 1757520000,
          "durationMs": 214000,
          "height": 1920,
          "id": "7447903384756019283",
          "image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_vacuumrobot_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
          "likes": 61000,
          "region": "CN",
          "saves": 22000,
          "shares": 3100,
          "url": "https://www.douyin.com/video/7447903384756019283",
          "videoUrl": "https://v3-web.douyinvod.com/example_token_g7h8i9/video/tos/cn/tos-cn-ve-15/exampleVacuumRobotVideoId/?a=6383&ch=0&cr=0&dr=0&lr=all&cd=0%7C0%7C0%7C3",
          "views": 987000,
          "width": 1080
        }
      ]
    },
    "found": true
  }
}

Response result

Response structure

Inferred from examples
  • outputobject
    • dataobject
      • backtracestring
      • hasMoreboolean
      • nextCursorstring
      • searchIdstring
      • videosobject[]
        • authorImagestring
        • authorNicknamestring
        • authorUniqueIdstring
        • authorUserIdstring
        • authorVerifiedboolean
        • captionstring
        • commentsinteger
        • createdUtcinteger
        • durationMsinteger
        • heightinteger
        • idstring
        • imagestring
        • likesinteger
        • regionstring
        • savesinteger
        • sharesinteger
        • urlstring
        • videoUrlstring
        • viewsinteger
        • widthinteger
    • foundboolean

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use Douyin Video with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.