Оцените тему на YouTube до того, как снимать видео
Ищите на YouTube по ключевым словам и получайте видео в JSON с просмотрами, лайками, комментариями, длительностью, каналом и датой, чтобы оценить спрос.
Прежде чем планировать серию видео, курс или контент-кампанию, хочется знать, смотрят ли люди эту тему, какой длины успешные видео и какие каналы уже её заняли. Собственный поиск YouTube показывает по десять результатов за раз и без цифр рядом друг с другом. Lovely Router выполняет поиск за вас. Отправьте ключевые слова, получите по одному JSON-объекту на видео и платите за каждое видео с предоплаченного баланса. Запускайте из скрипта или ИИ-агента с одним API-ключом.
Передайте это своему ИИ-агенту
Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.
Оцените тему на YouTube до того, как снимать видео. 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>Как это работает
Составьте список тем
Запишите ключевые слова, которые рассматриваете, по одному на элемент: саму тему, вопрос, который задают люди, название продукта плюс «обзор».
Запустите инструмент с лимитом
Отправьте их на
POST /v1/tools/youtube-search/runсmaxItems— числом видео — иmax_results— лимитом запуска. Запуск резервирует свою максимальную стоимость на балансе и возвращает видео в JSON.Сравните темы
Для каждого ключевого слова посмотрите медиану просмотров, долю видео с небольших каналов и типичную длительность. Тема с большим числом просмотров у небольших каналов открыта; тема, где доминируют несколько крупных каналов, — нет.
Поиск по теме одним запросом
Поиск видео на YouTube принимает поисковые запросы в keywords, по одному поиску на элемент. Вместо ключевых слов можно передать ссылки YouTube в startUrls: URL поисковой выдачи, канала, плейлиста или видео. Фильтры sort, uploadDate и duration применяются к поиску по ключевым словам:
curl https://lovelyrouter.com/v1/tools/youtube-search/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"keywords": ["espresso tutorial"],
"maxItems": 5
},
"max_results": 5
}'Если запуск не завершился за 60 секунд, возвращается 202; как опрашивать статус, описано в разделе «Запуск инструмента». Один запуск может вернуть до 200 видео.
Что содержит каждое видео
| Группа полей | Что вы получаете |
|---|---|
| Идентификация | Название видео |
| Охват | Просмотры |
| Вовлечённость | Число лайков и комментариев |
| Формат | Длительность |
| Источник | Канал, который его опубликовал |
| Время | Дата публикации |
Рецепты
Найдите по 50 видео для пяти вариантов ключевого слова и сравните медиану просмотров по вариантам, чтобы выбрать тот, на который больше спрос.
Оставьте видео с большим числом просмотров от каналов, о которых вы не слышали: это признак того, что небольшой канал может здесь выиграть.
Сгруппируйте лучшие видео по длительности. Если победители длятся 8–12 минут, планируйте такой формат, а не 30 минут.
С фильтром uploadDate смотрите только на свежие загрузки и проверяйте, по каким ключевым словам всё ещё появляются видео с хорошими просмотрами.
Посчитайте, какие каналы чаще всего встречаются по вашим ключевым словам, и следите за ними с помощью youtube-channel.
Удобнее простыми словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди на YouTube по запросам 'espresso tutorial', 'home espresso setup' и 'best espresso grinder' по 30 видео и скажи, у какого ключевого слова больше всего просмотров на видео и какие каналы встречаются чаще всего. Задай max_results = 90».
Сочетайте с другими источниками
Поиск показывает, что уже есть. Эти инструменты подсказывают, что с этим делать:
Видео YouTube по ключевым словам или по ссылкам YouTube (поисковая выдача, канал, плейлист или видео): название, просмотры, лайки, число комментариев, длительность, канал, дата.
Видео с каналов YouTube (никнеймы вроде @MrBeast или URL каналов): название, просмотры, лайки, число комментариев, длительность, дата.
Комментарии к видео или Shorts на YouTube: текст, лайки, число ответов, автор, дата. Сортировка по популярности или по новизне.
Полные расшифровки (субтитры) видео YouTube с таймкодами: по одной на ссылку, на нужном языке, если он есть у видео.
Динамика интереса в Google Trends по времени и регионам для ключевого слова.
youtube-channelвыдаёт все недавние видео канала, найденного в поиске.youtube-commentsпоказывает вопросы зрителей под лучшими видео — это ваши следующие заголовки.youtube-transcriptдаёт текст речи успешного видео, чтобы изучить его структуру.google-trendsпоказывает, растёт ли интерес к теме за пределами YouTube.
Более широкая задача описана в разделе мониторинг соцсетей.
Сколько это стоит
Вы платите за каждое видео: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс плату за видео, умноженную на max_results, — а затем рассчитывается по фактически возвращённому. Остаток резерва возвращается на баланс. Запуск, завершившийся ошибкой или по тайм-ауту, оплачивает только выданные видео, а запуск, отклонённый при старте, ничего не стоит.
Исследование 10 ключевых слов по 30 видео оплачивается как 300 видео. Подписки и ежемесячного минимума нет: пополнение от $5, и один баланс оплачивает и инструменты, и модели. На карточке выше — актуальная цена; все инструменты перечислены на странице цен.
Частые вопросы
Можно ли искать по нескольким ключевым словам за один запуск?+
Да. keywords — это список, и каждый элемент выполняется как отдельный поиск.
Можно ли фильтровать по дате загрузки или длительности видео?+
Да. uploadDate и duration фильтруют поиск по ключевым словам, а sort меняет порядок. При передаче startUrls они не применяются.
Можно ли начать с плейлиста или канала вместо ключевого слова?+
Да. Укажите ссылку в startUrls: принимаются URL поисковой выдачи, канала, плейлиста или видео.
Сколько видео может вернуть один запуск?+
До 200. Чтобы получить меньше, используйте maxItems.
Показывает ли он объём поиска?+
Нет. Он возвращает видео и их просмотры, лайки, комментарии, длительность, канал и дату. Спрос вы оцениваете по этим цифрам сами.
Нужна ли подписка?+
Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. За неудачные запуски вы платите только за выданные результаты, и ничего не продлевается автоматически.
Планируете контент для рынка? Смотрите мониторинг соцсетей, поиск инфлюенсеров и каталог инструментов.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.