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

Вирусные видео TikTok по ключевому слову или хэштегу

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

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
TikToklovelyjsonitems[0]"caption": "Espresso at home with…"views": 2400000"likes": 310000"shares": 18400"author": "coffeewithmia""music": "original sound"

Прежде чем планировать видео в TikTok, кампанию или тест продукта, нужно знать, что уже работает в вашей нише. Поиск TikTok показывает лишь горстку видео за раз и не позволяет их выгрузить или отранжировать. Lovely Router выполняет поиск за вас. Отправьте ключевые слова или хэштеги, получите по одному JSON-объекту на видео с подписью, просмотрами, лайками, репостами, автором и музыкой и платите за каждое видео с предоплаченного баланса.

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

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Вирусные видео TikTok по ключевому слову или хэштегу. 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/tiktok-search/run с maxItems во входных данных и max_results в запросе. Задайте sortType, dateRange и location, чтобы сузить выборку.

  3. Отранжируйте и изучите лидеров

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

02

Поиск видео в TikTok одним запросом

Поиск видео в TikTok принимает keywords или ссылки TikTok в startUrls. sortType принимает RELEVANCE, MOST_LIKED или DATE_POSTED, а maxItems ограничивает число результатов:

curl https://lovelyrouter.com/v1/tools/tiktok-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "input": {
    "keywords": [
      "espresso"
    ],
    "maxItems": 10,
    "sortType": "RELEVANCE"
  },
  "max_results": 10
}'

Порядок сортировки применяется только к поиску по ключевым словам, но не к startUrls. Сначала сделайте запуск с небольшим лимитом, чтобы посмотреть, как выглядят результаты. Запуск, который всё ещё идёт через 60 секунд, возвращает 202; как опрашивать его, показано в разделе «Запустить инструмент».

03

Что есть в каждом видео

Группа полейЧто вы получаете
КонтентПодпись к видео
ВовлечённостьПросмотры, лайки и репосты
АвторАккаунт, опубликовавший видео
АудиоИспользованная музыка

dateRange принимает YESTERDAY, THIS_WEEK, THIS_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS, ALL_TIME или DEFAULT. location принимает двухбуквенный код страны.

04

Рецепты

Еженедельный список трендов

Ищите по своей категории с dateRange, равным THIS_WEEK, и sortType, равным MOST_LIKED. Сохраните 20 лучших подписей и звуков и каждый понедельник отправляйте список контент-команде.

Звуки, на которых держится ниша

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

Сравнение двух хэштегов

Запустите каждый хэштег с одинаковым лимитом и сравните медианные просмотры и репосты. Тот, у которого больше репостов, скорее будут передавать дальше.

Проверка рынка перед запуском

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

Шорт-лист авторов из результатов

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

Удобнее обычными словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди в TikTok видео про espresso, отсортированные по лайкам за этот месяц, и перечисли 25 лучших с подписью, просмотрами, репостами и использованным звуком. Задай max_results равным 25.»

05

Сочетайте с другими инструментами TikTok

Поиск находит видео. Эти инструменты объясняют, почему они работают:

  • tiktok-profile перечисляет видео аккаунта, найденного в результатах.
  • tiktok-comments показывает, что зрители написали под лучшим видео.
  • tiktok-transcript даёт сценарий видео, которое выстрелило.
  • youtube-shorts позволяет сравнить с короткими видео на YouTube.

Как выбирать авторов по найденному, описано в сценарии «Поиск инфлюенсеров».

06

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

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

Чтение 100 видео оплачивается как 100 видео. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает и инструменты, и модели. На карточке выше указана текущая цена; на странице «Цены» перечислены все инструменты.

07

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

?
Можно ли искать по хэштегу?+

Да. Передайте хэштег как ключевое слово или вставьте ссылку на тег TikTok в startUrls. Там поддерживаются ссылки на теги, пользователей, музыку, места и поиск.

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

Задайте dateRange. Он работает только для поиска по ключевым словам и принимает значения от YESTERDAY до LAST_SIX_MONTHS.

Можно ли искать из определённой страны?+

Во входных данных есть поле location, которое принимает двухбуквенный код страны. Тогда результаты будут из этого региона.

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

Лимит задаёт maxItems, а максимум инструмента — 500 видео за запуск.

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

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

Нужно больше? Смотрите остальной каталог инструментов и страницу «Цены».

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

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