Douyin API: videos, comments, hot search, Xingtu creators
38 Douyin endpoints covering videos, accounts, hot lists, comments, hashtags, keywords, Xingtu and Ocean Engine index, from $0.002 a call. No Douyin account or cookie needed.
Connect your AI
Paste this into your agent
Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.
Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.
MCP serverhttps://api.okdata.online/mcp
Ask about Douyin from Claude, Cursor and other agents: the Douyin MCP page
- Endpoints
- 38 endpoints
- In 9 groups, one response format
- Lowest price
- From $0.002
- A call, paid from a prepaid balance
- Freshness
- Live
- Boards are a shared snapshot up to 10 minutes old
- Monthly fee
- $0
- No subscription or minimum spend
Every Douyin endpoint
One row per endpoint: the request, what comes back and what one call costs.
Videos
6- Video searchGET /v1/douyin/videos/searchPost[]$0.02
- Video detailGET /v1/douyin/videos/getPost$0.002
- Video commentsGET /v1/douyin/videos/comments/listComment[]$0.002
- Video play countGET /v1/douyin/videos/metricsPost$0.002
- Related videosGET /v1/douyin/videos/relatedPost[]$0.002
- Video boardsGET /v1/douyin/videos/trendingPost[]$0.002
Accounts
4Hot lists
1Comments
1Hashtags
1Keywords
1- Creator searchGET /v1/douyin/xingtu/creators/searchCreator[]$0.004
- Creator rate cardGET /v1/douyin/xingtu/creators/rates/getCreatorRate$0.04
- Creator profileGET /v1/douyin/xingtu/creators/getCreator$0.004
- Creator audienceGET /v1/douyin/xingtu/creators/audience/getAudience$0.004
- Creator reachGET /v1/douyin/xingtu/creators/metricsXingtuCreatorMetrics$0.004
- Creator videosGET /v1/douyin/xingtu/creators/videos/listXingtuCreatorPost[]$0.004
- Creator keywordsGET /v1/douyin/xingtu/creators/keywords/getXingtuCreatorKeywords$0.002
- Creator scoresGET /v1/douyin/xingtu/creators/scores/getXingtuCreatorScores$0.008
- Creator content mixGET /v1/douyin/xingtu/creators/content_mix/getXingtuCreatorContentMix$0.004
- Creator conversionGET /v1/douyin/xingtu/creators/conversion/getXingtuCreatorConversion$0.004
- Marketing calendarGET /v1/douyin/xingtu/campaigns/listXingtuCampaign[]$0.004
- Video reportGET /v1/douyin/xingtu/videos/getPost$0.004
- Brand trendsGET /v1/douyin/index/brands/historyBrandHistory$0.002
- Brand vs industryGET /v1/douyin/index/brands/metricsBrandMetrics$0.002
- Account top videosGET /v1/douyin/index/creators/videos/listPost[]$0.002
- Account followersGET /v1/douyin/index/creators/audience/getAudience$0.002
- Account daily averagesGET /v1/douyin/index/creators/metricsIndexCreatorMetrics$0.002
- Keyword audienceGET /v1/douyin/index/keywords/audience/getKeywordAudience$0.002
- Keyword trendsGET /v1/douyin/index/keywords/historyKeywordHistory[]$0.006
- Related keywordsGET /v1/douyin/index/keywords/relatedKeywordRelated[]$0.002
- Live hot topicsGET /v1/douyin/index/trends/listTrend[]$0.002
- Top videos for a keywordGET /v1/douyin/index/videos/searchPost[]$0.002
Backup routes
2Prices are per call unless marked /item. A call that reached the data source is charged even when it comes back empty or fails.
What people do with Douyin data
Each job has its own page with the endpoints it takes, a worked run and its cost.
Creator discovery
“Who are the mid-size creators in camping gear?”
- Account profile$0.002
- Xingtu creator search$0.004
- Xingtu creator rate card$0.04
16 endpoints here, from $0.002How it works
Competitor monitoring
“What did our competitors post this week, and what took off?”
- Video search$0.02
- Video detail$0.002
- Account profile$0.002
15 endpoints here, from $0.002How it works
Content research
“What do the top posts on this topic have in common?”
- Video search$0.02
- Video detail$0.002
- Hashtag videos$0.002
12 endpoints here, from $0.002How it works
Trend research
“What is trending today that we could ride?”
- Hot search board$0.002
- Hashtag videos$0.002
- Related videos$0.002
12 endpoints here, from $0.002How it works
Product research
“What do the best sellers cost, and what do buyers complain about?”
- Keyword audience$0.002
- Keyword trends$0.006
- Xingtu creator conversion$0.004
3 endpoints here, from $0.002How it works
Word of mouth
“What do buyers complain about most?”
- Video comments$0.002
- Comment replies$0.002
2 endpoints here, from $0.002How it works
Start in three steps
The example is Douyin video search; every Douyin endpoint is called the same way and answers in the same shape.
Get a key
Create an account and a key in the console. A new key comes with $0.10 to try, no card.
Connect your AI, or call it yourself
Paste this sentence into Claude Code, Cursor, Codex or another agent that can open a link, and it sets itself up. Or send the request below with your key in the Authorization header.
Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.
Swap the placeholder for your own key, or sign in and copy it with the key filled in.
Make the first call
Items arrive in data.items (one object in data.item), the next page in page.next_cursor and what you were charged in meta.billing.amount.
cURL
curl -G "https://api.okdata.online/v1/douyin/videos/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ --data-urlencode 'query=露营装备'Python
import os import requests resp = requests.get( "https://api.okdata.online/v1/douyin/videos/search", headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}, params={"query": "露营装备"}, timeout=60, ) body = resp.json() if body["code"] != "ok": raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})") for row in body["data"]["items"]: print(row["id"], row["metrics"]["likes"], row["text"][:60]) print("cost: $" + body["meta"]["billing"]["amount"])TypeScript
const url = new URL('https://api.okdata.online/v1/douyin/videos/search'); url.searchParams.set('query', "露营装备"); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.OKDATA_API_KEY}`, }, }); const body = await res.json(); if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`); for (const row of body.data.items) { console.log(row.id, row.metrics.likes, row.text.slice(0, 60)); } console.log('cost: $' + body.meta.billing.amount);MCPtools/call
{ "name": "call", "arguments": { "capability": "douyin.videos.search", "query": "露营装备" } }
Questions about the Douyin API
What does the Douyin API cost?
Each of the 38 endpoints has its own price, from $0.002 to $0.04 a call; the cheapest is Douyin comment replies at $0.002. You pay per call from a prepaid balance, with no subscription. A call that reaches the data source is charged even when it comes back empty, not found or failed; one stopped before that, such as for bad parameters, is free.
Do I need a Douyin account or cookie?
No. You call https://api.okdata.online with one okdata key and get public Douyin data back; no Douyin account, cookie or QR login is involved.
How fresh is the data?
Most endpoints read Douyin at the moment you call. Hot lists come from a shared snapshot that is at most 10 minutes old.
Can my AI agent use the Douyin API?
Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 38 endpoints with their prices, and its call tool runs them on your key.
Can I try it for free?
New accounts get $0.10 of trial credit with no card: enough for 50 calls to Douyin comment replies.
