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

API поиска инфлюенсеров — данные авторов TikTok, Instagram и YouTube

Находите авторов по теме в Instagram, TikTok и YouTube и получайте их подписчиков, посты, Reels и просмотры в JSON из кода или агента. Оплата за результат.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
InstagramTikTokYouTubeX (Twitter)lovelyjsonitems[0]"handle": "@trailmix.eats""followers": 184200"posts": 612"avg_views": 41300"bio": "Plant-based recipes…""verified": false

Вы ведёте кампании с инфлюенсерами или делаете продукт для поиска авторов, и вам нужны данные об авторах, которые можно сортировать: кто пишет на нужную тему, насколько велика его аудитория и как работает его свежий контент. Lovely Router отдаёт всё это через инструменты данных, которые работают как API для поиска инфлюенсеров. Ищите в Instagram, TikTok и YouTube по ключевым словам, затем получайте профили, посты, Reels, Shorts и профили X в виде JSON — с оплатой за результат и тем же ключом, что и для моделей.

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

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

Find creators by topic on Instagram, TikTok, YouTube and X, then pull their followers, posts, reels and views. 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 niche, the platforms, the follower range and what to compare>
01

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

010203
  1. Найдите авторов по теме

    Найдите в Instagram профили, подходящие под ключевое слово, с помощью поиска в Instagram или ищите видео по ключевому слову через поиск видео в TikTok и поиск видео на YouTube. В каждом найденном видео указан автор или канал.

  2. Получите их цифры

    Передайте найденные аккаунты инструментам для профилей и контента: описание и число подписчиков, последние посты и Reels, видео и Shorts на YouTube, профили X.

  3. Оцените и отберите

    Сравните лайки, комментарии и просмотры с числом подписчиков в своём коде или передайте JSON модели и попросите составить ранжированный шорт-лист.

02

Поиск авторов в Instagram одним запросом

Этот запуск ищет в Instagram аккаунты, подходящие под «coffee roaster», и возвращает не больше 20:

curl https://lovelyrouter.com/v1/tools/instagram-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {"search": "coffee roaster", "searchType": "user", "searchLimit": 20},
    "max_results": 20
  }'

Запрос ждёт до 60 секунд. Завершённый запуск возвращает свой status, стоимость в charge_usd и аккаунты в items. Более долгий запуск возвращает 202 и путь poll; опрос и постраничная выдача описаны в разделе «Запустить инструмент».

Затем запросите данные по аккаунтам, которые хотите оставить. Профили Instagram возвращают по одному результату на имя пользователя: описание, число подписчиков, число постов и последние посты. Если не указывать max_results, лимитом будет длина вашего списка:

cURL
curl https://lovelyrouter.com/v1/tools/instagram-profile/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input": {"usernames": ["natgeo"]}}'
03

Инструменты

Instagram
Поиск в Instagram

Поиск пользователей, мест или хэштегов в Instagram по ключевому слову.

$0.00345 / resultПодробности →
Instagram
Профили Instagram

Данные профиля Instagram по имени пользователя: био, подписчики, число публикаций, последние публикации.

$0.00345 / profileПодробности →
Instagram
Публикации Instagram

Последние публикации из профилей Instagram: подпись, лайки, число комментариев, медиа, владелец с числом подписчиков, дата.

$0.001225 / postПодробности →
Instagram
Reels в Instagram

Reels из профилей Instagram: подпись, просмотры, лайки, комментарии, URL видео, дата.

$0.001225 / reelПодробности →
TikTok
Поиск видео в TikTok

Видео TikTok по ключевым словам или хэштегам: подпись, просмотры, лайки, репосты, автор, музыка.

$0.00045 / videoПодробности →
TikTok
Видео профиля TikTok

Видео аккаунта TikTok с числом подписчиков и лайков автора.

$0.00045 / videoПодробности →
YouTube
Поиск видео на YouTube

Видео YouTube по ключевым словам или по ссылкам YouTube (поисковая выдача, канал, плейлист или видео): название, просмотры, лайки, число комментариев, длительность, канал, дата.

$0.00125 / videoПодробности →
YouTube
Видео канала YouTube

Видео с каналов YouTube (никнеймы вроде @MrBeast или URL каналов): название, просмотры, лайки, число комментариев, длительность, дата.

$0.00125 / videoПодробности →
YouTube
YouTube Shorts

Shorts с каналов YouTube: название, просмотры, лайки, комментарии, дата.

$0.00125 / shortПодробности →
X (Twitter)
Профили X (Twitter)

Данные профилей X/Twitter по никнеймам: био, подписчики, подписки, верификация, счётчики.

