Сценарий использования

Отслеживайте, что говорят о вашем бренде или товаре в видео Douyin

Ищите в Douyin по бренду, товару или хештегу и получайте подходящие видео в JSON — сначала новые или самые популярные, — чтобы знать, что о вас говорят в Китае.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Douyinlovelyjsonitems[0]"keyword": "咖啡""title": "三种手冲咖啡的区别""author": "coffee_lab""plays": 96000"likes": 5100"published": "one_week"

Если о вашем бренде, товаре или конкуренте говорят в Китае, то во многом это происходит в коротких видео в Douyin, а поиск в приложении показывает лишь несколько экранов результатов. Ни отфильтровать, ни выгрузить, ни сравнить неделю с неделей не получится. Lovely Router выполняет поиск за вас. Отправьте ключевые слова, получите по одному JSON-объекту на видео и платите за каждое видео с предоплаченного баланса. Вызывайте его из задачи по расписанию, дашборда или ИИ-агента с одним API-ключом.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в 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>
01

Как это работает

010203
  1. Выберите ключевые слова

    Названия бренда на китайском и английском, названия товаров, хештеги и названия конкурентов, с которыми вы хотите себя сравнить.

  2. Запустите инструмент с лимитом

    Отправьте ключевые слова на POST /v1/tools/douyin-search/run вместе с maxResultsPerQuery и max_results. Запуск резервирует на балансе свою максимальную стоимость и возвращает видео в JSON.

  3. Изучайте и сравнивайте

    Сохраняйте каждый запуск с датой. Считайте новые видео по каждому ключевому слову, смотрите самые популярные и отмечайте те, на которые нужно отреагировать.

02

Поиск в 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; как опрашивать его статус, описано в разделе Запуск инструмента.

03

Что содержит каждое видео

Группа полейЧто вы получаете
РезультатВидео Douyin, подходящее под ключевое слово

В описании данных этого инструмента результат обозначен лишь как видео Douyin по ключевым словам, поэтому, прежде чем строить на нём что-либо, посмотрите на один результат и уточните точный набор полей. Чтобы получить полную подпись, статистику и ссылки на поток найденного видео, пропустите его через douyin-video.

04

Рецепты

Еженедельный мониторинг бренда

Ищите названия своего бренда с publishTime, равным one_week, и sort, равным latest, сохраняйте ссылки и просматривайте только те, что ещё не видели.

Поиск вирусных видео

Ищите с sort, равным most_liked, чтобы увидеть, какие видео формируют представление людей о вашей категории.

Сравнение с конкурентами

Отправьте свой бренд и двух конкурентов отдельными ключевыми словами в одном запуске и сравните, сколько видео набирает каждый.

Проверка формулировок для товара

Ищите китайские термины, которыми покупатели называют ваш товар, а затем попросите модель обобщить повторяющиеся темы в заголовках.

Список авторов для сотрудничества

Возьмите авторов лучших видео по хештегу и добавьте их в список для аутрича.

Предпочитаете обычные слова? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди в Douyin видео по этим 5 названиям брендов из brands.txt, сначала новые, за последнюю неделю, и перечисли видео с заголовком и ссылкой. Задай max_results равным 100».

05

Дополните другими китайскими источниками

Douyin — лишь одна из площадок, где люди общаются. Добавьте остальные, чтобы увидеть полную картину:

  • douyin-video превращает ссылку на видео в полную статистику, хештеги и ссылки на поток.
  • douyin-profile показывает всё, что найденный вами автор недавно опубликовал.
  • xiaohongshu-search охватывает заметки Xiaohongshu по тем же ключевым словам.
  • weibo-search охватывает посты Weibo по тем же ключевым словам.

Общий порядок работы описан в разделах мониторинг соцсетей и данные китайских соцсетей.

06

Сколько это стоит

Вы платите за видео: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс цену за видео, умноженную на max_results, — а по завершении списывается сумма за фактически возвращённое. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только доставленные видео, а запуск, отклонённый на старте, ничего не стоит.

Пять ключевых слов по 20 видео оплачиваются как 100 видео. Нет ни подписки, ни ежемесячного минимума: пополнение от $5, и один баланс оплачивает и инструменты, и модели. Карточка выше показывает актуальную цену; на странице цен перечислены все инструменты.

07

Частые вопросы

?
Можно ли искать на английском?+

Да. Инструмент принимает в качестве ключевых слов китайский и английский текст, хештеги, названия брендов и эмодзи. Китайские термины обычно лучше находят то, что смотрят китайские зрители.

Сколько видео может вернуть один запуск?+

До 100 видео за запуск. maxResultsPerQuery задаёт, сколько видео получать по каждому ключевому слову, поэтому стоимость растёт вместе с ним.

Можно ли получать только недавние видео?+

Да. Задайте publishTime равным one_day, one_week или half_year, а sort — равным latest, чтобы самые новые шли первыми.

Нужен ли аккаунт Douyin?+

Нет. Вы отправляете ключевые слова и API-ключ. Ничего, связанного с китайским сайтом, на вашей стороне не требуется.

Нужна ли подписка?+

Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачивают только доставленные результаты, и ничего не продлевается автоматически.

Следите не только за Douyin? Смотрите мониторинг соцсетей и остальной каталог инструментов.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.