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

API мониторинга соцсетей для X, Reddit, TikTok, Instagram и новостей

Отслеживайте упоминания бренда и обсуждения в X, Reddit, TikTok, Instagram, YouTube, Threads, Telegram и Google News с одним API-ключом. Оплата за пост.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
X (Twitter)RedditTikTokInstagramYouTubeGoogle Newslovelyjsonitems[0]"platform": "reddit""author": "u/devops_dan""text": "switched our agents t…"likes": 214"replies": 38"posted": "2026-10-19""url": "reddit.com/r/…"

Собирайте, что люди говорят о вашем бренде, конкурентах или теме в X, Reddit, TikTok, Instagram, YouTube, Threads, Telegram и Google News, в виде JSON, который можно сохранить, вывести на график или передать модели. Вместе эти инструменты работают как API мониторинга соцсетей: каждая площадка — это инструмент данных со своими фильтрами поиска и ценой за пост, комментарий или статью. Запускайте их по своему расписанию из кода или поручите это ИИ-агенту через MCP.

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

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

Track mentions and conversations about a brand or topic on X, Reddit, TikTok, Instagram, YouTube, Threads, Telegram and Google News. 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 brand or keywords, the platforms, the time window and how to summarize what you find>
01

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

010203
  1. Найдите упоминания

    Инструменты поиска возвращают посты, подходящие под ваши ключевые слова, хештеги или операторы: Поиск постов в X (Twitter), Поиск постов на Reddit, Поиск видео в TikTok, Публикации Instagram по хэштегу, Публикации Threads и Поиск в Google News.

  2. Подтяните обсуждение

  3. Прочитайте всё с помощью модели

    Передайте текст модели с тем же ключом, например claude-sonnet-5.5, чтобы сгруппировать его по темам и тональности или вытащить жалобы и вопросы.

02

Мониторинг упоминаний бренда в X

Этот запуск собирает англоязычные посты за неделю, где упоминается бренд, исключая собственный аккаунт бренда:

cURL
curl https://lovelyrouter.com/v1/tools/x-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "searchTerms": ["\"brewbox\" OR @brewbox -from:brewbox lang:en since:2026-10-13"],
      "queryType": "Latest",
      "maxItems": 200
    },
    "max_results": 200
  }'

Каждый элемент в items — это один пост с текстом, автором, вовлечённостью и датой. Каждая строка в searchTerms пишется так же, как в строке поиска X, поэтому операторы работают: "exact phrase", OR, -word, from:, to:, since: и until:, min_faves:, filter: и lang:. queryType возвращает Latest, Top или Latest + Top. Запуск, который длится дольше 60 секунд, отвечает 202; опрашивайте его, как показано в разделе Запуск инструмента.

03

Превратите упоминания в отчёт

Тот же ключ вызывает и модель. Этот скрипт берёт посты Reddit за неделю и спрашивает Claude, на что жалуются люди:

Python
import json
import os

import anthropic
import requests

KEY = os.environ["LOVELY_API_KEY"]
run = requests.post(
    "https://lovelyrouter.com/v1/tools/reddit-search/run",
    headers={"Authorization": f"Bearer {KEY}"},
    json={"input": {"queries": ["brewbox"], "sort": "new", "timeframe": "week"}, "max_results": 50, "wait": 120},
    timeout=150,
).json()  # a run still going after `wait` comes back as 202: poll it

client = anthropic.Anthropic(base_url="https://lovelyrouter.com", api_key=KEY)
msg = client.messages.create(
    model="claude-sonnet-5.5",
    max_tokens=1500,
    messages=[{"role": "user", "content": "Group these Reddit posts about Brewbox by topic and sentiment, "
               "and quote the three most common complaints:\n" + json.dumps(run["items"])}],
)
print(msg.content[0].text)

Токены модели оплачиваются по цене модели; см. модели.

04

Инструменты

X (Twitter)
Поиск постов в X (Twitter)

Твиты по поисковым запросам, хэштегам или от указанных аккаунтов: текст, автор, вовлечённость, дата. Каждый запрос поддерживает операторы расширенного поиска X (from:, since:, min_faves:, filter:, lang: …).

$0.000388 / tweetПодробности →
X (Twitter)
Ответы на посты X (Twitter)

Ответы на посты X/Twitter по URL: текст, автор, вовлечённость, дата.

$0.000375 / reply + $0.00075 / callПодробности →
Reddit
Поиск постов на Reddit

Посты Reddit по запросу или сабреддиту: заголовок, текст, рейтинг, число комментариев, автор, дата.

$0.0057 / postПодробности →
Reddit
Комментарии Reddit

Пост и комментарии ветки Reddit по URL: текст, рейтинг, автор, дата, уровень вложенности.

$0.00125 / item + $0.01 / callПодробности →
TikTok
Поиск видео в TikTok

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

$0.00045 / videoПодробности →
TikTok
Комментарии TikTok

Комментарии к видео TikTok по URL.

$0.00045 / commentПодробности →
Instagram
Публикации Instagram по хэштегу

Публикации или Reels по хэштегам или ключевым словам Instagram: подпись, лайки, комментарии, автор, медиа.

$0.001225 / postПодробности →
Instagram
Комментарии Instagram

Комментарии к публикациям или Reels в Instagram по URL: текст, лайки, число ответов, автор, дата.

$0.00125 / commentПодробности →
YouTube
Комментарии YouTube

Комментарии к видео или Shorts на YouTube: текст, лайки, число ответов, автор, дата. Сортировка по популярности или по новизне.

