---
title: "Douyin API: Videos, Comments, Trend Index Data · SocialToAI"
canonical: https://socialtoai.app/platforms/douyin/
updated: 2026-11-20
---

# Douyin API

The Douyin API lets you search videos and read video details, comments, account profiles, an account's videos and the trending list, with no Douyin account or login. Calls cost 2 to 12 credits each (from $0.004); failed calls are free. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-19.

- Page: https://socialtoai.app/platforms/douyin/
- Last updated: 2026-11-20
- Last tested: 2026-11-19

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `search` | Find videos by keyword: text, author, likes, comment count and publish time. | — | `douyin.search` | 12 | [Douyin Search API](https://socialtoai.app/douyin-search-api.md) |
| `search` | accounts instead of posts | `type=user` | `douyin.search:user` | 2 | [Douyin Search API](https://socialtoai.app/douyin-search-api.md) |
| `trending` | What is trending now: title, rank and heat. | — | `douyin.trending` | 2 | [Douyin Trending API](https://socialtoai.app/douyin-trending-api.md) |
| `trending` | the trending videos board | `type=videos` | `douyin.trending:videos` | 2 | [Douyin Trending API](https://socialtoai.app/douyin-trending-api.md) |
| `detail` | One video by ID or link: text, author, likes, comment count and publish time. | — | `douyin.detail` | 2 | [Douyin Detail API](https://socialtoai.app/douyin-detail-api.md) |
| `comments` | The comments under one video: text, likes, reply count and time. | — | `douyin.comments` | 2 | [Douyin Comments API](https://socialtoai.app/douyin-comments-api.md) |
| `comments` | the replies under one comment | `reply_of` | `douyin.comments:replies` | 2 | [Douyin Comments API](https://socialtoai.app/douyin-comments-api.md) |
| `user_profile` | One account: name, bio, followers, following and post count. | — | `douyin.user_profile` | 2 | [Douyin User Profile API](https://socialtoai.app/douyin-user-profile-api.md) |
| `user_posts` | The recent videos of one account. | — | `douyin.user_posts` | 2 | [Douyin User Posts API](https://socialtoai.app/douyin-user-posts-api.md) |

Compared with Xiaohongshu: Douyin videos also give author followers and views.

Lighter for your AI: across 33 interfaces measured on the same recorded data, the platform's raw JSON is about 1,836,257 tokens and SocialToAI's answers about 99,034, 94% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
curl https://socialtoai.app/v1/search \
  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "douyin",
    "query": "露营"
  }'
```

## Only on Douyin

Each one is called by its own op, through `POST /v1/call/{op}`; its full parameters and response fields are on its own page.

### Creators

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Xingtu creator search | Search Douyin creators on Xingtu by words in their name, filtered by followers, expected CPM (in yuan) and gender, or ordered by expected CPM, lowest first:Xingtu creator ID, name, location, content categories, followers. | `douyin.kol_search` | 3 | [Douyin KOL search API (Xingtu)](https://socialtoai.app/douyin-kol-search-api.md) |
| Xingtu creator profile | Get a Douyin creator's profile on Xingtu by Xingtu creator ID. | `douyin.kol_profile` | 3 | [Douyin KOL profile API (Xingtu)](https://socialtoai.app/douyin-kol-profile-api.md) |
| Xingtu creator audience | Get who follows a Douyin creator, by Xingtu creator ID. | `douyin.kol_audience` | 3 | [Douyin KOL audience API (Xingtu)](https://socialtoai.app/douyin-kol-audience-api.md) |
| Xingtu creator metrics | Get how a Douyin creator's videos did over the last 30 or 90 days, by Xingtu creator ID. | `douyin.kol_performance` | 3 | [Douyin KOL metrics API (Xingtu)](https://socialtoai.app/douyin-kol-performance-api.md) |
| Creator engagement and follower trends | Get how a Douyin account's numbers moved over the last 7 or 30 days, by its numeric ID, from the platform's own index tool. | `douyin.account_history` | 2 | [Douyin creator engagement and follower trends API](https://socialtoai.app/douyin-account-history-api.md) |
| Xingtu creator rate card | Get what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled. | `douyin.kol_rates` | 24 | [Douyin KOL rate card API (Xingtu)](https://socialtoai.app/douyin-kol-rates-api.md) |
| Xingtu creator video performance | Get a page of a Douyin creator's videos by Xingtu creator ID, newest first, with the figures Xingtu gives for each. | `douyin.kol_videos` | 3 | [Douyin KOL video performance API (Xingtu)](https://socialtoai.app/douyin-kol-videos-api.md) |
| Trend-index creator top videos | Get the videos the platform's own index tool lists as a Douyin account's top videos for a span of up to 30 days, by the account's numeric ID. | `douyin.account_top_videos` | 2 | [Douyin trend-index creator top videos API](https://socialtoai.app/douyin-account-top-videos-api.md) |
| Trend-index creator follower profile | Get who follows a Douyin account from the platform's own index tool, by the account's numeric ID. | `douyin.account_audience` | 2 | [Douyin trend-index creator follower profile API](https://socialtoai.app/douyin-account-audience-api.md) |
| Trend-index creator core metrics | Get a Douyin creator's core figures from the platform's own index tool, by the account's numeric ID. | `douyin.account_metrics` | 2 | [Douyin trend-index creator core metrics API](https://socialtoai.app/douyin-account-metrics-api.md) |
| Xingtu creator content keywords | Get the words Xingtu takes from a few of a Douyin creator's recent videos, by Xingtu creator ID. | `douyin.kol_keywords` | 2 | [Douyin KOL content keywords API (Xingtu)](https://socialtoai.app/douyin-kol-keywords-api.md) |
| Xingtu creator index scores | Get the six scores Xingtu gives a Douyin creator, by Xingtu creator ID. | `douyin.kol_scores` | 5 | [Douyin KOL index scores API (Xingtu)](https://socialtoai.app/douyin-kol-scores-api.md) |
| Xingtu creator content mix | Get what a Douyin creator's recent videos are about, by Xingtu creator ID. | `douyin.kol_content_mix` | 3 | [Douyin KOL content mix API (Xingtu)](https://socialtoai.app/douyin-kol-content-mix-api.md) |
| Xingtu marketing calendar | Get the campaigns on Xingtu's marketing calendar over a span of time. | `douyin.marketing_calendar` | 3 | [Douyin Xingtu marketing calendar API](https://socialtoai.app/douyin-marketing-calendar-api.md) |
| Xingtu video report: plays and completion rate | Get Xingtu's report on one Douyin video by ID or link. | `douyin.kol_video_report` | 3 | [Douyin Xingtu video report: plays and completion rate API](https://socialtoai.app/douyin-kol-video-report-api.md) |

### Keywords and indexes

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Trend-index brand comparison | Get the daily averages of a brand's search, content and spread indexes on Douyin over a date range, from the platform's own index tool, with the averages of every brand in its industry and of the industry's top 3, 5, 10, 15 and 30 to hold them against. | `douyin.brand_radar` | 2 | [Douyin trend-index brand comparison API](https://socialtoai.app/douyin-brand-radar-api.md) |
| Trend-index keyword audience | Get who is behind a keyword on Douyin over a date range, from the platform's own keyword tool. | `douyin.keyword_audience` | 2 | [Douyin trend-index keyword audience API](https://socialtoai.app/douyin-keyword-audience-api.md) |
| Trend-index keyword trends | Get the day-by-day search index and composite index of a keyword, or of one to five keywords at once, on Douyin over a date range, from 巨量算数 (the Douyin index), with the daily averages of the period, of the one before and of a year earlier. | `douyin.keyword_history` | 4 | [Douyin trend-index keyword trends API](https://socialtoai.app/douyin-keyword-history-api.md) |
| Trend-index brand trends | Get a brand's day-by-day search, content and spread indexes on Douyin over a date range, from the platform's own index tool. | `douyin.brand_history` | 2 | [Douyin trend-index brand trends API](https://socialtoai.app/douyin-brand-history-api.md) |
| Trend-index related keywords | Get the keywords related to a keyword on Douyin in one week, from the platform's own keyword tool. | `douyin.keyword_related` | 2 | [Douyin trend-index related keywords API](https://socialtoai.app/douyin-keyword-related-api.md) |
| Trend-index keyword hot videos | Get the roughly 20 high-index videos Douyin's index tool puts forward for a keyword. | `douyin.keyword_videos` | 2 | [Douyin trend-index keyword hot videos API](https://socialtoai.app/douyin-keyword-videos-api.md) |
| Trend-index live hot topics | Get the live topic board or the fastest-rising topic board of Douyin's index tool, about 30 entries each. | `douyin.index_topics` | 2 | [Douyin trend-index live hot topics API](https://socialtoai.app/douyin-index-topics-api.md) |

### Content and accounts

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Video play count | Get a Douyin video's counts as of now, by its ID. | `douyin.video_stats` | 2 | [Douyin video play count API](https://socialtoai.app/douyin-video-stats-api.md) |
| Related videos | Get the batch of videos Douyin recommends beside a video, by its ID. | `douyin.related_videos` | 2 | [Douyin related videos API](https://socialtoai.app/douyin-related-videos-api.md) |
| Hashtag videos | Get a page of Douyin videos under a hashtag, by the hashtag's ID, in the platform's order, most liked first or newest first. | `douyin.hashtag_videos` | 2 | [Douyin hashtag videos API](https://socialtoai.app/douyin-hashtag-videos-api.md) |
| Search suggestions | Get the suggestions Douyin's search box lists as a keyword is typed into it (autocomplete), in the order it lists them, about 10 at a time. | `douyin.search_suggestions` | 12 | [Douyin search suggestions API](https://socialtoai.app/douyin-search-suggestions-api.md) |

## Fields Douyin cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `author.verified` | search, detail, user_posts |
| `metrics.views` | search, detail, user_posts |
| `metrics.reposts` | search, detail, user_posts |
| `is_pinned` | search, detail |
| `url` | trending, comments |
| `author.followers` | detail, user_posts |

## What a whole job costs

| The job | How it adds up | Credits | About |
| --- | --- | --- | --- |
| Search 1,000 results on Douyin | usually 8 a page, 125 pages | 1,500 credits | about $5.00 |
| Read 1,000 Douyin comments | usually 20 a page, 50 pages | 100 credits | about $0.33 |
| Backfill one Douyin account: a list of 200 videos and 20 in full | 10 list pages + 20 full reads | 60 credits | about $0.20 |
| Watch 1 Douyin account daily, at most a month | 10 credits × 31 days | 310 credits | about $1.03 |

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

## Ask in your AI

- Which is bigger on Douyin this week: home coffee or matcha? → search, search: 24 credits

- Read the comments on this Douyin video and tell me what people complain about. → detail, comments × 3: 8 credits

- Find five Douyin accounts that post about camping coffee and show me what they posted lately. → search, user_posts × 5: 12 credits

[Douyin MCP Server](https://socialtoai.app/mcp/douyin.md)

## Ready-made tools that read Douyin

- [Brand buzz](https://socialtoai.app/tools/brand-buzz.md): How people feel about it on each platform, what comes up most, and the posts behind it
- [Comment analysis](https://socialtoai.app/tools/comment-insights.md): The topics in their comments and how big each is, plus questions, buying intent and complaints
- [Account snapshot](https://socialtoai.app/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Find creators](https://socialtoai.app/tools/find-creators.md): Creators who make that content, with their size, recent posts and how well each fits
- [Creator profile](https://socialtoai.app/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.app/tools/batch-stats.md): One row per link with its numbers as they are now. Links that no longer work are marked
- [Viral finder](https://socialtoai.app/tools/viral-finder.md): Posts that did clearly better than their authors usually do

## Official API

Douyin's open platform provides video data for users who authorise the app: the video list endpoint needs the user's authorisation and a permission applied for in the developer console. No endpoint for reading any public video or profile is documented.

Source: [Douyin's developer documentation](https://open.douyin.com/platform/resource/docs/openapi/video-management/douyin/search-video/account-video-list), checked 2026-10-17.

1,000 videos here: about 125 `douyin.search` calls (typically 8 a page), 1,500 credits, $5.00 at the first pack. [Estimate your cost](https://socialtoai.app/free-tools/api-cost-estimator.md)

[Douyin official API: access, prices and limits](https://socialtoai.app/does-douyin-have-an-api.md)

- [Every Douyin trend-index API](https://socialtoai.app/douyin-trend-index-api.md): Keywords, brands, creators and topics: all 10 on one page.
- [Comments API, every platform](https://socialtoai.app/comments-api.md): Which platforms give comments, how many a page, at what price.
- [Creator data API, every platform](https://socialtoai.app/creator-api.md): Finding creators and reading their data, platform by platform.
- [How to let Claude read Douyin comments](https://socialtoai.app/how-to/let-claude-read-douyin-comments.md): connect Claude to the comments under Douyin videos
- [Let Claude Code and Cursor read Xiaohongshu and Douyin, with no QR code or cookie](https://socialtoai.app/how-to/let-claude-code-and-cursor-read-xiaohongshu-and-douyin.md): connect Claude Code and Cursor to Xiaohongshu and Douyin with no QR code or cookie, and what a self-run server costs you
- [How brands outside China monitor Xiaohongshu (RedNote), Douyin and Weibo with AI](https://socialtoai.app/how-to/monitor-xiaohongshu-douyin-weibo-from-outside-china.md): monitor Xiaohongshu, Douyin and Weibo from outside China with AI, in English, with original links
- [How to analyze video comments with AI, and keep the original words](https://socialtoai.app/how-to/analyze-comments-with-quotes.md): what comments say, with original words: the tool or your AI, price per platform, a recorded answer
- [How to get the numbers for hundreds of post links at once](https://socialtoai.app/how-to/check-stats-for-many-links.md): the numbers of hundreds of links in one job: prices per platform, what the free credits run, and what it stops for
- [How to find creators on Xiaohongshu PGY and Douyin Xingtu](https://socialtoai.app/how-to/find-creators-on-xiaohongshu-and-douyin.md): PGY and Xingtu by interface: how each search matches, the IDs they take, what a shortlist costs
- [Monitor competitors' accounts every day](https://socialtoai.app/monitors/competitors.md): competitors' accounts, daily: what is new and what beat their usual, from 9 credits an account
- [Monitor brand mentions every day, with the posts behind them](https://socialtoai.app/monitors/brand.md): a brand, daily, across platforms: attitudes and the posts behind them, from 16 credits a run
- [Can Claude read Douyin?](https://socialtoai.app/can-ai-read/claude-douyin.md): what Claude can and cannot read on Douyin, with sources and a real request
- [Can ChatGPT read Douyin?](https://socialtoai.app/can-ai-read/chatgpt-douyin.md): what ChatGPT can and cannot read on Douyin, with sources and a real request
- [Can Doubao read Xiaohongshu, Douyin and WeChat articles?](https://socialtoai.app/can-ai-read/doubao.md): the Doubao app and Doubao's models on Volcano Ark: what can reach these platforms, with sources
- [What is a Douyin sec_uid, and how do I get it?](https://socialtoai.app/can-ai-read/douyin-sec-uid.md): where a sec_uid is, how to get it from a share link, and the two IDs it is confused with
- [How do I get data out of Douyin's trend index (巨量算数)?](https://socialtoai.app/can-ai-read/douyin-trend-index.md): the website or the interfaces: which suits what, and a real request
- [Douyin trending today](https://socialtoai.app/trending/douyin.md): Today's board in one list, refreshed daily.
- [Douyin MCP server](https://socialtoai.app/mcp/douyin.md): Let your AI read Douyin.
