Douyin API

Douyin User posts API

List public posts from a Douyin user with normalized engagement data and pagination.

Start freeDownload sampleor JSON

$1.20/1k req, pay per request, no subscription.

What the API returnedposts[0]
{
"id": "7448198231045678901",
"caption": "3分钟快手番茄炒蛋,新手也能一次成功 #家常菜 #下饭菜",
"createdUtc": 1758043200,
"url": "https://www.douyin.com/video/7448198231045678901",
"image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_tomato_egg_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
"authorUserId": "68219347502938175",
"authorSecUserId": "MS4wLjABAAAAeF3jQnP4mVL2oKt9dHnA8Y5m0Zk7Xr1cWvT6bBsJhNq3wRfCz2GkTiPn8adYX5Lq",
"authorNickname": "小鹿家常菜",
... 12 more fields
}
Uptime
98.84%
30d · 601 calls
Requests
601
30d · weekly, last 12 wks
Response
2.0s
median · 30d

Pricing

Douyin User posts API pricing

You pay
$12.00
$1.20/1k req, only for what you use. No monthly plan.
Your first 83 requests are free with the $0.10 starting balance.

Try it

Get Douyin user posts in one request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.

This sample shows 25 of 26 fields. See every field

{
  "found": true,
  "data": {
    "nextCursor": "1746623041000",
    "hasMore": true,
    "posts": [
      {
        "id": "7448198231045678901",
        "caption": "3分钟快手番茄炒蛋,新手也能一次成功 #家常菜 #下饭菜",
        "createdUtc": 1758043200,
        "url": "https://www.douyin.com/video/7448198231045678901",
        "image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_tomato_egg_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
        "authorUserId": "68219347502938175",
        "authorSecUserId": "MS4wLjABAAAAeF3jQnP4mVL2oKt9dHnA8Y5m0Zk7Xr1cWvT6bBsJhNq3wRfCz2GkTiPn8adYX5Lq",
        "authorNickname": "小鹿家常菜",
        "views": 1240000,
        "likes": 89000,
        "comments": 3200,
        "shares": 4100,
        "saves": 15600,
        "authorUniqueId": "xiaolu_homecook",
        "authorImage": "https://p3-pc.douyinpic.com/img/aweme-avatar/example_xiaolu_avatar~c5_300x300.jpeg",
        "authorVerified": true,
        "region": "CN",
        "durationMs": 187000,
        "width": 720,
        "height": 1280
      },
      {
        "id": "7447625580192837465",
        "caption": "秋天第一顿火锅,自制麻辣锅底教程收好",
        "createdUtc": 1757606400,
        "url": "https://www.douyin.com/video/7447625580192837465",
        "image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_hotpot_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
        "authorUserId": "68219347502938175",
        "authorSecUserId": "MS4wLjABAAAAeF3jQnP4mVL2oKt9dHnA8Y5m0Zk7Xr1cWvT6bBsJhNq3wRfCz2GkTiPn8adYX5Lq",
        "authorNickname": "小鹿家常菜",
        "views": 856000,
        "likes": 52000,
        "comments": 1800,
        "shares": 2600,
        "saves": 9800,
        "authorUniqueId": "xiaolu_homecook",
        "authorImage": "https://p3-pc.douyinpic.com/img/aweme-avatar/example_xiaolu_avatar~c5_300x300.jpeg",
        "authorVerified": true,
        "region": "CN",
        "durationMs": 305000,
        "width": 720,
        "height": 1280
      },
      {
        "id": "7446892034758201234",
        "caption": "剩菜改造:隔夜米饭做黄金蛋炒饭",
        "createdUtc": 1757088000,
        "url": "https://www.douyin.com/video/7446892034758201234",
        "image": "https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_friedrice_cover~tplv-dy-resize-origshort-autoq-75.jpeg",
        "authorUserId": "68219347502938175",
        "authorSecUserId": "MS4wLjABAAAAeF3jQnP4mVL2oKt9dHnA8Y5m0Zk7Xr1cWvT6bBsJhNq3wRfCz2GkTiPn8adYX5Lq",
        "authorNickname": "小鹿家常菜",
        "views": 623000,
        "likes": 41000,
        "comments": 1200,
        "shares": 1900,
        "saves": 7300,
        "authorUniqueId": "xiaolu_homecook",
        "authorImage": "https://p3-pc.douyinpic.com/img/aweme-avatar/example_xiaolu_avatar~c5_300x300.jpeg",
        "authorVerified": true,
        "region": "CN",
        "durationMs": 142000,
        "width": 720,
        "height": 1280
      }
    ]
  }
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

One request, one response shape.

Every field you send and every field you get back, each with a real example.

Last verified 2026-10-31 · uptime and latency measured over 30d

Request body

JSON, posted to this endpoint.

  • secUserIdstring

    MS4wLjABAAAAeF3jQnP4mVL2oKt9dHnA8Y5m0Zk7Xr1cWvT6bBsJhNq3wRfCz2GkTiPn8adYX5Lq

    Douyin sec_user_id for the public account.

  • cursorstring

    Pagination cursor: pass the previous response's nextCursor; omit for the first page. A raw integer cursor is still accepted.

  • limitinteger

    20

    Requested page size. Values up to 20 are recommended.

  • sortenum

    newest

    Post order: newest, most-popular.

You send. A small JSON body. The values shown are examples to replace with your own.

Response

JSON, one example value per field.

datadata

Posts and pagination, or null when none were found.

  • hasMoreboolean

    true

    Whether another page is available.

  • nextCursorstring

    1746623041000

    Opaque cursor for the next page of posts, or null when this lane has no more. Pass it back as cursor to continue.

each postdata.posts[]

Normalized Douyin posts. Populated whenever the provider has data for the entity.

  • authorImagestring

    https://p3-pc.douyinpic.com/img/aweme-avatar/example_xiaolu_avatar~c5_300x300.jpeg

    Author's avatar image URL.

  • authorNicknamestring

    小鹿家常菜

    Author display name. Populated whenever the provider has data for the entity.

  • authorSecUserIdstring

    MS4wLjABAAAAeF3jQnP4mVL2oKt9dHnA8Y5m0Zk7Xr1cWvT6bBsJhNq3wRfCz2GkTiPn8adYX5Lq

    Author sec_user_id. Populated whenever the provider has data for the entity.

  • authorUniqueIdstring

    xiaolu_homecook

    Author's Douyin handle (unique id).

  • authorUserIdstring

    68219347502938175

    Author user identifier. Populated whenever the provider has data for the entity.

  • authorVerifiedboolean

    true

    Whether the author's account is verified.

  • captionstring

    3分钟快手番茄炒蛋,新手也能一次成功 #家常菜 #下饭菜

    Post caption. Populated whenever the provider has data for the entity.

  • commentsinteger

    3200

    Comment count.

  • createdUtcnumber

    1758043200

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.

  • durationMsinteger

    187000

    Media duration in milliseconds.

  • heightinteger

    1280

    Pixel height of the media.

  • idstring

    7448198231045678901

    Post identifier. Populated whenever the provider has data for the entity.

  • imagestring

    https://p3-pc.douyinpic.com/img/tos-cn-i-0813/example_tomato_egg_cover~tplv-dy-resize-origshort-autoq-75.jpeg

    Cover image URL.

  • likesinteger

    89000

    Like count.

  • regionstring

    CN

    Two-letter region code the post was published from.

  • savesinteger

    15600

    Save count.

  • sharesinteger

    4100

    Share count.

  • urlstring

    https://www.douyin.com/video/7448198231045678901

    Canonical post URL. Populated whenever the provider has data for the entity.

  • viewsinteger

    1240000

    Play count.

  • widthinteger

    720

    Pixel width of the media.

top level
  • foundboolean

    true

    True when posts were found.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

You get back. Named, typed fields in the same shape whichever source answers.

FAQ

About the Douyin User posts API

The AnyAPI Douyin User posts API returns Douyin user posts data as normalized JSON from one POST call to /v1/run/douyin.user_posts. List public posts from a Douyin user with normalized engagement data and pagination. AnyAPI returns one normalized schema whichever source serves it. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 98.8% of Douyin user posts calls through AnyAPI succeeded, with a median response time of 2.0 seconds across 601 measured calls.

It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet and each call draws it down. Some failed wallet-funded requests incur processing charges that we pass through at cost, with no markup; the error response shows the amount charged.

List public posts from a Douyin user with normalized engagement data and pagination. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 98.8% of Douyin user posts calls through AnyAPI succeeded, with a median response time of 2.0 seconds across 601 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Yes. A new AnyAPI account starts with $0.10 of free balance and no card required, which covers 83 Douyin User posts calls at $0.0012 each.

Send a POST request to https://api.getanyapi.com/v1/run/douyin.user_posts with your AnyAPI key in an "Authorization: Bearer" header and the input as a JSON body. The same key and the same wallet work on every AnyAPI endpoint.

No. You add US dollars to one prepaid AnyAPI balance and each request draws it down. There is no monthly plan and no minimum, and the same balance pays for every AnyAPI endpoint.

Yes. Install @getanyapi/sdk from npm for TypeScript or getanyapi from pip for Python. Both call every AnyAPI endpoint with the same key, and any HTTP client works too.

Yes. An agent can connect to the AnyAPI MCP server at https://api.getanyapi.com/mcp, or create its own free-trial key with one unauthenticated POST to https://api.getanyapi.com/agent/signup and call this endpoint over HTTP.
More to call

Other Douyin endpoints

Profilefrom $1.20 /1k reqSearch videosfrom $12.00 /1k reqVideofrom $1.20 /1k reqVideo commentsfrom $1.20 /1k req