Report on a Douyin campaign from a list of video links
Paste the Douyin video links from a campaign and get plays, likes, comments, shares, hashtags and music as JSON for a client or internal report.
You ran a campaign with Douyin creators and now someone wants numbers: plays, likes, comments and shares for each video, in one table. Creators send screenshots, the numbers change by the day, and copying them from the app is slow. Lovely Router reads each video by link. Send the links, get one JSON object per video, pay per video from a prepaid balance. Call it from a reporting script, a spreadsheet job 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.
Report on a Douyin campaign from a list of video links. 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
Collect the video links
Ask each creator for the link of their post, or copy the share link from the app.
Run the tool
Send the links to
POST /v1/tools/douyin-video/runwithmax_resultsset to the number of links. The run holds its maximum cost from your balance and returns the videos as JSON.Build the report
Put the stats in a table with the date of the run. Run again at day 3, 7 and 14 to chart how each video grows.
Get video stats with one request
Get Douyin video details takes links or video ids in videoUrls. One link is one video, and one run reads up to 50:
curl https://lovelyrouter.com/v1/tools/douyin-video/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"videoUrls": ["https://www.douyin.com/video/7577614489533680959"]
},
"max_results": 1
}'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 |
|---|---|
| Content | Caption, title and date |
| Engagement | Plays, likes, comments and shares |
| Tags | Hashtags |
| Sound | The music used |
| Author | The creator who posted it |
| Media | Links to the video and audio streams |
Text comes back as posted, in Chinese.
Recipes
Keep the list of campaign links, run it every Monday, and write the plays, likes, comments and shares to a sheet with the run date.
Join the plays of each video with the fee you paid that creator and rank them.
Compare the hashtags on each video with the ones in your brief and list which creators missed them.
Run the same links at day 1, 3 and 7 and chart plays per day to see whether a video still travels.
Send the table to a model and ask for a short English summary of what worked, with the Chinese captions translated.
Prefer plain words? Connect the MCP server and tell Claude Code or Cursor: "Read the Douyin links in campaign.txt, get the stats for each, and make a table of creator, plays, likes, comments and shares. Set max_results to 30."
Pair it with other Douyin sources
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.
Douyin videos for keywords.
A TikTok account's videos with the author's follower and like counts.
Xiaohongshu (RED) notes for a keyword.
douyin-profileshows a creator's other recent posts, to see whether the campaign video is typical.douyin-searchfinds videos about your campaign hashtag that you were not sent.tiktok-profilecovers creators who also post on TikTok.xiaohongshu-searchcovers the same campaign on Xiaohongshu.
For the wider workflow, see influencer research 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.
Checking 30 campaign videos each week is billed as 30 videos a week. 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
How many videos can one run read?+
Up to 50 links per run. For a longer list, start several runs.
+
Yes. videoUrls accepts Douyin video links, share links and video ids.
Does it download the video files?+
No. Downloads are switched off for this tool. The result includes links to the video and audio streams.
Do I need a Douyin account?+
No. You send links 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.
Running campaigns with creators? See influencer research, and the rest of the tool catalog.