Creators

Douyin API

Also known as抖音抖音短视频

34 endpoints read Douyin: videos, hashtags, users, comments, trends, trend-index, Xingtu. From $0.0020 a call. No Douyin login and no cookie; a failed call is free.

Endpoints34 endpointsin 7 groups, one response shape
PriceFrom $0.0020per call. Failed calls are free
When an upstream failsRetried for youChecked every day with real calls · 4 days on record
DataFetched liveboards are 10-minute snapshots

One call, as it came back

A recorded call, fields already tidied up: ready for an AI or a spreadsheet.
Recorded
GET/v1/douyin/videos/search$0.0200
FieldValue
typevideo
langzh
published_at2026-09-11 01:32 UTC
author.followers2,525
metrics.likes96,505
metrics.comments2,219
metrics.shares60,467
metrics.favorites7,038

The first 8 rows of a response recorded 2026-10-12 19:01 UTC.

Run it in the Playground · $0.0200
Recorded response
{
  "code": "ok",
  "request_id": "c4c779e7-8730-415a-ab8b-2439d70fb51a",
  "data": {
    "items": [
      {
        "id": "7732320280216651754",
        "url": "https://www.douyin.com/video/7732320280216651754",
        "type": "video",
        "title": null,
        "text": "周末的露营日常,随手记录一下",
        "lang": "zh",
        "published_at": "2026-09-11T01:32:11.000Z",
        "author": {
          "id": "MS4wLjABAAAAWo9vAvyTzp3sb2-krZmkriyZuGbWt-p4togQvkClUpj",
          "username": "weekend_lin",
          "name": "小林的周末",
          "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_ec931a72ca043f30fa7e.jpeg",
          "followers": 2525
        },
        "metrics": {
          "likes": 96505,
          "comments": 2219,
          "shares": 60467,
          "favorites": 7038
        },
        "images": null,
        "hashtags": ["户外生活", "好物分享"]
      },
      // … 6 more
    ]
  },
  "page": {
    "next_cursor": "c1.ts-YHxldZuVXCxH6Gev5iQGlxtlGILU8V8n9tjjp",
    "cursor_expires_at": "2026-10-12T20:01:55.000Z",
    "has_more": true,
    "returned": 7
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.videos.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T19:01:55.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "metrics.views": "capability",
      "metrics.reposts": "platform",
      "author.verified": "capability",
      "mentions": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform",
      "is_pinned": "capability"
    },
    "billing": {
      "amount": "0.02",
      "currency": "USD",
      "balance_after": "9.98"
    }
  }
}

From a response recorded 2026-10-12 19:01 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

What you can get

Each row is an endpoint: what it returns and what one call costs.

