自社のブランドや製品、競合が中国で話題になっているなら、その多くは Douyin の短尺動画の中で起きています。ただしアプリ内検索で見られるのは数画面分だけで、絞り込みも書き出しも週ごとの比較もできません。Lovely Router が代わりに検索を実行します。キーワードを送ると動画 1 本につき 1 つの JSON オブジェクトが返り、料金はプリペイド残高から動画 1 本ごとに支払います。スケジュール実行のジョブ、ダッシュボード、AI エージェントのどこからでも、1 つの API キーで呼び出せます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Douyin の動画で自社ブランドや製品がどう語られているか追跡する. 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>仕組み
キーワードを選ぶ
中国語と英語のブランド名、製品名、ハッシュタグ、比較したい競合の名前などです。
上限を付けてツールを実行する
キーワードを
maxResultsPerQueryとmax_resultsと一緒にPOST /v1/tools/douyin-search/runに送ります。実行は最大費用を残高から仮押さえし、動画を JSON で返します。読んで比較する
各実行を日付付きで保存します。キーワードごとの新着動画の数を数え、いいねの多い動画を読み、対応が必要なものに印を付けます。
1 回のリクエストで Douyin を検索する
Douyin 動画を検索は keywords を受け取ります。各キーワードは個別に検索されます。sort には general、most_liked、latest を、publishTime には unlimited、one_day、one_week、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
}'キーワード間で重複した動画は取り除かれます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。
動画ごとに得られる内容
| フィールドのグループ | 得られる内容 |
|---|---|
| 結果 | キーワードに一致する Douyin の動画 |
このツールのデータファイルでは、結果は「キーワードに対する Douyin の動画」としか説明されていません。そのため、実装を組む前に結果を 1 件確認して、正確なフィールドを見てください。見つけた動画の全文キャプション、統計、ストリームリンクが必要な場合は、douyin-video で読み取ります。
レシピ
publishTime を one_week、sort を latest にして自社ブランド名を検索し、リンクを保存して、まだ見ていないものだけを確認します。
sort を most_liked にして検索し、あなたのカテゴリのイメージを形作っている動画を把握します。
自社ブランドと競合 2 社を別々のキーワードとして 1 回の実行で送り、それぞれの動画数を比べます。
消費者があなたの製品に使う中国語の表現で検索し、モデルにタイトルから繰り返し現れるテーマを要約してもらいます。
あるハッシュタグで人気の動画の投稿者を、アウトリーチ用のリストに加えます。
普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「brands.txt にある 5 つのブランド名を Douyin で検索し、直近 1 週間の新着順で、動画のタイトルとリンクを一覧にしてください。max_results は 100 に設定してください。」
ほかの中国のソースと組み合わせる
Douyin は人々が語り合う場所のひとつにすぎません。ほかのソースも加えると全体像が見えてきます。
キーワードで Douyin（抖音）の動画を取得。
リンクから抖音の動画を取得：キャプション、タイトル、日付、再生数、いいね、コメント、シェア、ハッシュタグ、音楽、作者、動画・音声のリンク。
抖音（Douyin）クリエイターのプロフィールの最新投稿（動画・画像投稿）：キャプション、日付、再生数、いいね、コメント、シェア、音楽、作者データ。
キーワードで小紅書（RED）のノートを取得。
キーワードで Weibo（微博）の投稿を取得。
douyin-videoは、動画リンクから全統計、ハッシュタグ、ストリームリンクを取得します。douyin-profileは、見つけたクリエイターが最近投稿したものをすべて示します。xiaohongshu-searchは、同じキーワードの Xiaohongshu(小红书)のノートを対象にします。weibo-searchは、同じキーワードの Weibo(微博)の投稿を対象にします。
一般的なワークフローについては、ソーシャルリスニングと中国のソーシャルメディアデータをご覧ください。
料金
料金は結果単位で、動画 1 本ごとにかかります。実行を開始すると最大費用(呼び出し料金 + 動画単価 × max_results)が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返した動画の分だけを支払い、開始時に拒否された実行は無料です。
5 つのキーワードで各 20 本の動画を取得すると、動画 100 本分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。
よくある質問
英語で検索できますか？+
はい。キーワードには中国語、英語、ハッシュタグ、ブランド名、絵文字を使えます。中国語の語句のほうが、中国の視聴者が見ているものを多く拾えることが一般的です。
1 回の実行で何本の動画を返せますか？+
1 回の実行で最大 100 本です。maxResultsPerQuery は各キーワードで取得する本数で、これに比例して費用が増えます。
最近の動画だけを取得できますか？+
はい。publishTime を one_day、one_week、half_year のいずれかにし、sort を latest にすると新しいものから順に並びます。
Douyin のアカウントは必要ですか？+
いいえ。送るのはキーワードと API キーだけです。中国のサイトに関する作業はこちら側に一切ありません。
サブスクリプションは必要ですか？+
いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。
Douyin 以外もモニタリングしたいならソーシャルリスニングを、そのほかのツールはツールカタログをご覧ください。