SocialToAIStart freeConsole

Douyin API

Videos, comments, accounts, trends.

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.

6 of 6actions available
From 2 creditsper call
94% fewer tokensfor your AI than the raw JSON (33 interfaces measured)

Last tested: Last updated:

POST/v1/search200 OK12 credits
platform: "douyin" · query: "露营"
@…·2,525 followers·
likes 96,505comments 2,219shares 60,467collects 7,038views null
Always null here:author.verifiedmetrics.viewsmetrics.repostsis_pinned
pageNext pagecursor
billingThis call12 credits
Sample data1 of the 7 items recorded

6 actions.
Plus 26 only Douyin has.

Open a row to see its request. Its full parameters and response fields are on its own page.

ActionsCredits per call
SearchFind videos by keyword: text, author, likes, comment count and publish time./v1/search12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)
You send
platformquery+2 optional
type=useraccounts instead of posts2 credits
Douyin Search API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
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": "露营"  }'
POST /v1/searchYour key goes in the Authorization header
TrendingWhat is trending now: title, rank and heat./v1/trending2 credits≈ $0.0067$0.13 per 1,000 (up to 51 a page)
You send
platform+1 optional
type=videosthe trending videos board2 credits
Douyin Trending API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/trending \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "douyin"  }'
POST /v1/trendingYour key goes in the Authorization header
DetailOne video by ID or link: text, author, likes, comment count and publish time./v1/detail2 credits≈ $0.0067
You send
platformid or url
Douyin Detail API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "douyin",    "id": "7694940173372575014"  }'
POST /v1/detailYour key goes in the Authorization header
CommentsThe comments under one video: text, likes, reply count and time./v1/comments2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
You send
platformid or url
reply_ofthe replies under one comment2 credits
Douyin Comments API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/comments \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "douyin",    "id": "7694940173372575014"  }'
POST /v1/commentsYour key goes in the Authorization header
User ProfileOne account: name, bio, followers, following and post count./v1/user_profile2 credits≈ $0.0067
You send
platformid or url
Douyin User Profile API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "douyin",    "id": "MS4wLjABAAAAZ0aPDJzFhBrs0q3wVsp2a9WWrBuAUMsVyygoaO0bCw8"  }'
POST /v1/user_profileYour key goes in the Authorization header
User PostsThe recent videos of one account./v1/user_posts2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
You send
platformid or url
Douyin User Posts API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "douyin",    "id": "MS4wLjABAAAAZ0aPDJzFhBrs0q3wVsp2a9WWrBuAUMsVyygoaO0bCw8"  }'
POST /v1/user_postsYour key goes in the Authorization header

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

Only on Douyin · CreatorsCredits per call
Xingtu creator searchSearch 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_search3 credits≈ $0.01$0.50 per 1,000 (up to 20 a page)

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; under extra also what an integrated and a custom video cost, expected CPMs (in yuan), expected views, the last 30 days' interaction and completion ratios and median views, the e-commerce level, gender and content labels. The creator ID the other Xingtu endpoints take comes from here.

query+6 optional
Douyin KOL search API (Xingtu): All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_search \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "query": "美食"  }'
POST /v1/call/douyin.kol_searchYour key goes in the Authorization header
Xingtu creator profileGet a Douyin creator's profile on Xingtu by Xingtu creator ID.douyin.kol_profile3 credits≈ $0.01

Get a Douyin creator's profile on Xingtu by Xingtu creator ID: name, location, content categories, followers, gender.

id
Douyin KOL profile API (Xingtu): All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_profile \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'
POST /v1/call/douyin.kol_profileYour key goes in the Authorization header
Xingtu creator audienceGet who follows a Douyin creator, by Xingtu creator ID.douyin.kol_audience3 credits≈ $0.01

Get who follows a Douyin creator, by Xingtu creator ID: followers and share in each segment by gender, age, province, city, city tier, interest, device, consumer group, purchase category and purchase amount.

id
Douyin KOL audience API (Xingtu): All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_audience \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'
POST /v1/call/douyin.kol_audienceYour key goes in the Authorization header
Xingtu creator metricsGet how a Douyin creator's videos did over the last 30 or 90 days, by Xingtu creator ID.douyin.kol_performance3 credits≈ $0.01

Get how a Douyin creator's videos did over the last 30 or 90 days, by Xingtu creator ID: videos, median views, average likes, comments and shares, engagement and completion ratios, expected cost per thousand views and per interaction (in yuan). The figures are of all the videos: the platform gives none for the sponsored ones alone. The completion rate counts only videos of a Xingtu creator published about 2023 or later: without them it may be null, and 0 may mean there is none.