EndpointPathReturnsPrice
Videos6
Douyin video searchGET/v1/douyin/videos/searchPost list$0.0200
Douyin video detailGET/v1/douyin/videos/getPost$0.0020
Douyin video commentsGET/v1/douyin/videos/comments/listComment list$0.0020
Douyin video play countGET/v1/douyin/videos/metricsPost$0.0020
Douyin related videosGET/v1/douyin/videos/relatedPost list$0.0020
Douyin trending videosGET/v1/douyin/videos/trendingPost list$0.0020
Hashtags1
Douyin hashtag videosGET/v1/douyin/hashtags/videos/listPost list$0.0020
Users4
Douyin user searchGET/v1/douyin/users/searchAccount list$0.0020
Douyin user profileGET/v1/douyin/users/getAccount$0.0020
Douyin creator engagement and follower trendsGET/v1/douyin/users/historyAccount recent change$0.0020
Douyin user videosGET/v1/douyin/users/videos/listPost list$0.0020
Comments1
Douyin comment repliesGET/v1/douyin/comments/replies/listComment list$0.0020
Douyin hot search boardGET/v1/douyin/trends/listTrend list$0.0020
Douyin trend-index keyword hot videosGET/v1/douyin/index/videos/searchPost list$0.0020
Douyin trend-index creator follower profileGET/v1/douyin/index/creators/audience/getAudience$0.0020
Douyin trend-index keyword audienceGET/v1/douyin/index/keywords/audience/getKeyword audience$0.0020
Douyin trend-index brand trendsGET/v1/douyin/index/brands/historyBrand index history$0.0020
Douyin trend-index brand comparisonGET/v1/douyin/index/brands/metricsBrand index averages$0.0020
Douyin trend-index creator core metricsGET/v1/douyin/index/creators/metricsDouyin trend-index creator metrics$0.0020
Douyin trend-index creator top videosGET/v1/douyin/index/creators/videos/listPost list$0.0020
Douyin trend-index keyword trendsGET/v1/douyin/index/keywords/historyKeyword index history list$0.0060
Douyin trend-index related keywordsGET/v1/douyin/index/keywords/relatedRelated keyword list$0.0020
Douyin trend-index live hot topicsGET/v1/douyin/index/trends/listTrend list$0.0020
Douyin Xingtu creator searchGET/v1/douyin/xingtu/creators/searchCreator list$0.0040
Douyin Xingtu creator audienceGET/v1/douyin/xingtu/creators/audience/getAudience$0.0040
Douyin Xingtu creator content mixGET/v1/douyin/xingtu/creators/content_mix/getXingtu creator content mix$0.0040
Douyin Xingtu creator conversionGET/v1/douyin/xingtu/creators/conversion/getXingtu creator conversion$0.0040
Douyin Xingtu creator profileGET/v1/douyin/xingtu/creators/getCreator$0.0040
Douyin Xingtu creator content keywordsGET/v1/douyin/xingtu/creators/keywords/getXingtu creator content keywords$0.0020
Douyin Xingtu creator rate cardGET/v1/douyin/xingtu/creators/rates/getCreator rates$0.0400
Douyin Xingtu creator index scoresGET/v1/douyin/xingtu/creators/scores/getXingtu creator scores$0.0080
Douyin Xingtu marketing calendarGET/v1/douyin/xingtu/campaigns/listXingtu campaign list$0.0040
Douyin Xingtu creator metricsGET/v1/douyin/xingtu/creators/metricsXingtu creator metrics$0.0040
Douyin Xingtu creator video performanceGET/v1/douyin/xingtu/creators/videos/listXingtu creator video list$0.0040
Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.Douyin API pricing →Douyin data in your AI →See live status →

Only on Douyin

trend-index, Xingtu: data that sits behind Douyin's own dashboards and sign-ins. Here each is one GET.

Douyin trend-index API →

Keyword trends, related keywords, audiences, brand indexes, live hot topics

Douyin's official index tool (巨量算数, Juliang Suanshu): day-by-day keyword and brand indexes, who searches a keyword, related keywords, live hot topics and creator figures.

A keyword's search index over 30 daysExample
30 days ago15 days agoyesterday
GET /v1/douyin/index/keywords/history$0.006010 endpoints · from $0.0020 →
Douyin Xingtu API →

Creator search, rate cards, audience profiles, reach and conversion

Douyin's official creator marketplace (星图): creator search, rate cards, audience profiles, reach and conversion figures.

One creator's rate card · creator maskedRecorded
植入视频 固定价格¥400,000
定制视频 固定价格¥500,000
GET /v1/douyin/xingtu/creators/rates/get$0.040011 endpoints · from $0.0020 →
Douyin hot search →

What Douyin is watching now

The platform's own list at the moment of the call, with its heat figures. The free board page shows it all.

Top 5 · read Oct 21, 2026, 16:05 UTC+8Recorded
1 走好今天的长征路Pinned
2 NBA揭幕战马刺雷霆爆发冲突11.44M
3 冬天第一串车厘子糖葫芦11.37M
4 解读中国经济“三季报”11.14M
5 全国已开始进入赏秋模式11.04M
GET /v1/douyin/trends/list$0.0020

What people build with it

Ready-made tasks your AI can run on Douyin data. Each is a few calls under a spending cap.

Ask about Douyin right inside Claude or Cursor

Add the DataXAPI MCP server and the AI finds the Douyin endpoint it needs and calls it; answers link back to the source. You pay for the calls it makes.

Douyin MCP setup →
https://api.dataxapi.com/mcp

Start in three steps

The call shown here is Douyin video search. Every other Douyin endpoint is called the same way and answers in the same envelope.

Get a key

Sign in with an emailed code or Google. Free trial, no card needed.

Call it, or let your AI call it