$0.000375 / profileПодробности →
ИнструментЧто вы отправляетеЧто в каждом результате
instagram-searchКлючевые слова search, searchType (user, hashtag, place или popular)Подходящий профиль, хэштег или место либо популярный Reel
instagram-profileusernamesОписание, подписчики, число постов, последние посты
instagram-postsstartUrls (URL профилей или имена пользователей), untilПодпись, лайки, число комментариев, медиа, владелец с числом подписчиков, дата
instagram-reelsstartUrls (вкладки Reels или имена пользователей), untilПодпись, просмотры, лайки, комментарии, URL видео, дата
tiktok-searchkeywords, sortType, dateRange, locationПодпись, просмотры, лайки, репосты, автор, музыка
tiktok-profileusernames, since, untilВидео с числом подписчиков и лайков автора
youtube-searchkeywordsНазвание, просмотры, лайки, число комментариев, длительность, канал, дата
youtube-channelyoutubeHandles или URL каналовНазвание, просмотры, лайки, число комментариев, длительность, дата
youtube-shortsyoutubeHandles или URL вкладок ShortsНазвание, просмотры, лайки, комментарии, дата
x-profiletwitterHandlesОписание, подписчики, подписки, верификация, счётчики

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

04

Рецепты

Найдите растущих авторов в нише

Запустите tiktok-search с "keywords": ["home espresso"], "sortType": "MOST_LIKED", "dateRange": "LAST_THREE_MONTHS" и "location": "US". Сгруппируйте видео по авторам, затем запустите tiktok-profile для авторов, которые встречаются чаще всего, чтобы увидеть число их подписчиков и частоту публикаций.

Проверьте шорт-лист перед тем, как писать авторам

Запустите instagram-reels для каждого аккаунта с until, равным дате 90 дней назад. Медианные просмотры одного Reel рядом с числом подписчиков из instagram-profile показывают, кто всё ещё доходит до своей аудитории.

Оцените кампанию

Запустите instagram-posts для авторов, с которыми вы работали, и задайте until равным дате старта кампании, чтобы вернулись только более новые посты. Сравните лайки и комментарии под рекламными постами с остальными.

Сопоставьте одного автора на разных платформах

Зная аккаунты автора, запустите youtube-channel, youtube-shorts и x-profile, чтобы понять, где у него самая большая аудитория.

Начните с хэштега

Публикации Instagram по хэштегу возвращают посты по хэштегу с автором каждого поста — это готовый список аккаунтов для instagram-profile.

05

Поручите исследование агенту

Подключите MCP-сервер к Claude Code:

Shell
claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

Затем попросите: «Найди 15 авторов TikTok из США, которые за последние три месяца публиковали видео про домашний эспрессо. Для каждого получи число подписчиков и просмотры последних 10 видео и дай мне таблицу, отсортированную по медианным просмотрам. В каждом запуске задавай max_results и до начала назови мне ориентировочную стоимость.»

06

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

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

Нет ни подписки, ни ежемесячного минимума. На карточках выше указаны текущие цены, а на странице «Цены» перечислены все инструменты. Чтобы большой обход оставался дешёвым, сначала ищите, задавайте max_results в каждом запуске и запрашивайте полные профили и посты только для аккаунтов, которые оставляете.

07

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

?
Можно ли искать авторов в Instagram по ключевому слову?+

Да. Запустите instagram-search с searchType, равным user, и он вернёт профили, подходящие под ваше ключевое слово. Другие типы поиска возвращают хэштеги, места или популярные Reels.

Какие цифры подходят для оценки вовлечённости?+

Число подписчиков дают инструменты профилей Instagram, TikTok и X, а посты Instagram тоже содержат число подписчиков владельца. Лайки, комментарии и просмотры приходят с каждым постом, Reel и видео, так что уровень вовлечённости для каждого автора можно посчитать в своём коде.

Нужен ли аккаунт в Instagram, TikTok или YouTube?+

Нужны API-ключ Lovely Router и баланс, достаточный для запуска. Ни один из этих инструментов не требует входа в аккаунт: вы отправляете имена аккаунтов, URL профилей или ключевые слова.

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

Инструменты профилей возвращают по одному результату на каждый аккаунт из списка — до максимума инструмента на запуск, который указан на его странице. Длинные списки разбейте на несколько запусков; одновременно может выполняться до 10.

Являются ли данные авторов персональными данными?+

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

Прежде чем составлять список для рассылки, прочитайте Политику допустимого использования. Чтобы отслеживать, что говорят о бренде, а не кто говорит, смотрите мониторинг соцсетей; о платных кампаниях конкурентов — анализ рекламы.

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

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