$0.00125 / comment + $0.0025 / callПодробности →
Threads
Публикации Threads

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

$0.0045 / postПодробности →
Telegram
Сообщения Telegram-каналов

Сообщения публичных каналов Telegram, опубликованные в дату oldestMessageDate (YYYY-MM-DD) или позже.

$0.003 / messageПодробности →
Google News
Поиск в Google News

Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.

$0.006 / articleПодробности →
ПлощадкаПоиск постовПолучение обсужденияПолезные фильтры
Xx-search: текст, автор, вовлечённость, датаx-replies по postUrlsоператоры X, queryType, lang, twitterHandles
Redditreddit-search: заголовок, текст, рейтинг, число комментариев, автор, датаreddit-comments по urls тредов, с глубиной ответовsubredditName, sort, timeframe
TikToktiktok-search: подпись, просмотры, лайки, репосты, автор, музыкаtiktok-comments по URL видеоdateRange, sortType, location, includeReplies
Instagraminstagram-hashtag: подпись, лайки, комментарии, автор, медиаinstagram-comments: текст, лайки, число ответовхештег в startUrls или keywords, sortOrder
YouTubeпоиск видео через Поиск видео на YouTubeyoutube-comments: текст, лайки, число ответовsort: top или latest
Threadsthreads-posts с mode searchthreads-posts с mode threadpostedAfter, postedBefore
Telegramtelegram-channel: сообщения публичных каналовoldestMessageDate
Новостиgoogle-news: заголовок, источник, дата, ссылкаоператоры, openEndedDateRange, language

Tip

Используйте фильтр по дате в каждом инструменте, чтобы запуск по расписанию не платил за уже собранные посты: since: в X, timeframe в Reddit, openEndedDateRange в Google News, postedAfter в Threads и oldestMessageDate в Telegram.

05

Рецепты

Ежедневная сводка по бренду

Каждое утро запускайте x-search с since:, равным вчерашней дате, reddit-search с "timeframe": "day", google-news с "openEndedDateRange": "1d" и threads-posts в режиме search с postedAfter. Объедините результаты и попросите модель сделать сводку на одну страницу.

Реакция на запуск

После публикации видео о запуске продукта запустите на нём youtube-comments с "sort": "latest", а на ваших постах в TikTok — tiktok-comments с "includeReplies": true. Попросите модель выделить самые частые вопросы.

Что не нравится клиентам конкурента

Запустите reddit-search по названию конкурента с "sort": "comments", а затем reddit-comments на самых обсуждаемых тредах.

Отслеживание кампании по хештегу

Запустите instagram-hashtag на https://www.instagram.com/explore/tags/yourcampaign/ и tiktok-search с тем же хештегом в keywords и "sortType": "DATE_POSTED".

Раннее предупреждение

Добавьте min_faves:100 в поисковый запрос X, чтобы ловить набирающие популярность посты о вас, и следите за публичными Telegram-каналами вашего рынка с помощью telegram-channel.

06

Запуск из агента

Подключив MCP-сервер (claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp --header "Authorization: Bearer $LOVELY_API_KEY"), попросите Claude Code или Cursor: «Найди, что говорили о Brewbox на этой неделе в X, Reddit и TikTok, прочитай ответы под пятью самыми обсуждаемыми постами и кратко изложи похвалу и жалобы со ссылками. Задавай max_results в каждом запуске».

07

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

Инструменты соцсетей оплачиваются за результат: за пост, комментарий, видео, сообщение или статью, а у некоторых есть ещё и плата за вызов. Актуальные цены показаны на карточках выше. При старте запуск резервирует свою максимальную стоимость — плата за вызов плюс плата за результат, умноженная на max_results, — а затем списывается за то, что он вернул. Неудачный запуск оплачивает только доставленные результаты, поэтому запуск без результатов ничего не стоит. Подписки нет: вы пополняете один предоплаченный баланс, общий с моделями и браузерным агентом. См. Цены.

08

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

?
Можно ли отслеживать упоминания бренда на нескольких площадках через один API?+

Да. Каждая площадка — это инструмент за одним и тем же эндпоинтом POST /v1/tools/{id}/run, с тем же API-ключом и предоплаченным балансом. Входные данные у инструментов разные, поэтому читайте схему входных данных каждого через GET /v1/tools/{id} или на его странице.

Возвращает ли API оценку тональности?+

Нет. Инструменты возвращают сами посты и комментарии. Отправьте текст модели с тем же ключом, например claude-sonnet-5.5, и попросите определить тональность, темы или жалобы в нужном вам формате.

Можно ли использовать расширенные операторы поиска X?+

Да. Каждая строка в списке searchTerms инструмента x-search пишется как в строке поиска X, с "exact phrase", OR, -word, from:, to:, since:, until:, min_faves:, filter: и lang:.

Как не собирать одни и те же посты дважды?+

Запускайте по расписанию и задавайте в каждом инструменте фильтр по дате, равный времени с прошлого запуска: since: в X, timeframe в Reddit, openEndedDateRange в Google News, postedAfter в Threads и oldestMessageDate в Telegram.

Может ли ИИ-агент вести мониторинг за меня?+

Да. Подключите MCP-сервер к Claude Code, Cursor или другому MCP-клиенту, и агент найдёт нужный инструмент через suggest_tools, прочитает его схему и запустит его, а оплата пойдёт с вашего баланса. Выдайте ему ключ с лимитом расходов.

Об авторах и их аудиториях см. исследование инфлюенсеров; о звёздных рейтингах — мониторинг отзывов; о Xiaohongshu, Douyin и Weibo — данные китайских соцсетей.

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

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