Track what Douyin videos say about your brand or product
Search Douyin by brand name, product or hashtag and get matching videos as JSON, newest or most liked first, to follow how China talks about you.
If your brand, product or competitor is talked about in China, much of it happens in short videos on Douyin, and the in-app search shows you a few screens of it. You cannot filter, export or compare week over week. Lovely Router runs the search for you. Send keywords, get one JSON object per video, pay per video from a prepaid balance. Call it from a scheduled job, a dashboard or an AI agent with one API key.
Hand it to your AI agent
Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.
Track what Douyin videos say about your brand or product. Use the Lovely Router data tools: each returns JSON and is billed per result.
- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.
My task: <the inputs (links, keywords or accounts) and how many results you need>How it works
Choose your keywords
Brand names in Chinese and English, product names, hashtags, and the names of competitors you want to compare against.
Run the tool with a cap
Send the keywords to
POST /v1/tools/douyin-search/runwithmaxResultsPerQueryandmax_results. The run holds its maximum cost from your balance and returns the videos as JSON.Read and compare
Store each run with a date. Count new videos per keyword, read the most liked, and flag any that need a response.
Search Douyin with one request
Search Douyin videos takes keywords. Each keyword is searched on its own, sort accepts general, most_liked or latest, and publishTime accepts unlimited, one_day, one_week or half_year:
curl https://lovelyrouter.com/v1/tools/douyin-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"keywords": ["咖啡"],
"maxResultsPerQuery": 50,
"sort": "latest",
"publishTime": "one_week"
},
"max_results": 50
}'Duplicates across keywords are removed. A run still going after 60 seconds returns 202; Run a tool shows how to poll.
What each video holds
| Field group | What you get |
|---|---|
| Result | A Douyin video that matches the keyword |
The data file for this tool describes the result only as Douyin videos for keywords, so inspect one result to see the exact fields before you build on it. For the full caption, stats and stream links of a video you have found, run it through douyin-video.
Recipes
Search your brand names with publishTime set to one_week and sort set to latest, store the links, and review only the ones you have not seen.
Search with sort set to most_liked to see which videos shape how people think of your category.
Send your brand and two competitors as separate keywords in one run and compare how many videos each gets.
Search the Chinese terms shoppers use for your product, then ask a model to summarize recurring themes from the titles.
Take the authors of the best videos for a hashtag and add them to a list for outreach.
Prefer plain words? Connect the MCP server and tell Claude Code or Cursor: "Search Douyin for these 5 brand names from brands.txt, newest first from the last week, and list the videos with title and link. Set max_results to 100."
Pair it with other Chinese sources
Douyin is one place people talk. Add the others for a full picture:
Douyin videos for keywords.
Douyin videos by link: caption, title, date, plays, likes, comments, shares, hashtags, music, author, and the video and audio stream links.
Recent posts (videos and image posts) from Douyin creator profiles: caption, date, plays, likes, comments, shares, music, author stats.
Xiaohongshu (RED) notes for a keyword.
Weibo posts for a keyword.
douyin-videoturns a video link into full stats, hashtags and stream links.douyin-profileshows everything a creator you found has posted lately.xiaohongshu-searchcovers Xiaohongshu notes on the same keywords.weibo-searchcovers Weibo posts on the same keywords.
For the general workflow, see social listening and Chinese social media data.
What you pay
You pay per video: starting a run holds its maximum cost, the per-call fee plus the per-video fee times max_results, and the run settles to what it returned. The rest of the hold goes back to your balance. A run that fails or times out pays only for the videos it delivered, and a run refused at the start costs nothing.
Five keywords at 20 videos each is billed as 100 videos. There is no subscription and no monthly minimum: top up from $5, and one balance pays for tools and models. The card above shows today's price; pricing lists every tool.
Frequently asked questions
Can I search in English?+
Yes. The tool accepts Chinese, English, hashtags, brand names and emoji as keywords. Chinese terms usually find more of what Chinese viewers watch.
How many videos can one run return?+
Up to 100 videos per run. maxResultsPerQuery is how many to fetch for each keyword, so cost grows with it.
Can I get only recent videos?+
Yes. Set publishTime to one_day, one_week or half_year, and sort to latest to put the newest first.
Do I need a Douyin account?+
No. You send keywords and an API key. Nothing about the Chinese site is on your side.
Do I need a subscription?+
No. You add credit to a prepaid balance and each run draws it down. Failed runs pay only for the results they delivered, and nothing renews automatically.
Monitoring more than Douyin? See social listening, and the rest of the tool catalog.