id+1 optional
Douyin KOL metrics API (Xingtu): All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_performance \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'
POST /v1/call/douyin.kol_performanceYour key goes in the Authorization header
Creator engagement and follower trendsGet 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_history2 credits≈ $0.0067

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: net new followers, new likes, comments, shares and posts, each as a ratio against the period before, and the totals now. It is one period's sum, not a day-by-day series.

id+1 optional
Douyin creator engagement and follower trends API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.account_history \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "66598046050"  }'
POST /v1/call/douyin.account_historyYour key goes in the Authorization header
Xingtu creator rate cardGet what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled.douyin.kol_rates24 credits≈ $0.08

Get what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled.

id
Douyin KOL rate card API (Xingtu): All parameters and response fields
Sign in to run24 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_rates \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6629656444889202692"  }'
POST /v1/call/douyin.kol_ratesYour key goes in the Authorization header
Xingtu creator video performanceGet a page of a Douyin creator's videos by Xingtu creator ID, newest first, with the figures Xingtu gives for each.douyin.kol_videos3 credits≈ $0.01$0.50 per 1,000 (up to 20 a page)

Get a page of a Douyin creator's videos by Xingtu creator ID, newest first, with the figures Xingtu gives for each: views, likes, completion and engagement ratios, length. Sponsored and everyday videos come together: the platform neither marks which are sponsored nor gives the sponsored ones alone. A completion rate is had only of a video by a Xingtu creator, published about 2023 or later: without one it may be null, and 0 may mean there is none.

id
Douyin KOL video performance API (Xingtu): All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_videos \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'
POST /v1/call/douyin.kol_videosYour key goes in the Authorization header
Trend-index creator top videosGet 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_videos2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)

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: up to twenty, most liked first, each with caption, link, day published, its engagement counts and followers gained. As recorded, the tool picks from what was published on the last day or two of the span, not from all of it: set the end date to the day you want. One page; no view counts.

idsinceuntil
Douyin trend-index creator top videos API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.account_top_videos \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "66598046050",    "since": "2026-09-01T00:00:00Z",    "until": "2026-09-30T00:00:00Z"  }'
POST /v1/call/douyin.account_top_videosYour key goes in the Authorization header
Trend-index creator follower profileGet who follows a Douyin account from the platform's own index tool, by the account's numeric ID.douyin.account_audience2 credits≈ $0.0067

Get who follows a Douyin account from the platform's own index tool, by the account's numeric ID: the share of each segment by gender, age, province, city, city tier, phone brand and interest. Not limited to marketplace creators; shares only, no head counts.

id
Douyin trend-index creator follower profile API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.account_audience \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "66598046050"  }'
POST /v1/call/douyin.account_audienceYour key goes in the Authorization header
Trend-index creator core metricsGet a Douyin creator's core figures from the platform's own index tool, by the account's numeric ID.douyin.account_metrics2 credits≈ $0.0067

Get a Douyin creator's core figures from the platform's own index tool, by the account's numeric ID: new likes, shares and comments a day and the tool's own count of follows a day, on average over the last week and the last month, each as a ratio against the period before. The follows are not the net gain in followers, and come out larger. An account the tool has nothing on (every figure 0) is answered as not found.

id
Douyin trend-index creator core metrics API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.account_metrics \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "66598046050"  }'
POST /v1/call/douyin.account_metricsYour key goes in the Authorization header
Xingtu creator content keywordsGet the words Xingtu takes from a few of a Douyin creator's recent videos, by Xingtu creator ID.douyin.kol_keywords2 credits≈ $0.0067

Get the words Xingtu takes from a few of a Douyin creator's recent videos, by Xingtu creator ID: about twenty, each with how many times it was counted (usually single digits). They often come from one or two videos, which may be a sponsored one: a news outlet's account was found to return nothing but skincare words. They do not stand for the creator's content as a whole; for that, use the Xingtu content mix endpoint.

id
Douyin KOL content keywords API (Xingtu): All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_keywords \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'
POST /v1/call/douyin.kol_keywordsYour key goes in the Authorization header
Xingtu creator index scoresGet the six scores Xingtu gives a Douyin creator, by Xingtu creator ID.douyin.kol_scores5 credits≈ $0.017

Get the six scores Xingtu gives a Douyin creator, by Xingtu creator ID: the overall Xingtu score and those for reach, seeding, conversion, cooperation and value for money, each with the score, the average of comparable creators, the rank and how far from the top that rank is.

id
Douyin KOL index scores API (Xingtu): All parameters and response fields
Sign in to run5 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_scores \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'
POST /v1/call/douyin.kol_scoresYour key goes in the Authorization header
Xingtu creator content mixGet what a Douyin creator's recent videos are about, by Xingtu creator ID.douyin.kol_content_mix3 credits≈ $0.01

Get what a Douyin creator's recent videos are about, by Xingtu creator ID: the number of videos in each of the marketplace's content categories and their share. It shows whether the creator keeps to one subject.