One GET from your code. Or paste this prompt into your agent with your key in it: it sets itself up, then finds and calls these endpoints by itself.

Read https://dataxapi.com/agents.md and set up DataXAPI in this agent. My API key is dx_live_…; use it for every DataXAPI call.

Sign in to copy it with your key

Read the same shape every time

Items are in data.items (one object in data.item), the next page in page.next_cursor, the charge in meta.billing.amount. A failed call is not charged.

Read the quickstart →
curl -G "https://api.dataxapi.com/v1/douyin/videos/search" \
  --data-urlencode "query=露营" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.douyin.videos.search(query="露营")
print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.douyin.videos.search({ query: "露营" });
console.log(result.data.items);
dataxapi call douyin.videos.search 'query=露营'
{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

Add this to your MCP client, then ask your agent to call douyin.videos.search.

Edge cases

What the Douyin endpoints do at their edges, and what to check when a call does not return what you expected.

Page sizes
A list returns 1 to 250 items a page, depending on the endpoint. 10 of the 17 lists go on to a next page: page.next_cursor, passed back as cursor, each page a call of its own. The others return one page only.
Fields it cannot give
18 of the 34 endpoints cannot fill every field of the object they return. Each endpoint's page lists which, and every answer repeats them in meta.unavailable: a missing field is never a silent zero.
A missing object that reads as empty
Douyin comment replies, Douyin trend-index creator top videos, Douyin trend-index keyword trends, Douyin trend-index related keywords, Douyin user videos, Douyin video comments, Douyin related videos, Douyin Xingtu creator video performance: an object that does not exist cannot be told from one with nothing under it, so the answer is an empty result, not a 404, and is charged as an empty result is.
Several in one request
With ids, one request reads several: Douyin creator engagement and follower trends (up to 5), Douyin Xingtu creator profile (up to 50).
Preview structures
19 endpoints return a preview structure whose fields may still change; the others return a standard object, the same on every platform.
Snapshots
Douyin trend-index live hot topics, Douyin hot search board, Douyin trending videos: a board is a snapshot refreshed every 10 minutes, and meta.fetched_at says when it was taken.
Two kinds of account ID
Profiles and an account's videos take the sec_uid: the string starting with MS4w at the end of a profile link (douyin.com/user/…). The trend-index endpoints for an account take its numeric uid instead.
The Xingtu creator ID
Xingtu endpoints take the Xingtu creator ID, not a Douyin account ID: take it from the Xingtu creator search. The Xingtu profile of one creator also gives the Douyin account ID.
Where the play count is
Video detail, search and an account's video list carry no play count. douyin.videos.metrics reads plays and likes by video ID; the video boards carry plays too.
Empty is not “not found”
Comments of a video that does not exist, or videos of an account that does not exist, come back as an empty list and are charged as an empty result. Related videos do not check the ID: one nobody has still gets recommendations unrelated to it, or an empty result.
One bad ID fails the batch
douyin.users.history takes up to five numeric IDs at once; if one of them does not exist, the whole batch fails.

Questions about the Douyin API

Short answers. The details are on each endpoint's page.

How is the Douyin API priced?

Per call, no subscription. From $0.0020 to $0.0400 a call; each endpoint's page shows its own price. You are charged when data comes back; a failed call costs nothing.

Do I need a Douyin account or a cookie?

No. One DataXAPI key is all you hold: no Douyin login, no cookie, no device to keep alive. The endpoints return publicly visible data only.

Is the data live?

A call fetches from Douyin at that moment, and meta.fetched_at says when. Douyin trend-index live hot topics, Douyin hot search board, Douyin trending videos: a board is a snapshot refreshed every 10 minutes. A result is kept for 24 hours, so a retry with the same Idempotency-Key is not charged again.

Is an empty result charged?

A list that comes back empty is charged its price: the search was run. Reading one object that does not exist answers not_found and is free.

What happens when Douyin changes something?

A call that fails is not charged, whatever the reason. An endpoint that is paused answers capability_paused, also free, and GET /v1/catalog/status says what is up right now.

Related

Call Douyin with one key.

Free trial on sign-up: up to 50 calls at $0.0020. No card. No Douyin login, no cookie, no subscription. A failed call is free.

Start free