API мониторинга соцсетей для X, Reddit, TikTok, Instagram и новостей
Отслеживайте упоминания бренда и обсуждения в X, Reddit, TikTok, Instagram, YouTube, Threads, Telegram и Google News с одним API-ключом. Оплата за пост.
Собирайте, что люди говорят о вашем бренде, конкурентах или теме в 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>Как это работает
Найдите упоминания
Инструменты поиска возвращают посты, подходящие под ваши ключевые слова, хештеги или операторы: Поиск постов в X (Twitter), Поиск постов на Reddit, Поиск видео в TikTok, Публикации Instagram по хэштегу, Публикации Threads и Поиск в Google News.
Подтяните обсуждение
Отправьте важные посты в инструменты комментариев: Ответы на посты X (Twitter), Комментарии Reddit, Комментарии TikTok, Комментарии Instagram и Комментарии YouTube.
Прочитайте всё с помощью модели
Передайте текст модели с тем же ключом, например
claude-sonnet-5.5, чтобы сгруппировать его по темам и тональности или вытащить жалобы и вопросы.
Мониторинг упоминаний бренда в X
Этот запуск собирает англоязычные посты за неделю, где упоминается бренд, исключая собственный аккаунт бренда:
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; опрашивайте его, как показано в разделе Запуск инструмента.
Превратите упоминания в отчёт
Тот же ключ вызывает и модель. Этот скрипт берёт посты Reddit за неделю и спрашивает Claude, на что жалуются люди:
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)Токены модели оплачиваются по цене модели; см. модели.
Инструменты
Твиты по поисковым запросам, хэштегам или от указанных аккаунтов: текст, автор, вовлечённость, дата. Каждый запрос поддерживает операторы расширенного поиска X (from:, since:, min_faves:, filter:, lang: …).
Ответы на посты X/Twitter по URL: текст, автор, вовлечённость, дата.
Посты Reddit по запросу или сабреддиту: заголовок, текст, рейтинг, число комментариев, автор, дата.
Пост и комментарии ветки Reddit по URL: текст, рейтинг, автор, дата, уровень вложенности.
Видео TikTok по ключевым словам или хэштегам: подпись, просмотры, лайки, репосты, автор, музыка.
Комментарии к видео TikTok по URL.
Публикации или Reels по хэштегам или ключевым словам Instagram: подпись, лайки, комментарии, автор, медиа.
Комментарии к публикациям или Reels в Instagram по URL: текст, лайки, число ответов, автор, дата.
Комментарии к видео или Shorts на YouTube: текст, лайки, число ответов, автор, дата. Сортировка по популярности или по новизне.
Публикации Threads от пользователей, по ключевому слову или из ветки: текст, лайки, ответы, репосты, просмотры, медиа, дата.
Сообщения публичных каналов Telegram, опубликованные в дату oldestMessageDate (YYYY-MM-DD) или позже.
Новостные статьи из Google News по запросу (работают операторы "exact phrase", OR, -word, site:, intitle:), при желании за указанный период: заголовок, источник, дата и ссылка на статью на сайте издания.
| Площадка | Поиск постов | Получение обсуждения | Полезные фильтры |
|---|---|---|---|
| X | x-search: текст, автор, вовлечённость, дата | x-replies по postUrls | операторы X, queryType, lang, twitterHandles |
reddit-search: заголовок, текст, рейтинг, число комментариев, автор, дата | reddit-comments по urls тредов, с глубиной ответов | subredditName, sort, timeframe | |
| TikTok | tiktok-search: подпись, просмотры, лайки, репосты, автор, музыка | tiktok-comments по URL видео | dateRange, sortType, location, includeReplies |
instagram-hashtag: подпись, лайки, комментарии, автор, медиа | instagram-comments: текст, лайки, число ответов | хештег в startUrls или keywords, sortOrder | |
| YouTube | поиск видео через Поиск видео на YouTube | youtube-comments: текст, лайки, число ответов | sort: top или latest |
| Threads | threads-posts с mode search | threads-posts с mode thread | postedAfter, postedBefore |
| Telegram | telegram-channel: сообщения публичных каналов | oldestMessageDate | |
| Новости | google-news: заголовок, источник, дата, ссылка | операторы, openEndedDateRange, language |
Tip
Используйте фильтр по дате в каждом инструменте, чтобы запуск по расписанию не платил за уже собранные посты: since: в X, timeframe в Reddit, openEndedDateRange в Google News, postedAfter в Threads и oldestMessageDate в Telegram.
Рецепты
Каждое утро запускайте 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.
Запуск из агента
Подключив 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 в каждом запуске».
Сколько это стоит
Инструменты соцсетей оплачиваются за результат: за пост, комментарий, видео, сообщение или статью, а у некоторых есть ещё и плата за вызов. Актуальные цены показаны на карточках выше. При старте запуск резервирует свою максимальную стоимость — плата за вызов плюс плата за результат, умноженная на max_results, — а затем списывается за то, что он вернул. Неудачный запуск оплачивает только доставленные результаты, поэтому запуск без результатов ничего не стоит. Подписки нет: вы пополняете один предоплаченный баланс, общий с моделями и браузерным агентом. См. Цены.
Частые вопросы
Можно ли отслеживать упоминания бренда на нескольких площадках через один 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 — данные китайских соцсетей.
Один предоплаченный ключ для моделей, данных и агентов
Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.