id
Douyin KOL content mix API (Xingtu): All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_content_mix \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'
POST /v1/call/douyin.kol_content_mixYour key goes in the Authorization header
Xingtu marketing calendarGet the campaigns on Xingtu's marketing calendar over a span of time.douyin.marketing_calendar3 credits≈ $0.01$0.05 per 1,000 (up to 200 a page)

Get the campaigns on Xingtu's marketing calendar over a span of time: platform events, e-commerce and seasonal moments, creative and industry campaigns, each with its name, description, kind, stage, sign-up period and running period. All at once, no paging.

sinceuntil
Douyin Xingtu marketing calendar API: All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.marketing_calendar \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "since": "2026-10-01T00:00:00Z",    "until": "2026-12-31T23:59:59Z"  }'
POST /v1/call/douyin.marketing_calendarYour key goes in the Authorization header
Xingtu video report: plays and completion rateGet Xingtu's report on one Douyin video by ID or link.douyin.kol_video_report3 credits≈ $0.01

Get Xingtu's report on one Douyin video by ID or link: plays and engagement counts, plus the completion rate, interaction rate, length, the author's followers and the author's Xingtu creator ID (to look up the creator's rates and metrics next). Only for videos Xingtu covers (mostly its creators'). A completion rate is had only of a video by a Xingtu creator, published about 2023 or later; without one the field is null.

id or url
Douyin Xingtu video report: plays and completion rate API: All parameters and response fields
Sign in to run3 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.kol_video_report \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "7667629259711844858"  }'
POST /v1/call/douyin.kol_video_reportYour key goes in the Authorization header
Only on Douyin · Keywords and indexesCredits per call
Trend-index brand comparisonGet 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_radar2 credits≈ $0.0067

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. An index is the platform's score, not a count.

brandsinceuntil
Douyin trend-index brand comparison API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.brand_radar \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "brand": "泡泡玛特",    "since": "2026-09-01T00:00:00Z",    "until": "2026-09-30T00:00:00Z"  }'
POST /v1/call/douyin.brand_radarYour key goes in the Authorization header
Trend-index keyword audienceGet who is behind a keyword on Douyin over a date range, from the platform's own keyword tool.douyin.keyword_audience2 credits≈ $0.0067

Get who is behind a keyword on Douyin over a date range, from the platform's own keyword tool: the share and TGI of each age group, gender, province, city, city tier and interest.

keywordsinceuntil
Douyin trend-index keyword audience API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.keyword_audience \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "keyword": "咖啡",    "since": "2026-09-01T00:00:00Z",    "until": "2026-09-30T00:00:00Z"  }'
POST /v1/call/douyin.keyword_audienceYour key goes in the Authorization header
Trend-index keyword trendsGet 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_history4 credits≈ $0.013$2.67 per 1,000 (up to 5 a page)

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. An index is the platform's score of volume, not a count of searches; days are calendar days in China time (UTC+8).

sinceuntilkeyword or keywords
Douyin trend-index keyword trends API: All parameters and response fields
Sign in to run4 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.keyword_history \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "since": "2026-09-01T00:00:00Z",    "until": "2026-09-30T00:00:00Z",    "keyword": "咖啡"  }'
POST /v1/call/douyin.keyword_historyYour key goes in the Authorization header
Trend-index brand trendsGet 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_history2 credits≈ $0.0067

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. An index is the platform's score, not a count; days are calendar days in China time (UTC+8).

brandsinceuntil
Douyin trend-index brand trends API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.brand_history \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "brand": "泡泡玛特",    "since": "2026-09-01T00:00:00Z",    "until": "2026-09-30T00:00:00Z"  }'
POST /v1/call/douyin.brand_historyYour key goes in the Authorization header
Trend-index related keywordsGet the keywords related to a keyword on Douyin in one week, from the platform's own keyword tool.douyin.keyword_related2 credits≈ $0.0067$0.027 per 1,000 (up to 250 a page)

Get the keywords related to a keyword on Douyin in one week, from the platform's own keyword tool: those searched together with it and those that appear with it in content, each with its relevance, its place by relevance, its search index and its composite index. An index is the platform's score of volume, not a count of searches.

keyworduntil
Douyin trend-index related keywords API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.keyword_related \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "keyword": "露营",    "until": "2026-10-04T00:00:00Z"  }'
POST /v1/call/douyin.keyword_relatedYour key goes in the Authorization header
Trend-index keyword hot videosGet the roughly 20 high-index videos Douyin's index tool puts forward for a keyword.douyin.keyword_videos2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)

Get the roughly 20 high-index videos Douyin's index tool puts forward for a keyword: caption, link, author's display name, likes, video index and category. One page only; the author's ID and the publication time are not given, the video endpoint has them.

query
Douyin trend-index keyword hot videos API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.keyword_videos \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "query": "露营"  }'
POST /v1/call/douyin.keyword_videosYour key goes in the Authorization header
Trend-index live hot topicsGet the live topic board or the fastest-rising topic board of Douyin's index tool, about 30 entries each.douyin.index_topics2 credits≈ $0.0067$0.13 per 1,000 (up to 50 a page)

Get the live topic board or the fastest-rising topic board of Douyin's index tool, about 30 entries each: place, name, topic index, number of related videos, their plays and a category. The topic index is the platform's score of heat, not a count of searches.

No parameters+1 optional
Douyin trend-index live hot topics API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.index_topics \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{  }'
POST /v1/call/douyin.index_topicsYour key goes in the Authorization header
Only on Douyin · Content and accountsCredits per call
Video play countGet a Douyin video's counts as of now, by its ID.douyin.video_stats2 credits≈ $0.0067

Get a Douyin video's counts as of now, by its ID: plays and likes.

id or url
Douyin video play count API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.video_stats \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "7694940173372575014"  }'
POST /v1/call/douyin.video_statsYour key goes in the Authorization header
Related videosGet the batch of videos Douyin recommends beside a video, by its ID.douyin.related_videos2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)

Get the batch of videos Douyin recommends beside a video, by its ID: caption, author, engagement counts. The recommendations may differ from call to call.

id
Douyin related videos API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.related_videos \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "7694940173372575014"  }'
POST /v1/call/douyin.related_videosYour key goes in the Authorization header
Hashtag videosGet 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_videos2 credits≈ $0.0067$0.67 per 1,000 (up to 10 a page)

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: caption, author, engagement counts, time posted.

id+1 optional
Douyin hashtag videos API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.hashtag_videos \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "id": "7495235888088090635"  }'
POST /v1/call/douyin.hashtag_videosYour key goes in the Authorization header
Search suggestionsGet 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_suggestions12 credits≈ $0.04$2.00 per 1,000 (up to 20 a page)

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. The words and their places only, with no index.

keyword
Douyin search suggestions API: All parameters and response fields
Sign in to run12 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/call/douyin.search_suggestions \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "keyword": "露营"  }'
POST /v1/call/douyin.search_suggestionsYour key goes in the Authorization header

What a whole job costs.

The jobHow it adds upCreditsAbout
Search 1,000 results on Douyinusually 8 a page, 125 pages1,500 creditsabout $5.00
Read 1,000 Douyin commentsusually 20 a page, 50 pages100 creditsabout $0.33
Backfill one Douyin account: a list of 200 videos and 20 in full10 list pages + 20 full reads60 creditsabout $0.20
Watch 1 Douyin account daily, at most a month10 credits × 31 days310 creditsabout $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.

Or skip the parameters.
Just ask.

Connect SocialToAI once over MCP. Your AI picks the calls, and you see what each one cost.

You ask01

Which is bigger on Douyin this week: home coffee or matcha?

Your AI calls
  • search“home coffee”12 credits
  • search“matcha”12 credits
Total24 credits
You ask02

Read the comments on this Douyin video and tell me what people complain about.

Your AI calls
  • detailthe video you pasted2 credits
  • commentsfirst 3 pages6 credits
Total8 credits
You ask03

Find five Douyin accounts that post about camping coffee and show me what they posted lately.

Your AI calls
  • searchaccounts · “camping coffee”2 credits
  • user_posts5 accounts10 credits
Total12 credits

Douyin MCP Server

Same shape on every platform.
Learn it once.

A Douyin video and a TikTok video come back with the same field names. What a platform cannot give comes back as null.

Douyindetail · 2 credits
{  "platform": "douyin",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "video",  "title": null,  "text": "…",  "published_at": "2026-10-10T07:37:57.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": null,    "followers": null  },  "metrics": {    "likes": 171024,    "comments": 111,    "shares": 6934,    "collects": 4762,    "views": null,    "reposts": null  },  "images": null,  "hashtags": [],  "is_pinned": null}
Null on Douyin:author.verifiedauthor.followersmetrics.viewsmetrics.repostsis_pinned
TikTokdetail · 2 credits
{  "platform": "tiktok",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "video",  "title": null,  "text": "…",  "published_at": "2026-10-08T13:12:22.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": null,    "followers": 2060936  },  "metrics": {    "likes": 67877,    "comments": 524,    "shares": 2472,    "collects": 5331,    "views": 449259,    "reposts": null  },  "images": null,  "hashtags": [],  "is_pinned": null}
Null on TikTok:titleauthor.verifiedmetrics.repostsimagesis_pinned
Sample dataThe fields are always there; only the values differ.

7 tools read Douyin.

All tools

Does Douyin have an 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, 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

Douyin official API: access, prices and limits

The same calls work on 17 more.

All platforms and prices

Your AI is one URL away
from all of social media.

100 credits on sign-up, no card needed