使用场景

社交聆听 API:
覆盖 X、Reddit、TikTok、Instagram 和新闻

用一个 API 密钥追踪 X、Reddit、TikTok、Instagram、YouTube、Threads、Telegram 和 Google News 上的品牌提及与讨论,按帖子计费。

预付费,无订阅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 里,每个平台都是一个数据工具,有各自的搜索筛选条件,按帖子、评论或文章计价。你可以用代码按自己的计划运行它们,也可以让 AI 智能体通过 MCP 来运行。

交给你的 AI 智能体

把这段提示词复制到 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 搜索、Reddit 搜索、TikTok 搜索、Instagram 话题标签、Threads 和 Google News。

  2. 拉取讨论内容

    把值得关注的帖子发给评论类工具:X 回复、Reddit 评论、TikTok 评论、Instagram 评论和 YouTube 评论。

  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()  # 超过 `wait` 仍未结束的运行会返回 202:请轮询

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)

模型 token 按该模型的价格逐 token 计费;参阅模型。

04

工具一览

X (Twitter)
搜索 X(Twitter)帖子

匹配关键词、话题标签或指定账号的推文:内容、作者、互动数据、日期。

$0.000388 / tweet详情 →
X (Twitter)
获取 X(Twitter)帖子回复

按 URL 获取 X/Twitter 帖子的回复:内容、作者、互动、日期。

$0.000375 / reply + $0.00075 / call详情 →
Reddit
搜索 Reddit 帖子

按搜索词或版块获取 Reddit 帖子:标题、正文、得分、评论数、作者、日期。

$0.0057 / post详情 →
Reddit
获取 Reddit 评论

按 URL 获取 Reddit 帖子及其评论。

$0.00125 / item + $0.01 / call详情 →
TikTok
搜索 TikTok 视频

按关键词或话题标签搜索 TikTok 视频:文案、播放、点赞、分享、作者、音乐。

$0.00045 / video详情 →
TikTok
列出 TikTok 评论

按 URL 获取 TikTok 视频的评论。

$0.00045 / comment详情 →
Instagram
Instagram 话题标签帖子

Instagram 话题标签或关键词下的帖子或 Reels:文案、点赞、评论、作者、媒体。

$0.001225 / post详情 →
Instagram
列出 Instagram 评论

按 URL 获取 Instagram 帖子或 Reels 的评论。

$0.00125 / comment详情 →
YouTube
列出 YouTube 评论

YouTube 视频或 Shorts 的评论:内容、点赞、回复数、作者、日期。按热门或最新排序。

$0.00125 / comment + $0.0025 / call详情 →
Threads
获取 Threads 帖子

Threads 用户的帖子或关键词搜索结果。

$0.0045 / post详情 →
Telegram
获取 Telegram 频道消息

公开 Telegram 频道的消息。

$0.003 / message详情 →
Google News
搜索 Google 新闻

Google 新闻中某个搜索的新闻文章(支持运算符:"精确短语"、OR、-排除词、site:、intitle:),可限定时间范围:标题、来源、日期及发布网站上的文章链接。

$0.006 / article详情 →
平台查找帖子获取讨论内容值得了解的筛选条件
Xx-search:正文、作者、互动数据、日期x-replies,按 postUrlsX 搜索运算符、queryType、lang、twitterHandles
Redditreddit-search:标题、正文、得分、评论数、作者、日期reddit-comments,按帖子 urls,含回复层级subredditName、sort、timeframe
TikToktiktok-search:文案、播放量、点赞数、分享数、作者、音乐tiktok-comments,按视频 URLdateRange、sortType、location、includeReplies
Instagraminstagram-hashtag:文案、点赞数、评论数、作者、媒体instagram-comments:正文、点赞数、回复数话题标签 startUrls 或 keywords、sortOrder
YouTube用 YouTube 搜索查找视频youtube-comments:正文、点赞数、回复数sort:top 或 latest
Threadsthreads-posts,mode 设为 searchthreads-posts,mode 设为 threadpostedAfter、postedBefore
Telegramtelegram-channel:公开频道消息oldestMessageDate
新闻google-news:标题、来源、日期、链接搜索运算符、openEndedDateRange、language

Tip

使用每个工具的日期筛选条件,避免定时运行为已经拿到的帖子重复付费:X 用 since:,Reddit 用 timeframe,Google News 用 openEndedDateRange,Threads 用 postedAfter,Telegram 用 oldestMessageDate。

05

实用配方

每日品牌简报。

每天早上运行 x-search 并把 since: 设为昨天,运行 reddit-search 并设置 "timeframe": "day",运行 google-news 并设置 "openEndedDateRange": "1d",再以 search 模式运行 threads-posts 并设置 postedAfter。合并结果后,让模型写一页摘要。

发布反响。

发布新品视频后,对它运行 youtube-comments 并设置 "sort": "latest",对你的 TikTok 帖子运行 tiktok-comments 并设置 "includeReplies": true。让模型总结最常见的问题。

竞品用户不满意什么。

用竞品名称运行 reddit-search 并设置 "sort": "comments",再对讨论最多的帖子运行 reddit-comments。

话题标签活动追踪。

对 https://www.instagram.com/explore/tags/yourcampaign/ 运行 instagram-hashtag,并运行 tiktok-search,在 keywords 中填入同一个话题标签,设置 "sortType": "DATE_POSTED"。

舆情预警。

在 X 搜索词中加上 min_faves:100,及时发现关于你、正在升温的帖子;同时用 telegram-channel 关注你所在市场的公开 Telegram 频道。

06

让智能体来运行

连接 MCP 服务器后(claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp --header "Authorization: Bearer $LOVELY_API_KEY"),对 Claude Code 或 Cursor 说:"找出本周大家在 X、Reddit 和 TikTok 上对 Brewbox 的评价,读取讨论最多的五个帖子下的回复,附上链接总结好评和投诉。每次运行都设置 max_results。"

07

费用说明

社交工具按结果计费:按帖子、评论、视频、消息或文章计费,少数工具另收每次调用费。上方卡片显示的是当前价格。启动运行时会预留它的最高费用,即每次调用费加上每条结果费乘以 max_results,结束后按实际返回的结果结算。失败的运行只为已交付的结果付费,因此没有返回任何结果的运行不收费。无需订阅:你只需充值一个预付费余额,模型和浏览器智能体也共用这笔余额。参阅价格。

08

常见问题

?
能用一个 API 监测多个平台上的品牌提及吗?+

可以。每个平台都是同一个端点 POST /v1/tools/{id}/run 背后的一个工具,使用同一个 API 密钥和预付费余额。各工具的输入不同,请通过 GET /v1/tools/{id} 或在工具页面上查看每个工具的输入结构。

API 会返回情感分数吗?+

不会。工具返回的是帖子和评论本身。用同一个密钥把文本发给模型,例如 claude-sonnet-5.5,让它按你需要的格式给出情感、话题或投诉分析,做成你自己的社媒舆情监测。

能使用 X 的高级搜索运算符吗?+

可以。x-search 的 searchTerms 列表中的每个条目都按 X 搜索框的写法书写,支持 "exact phrase"、OR、-word、from:、to:、since:、until:、min_faves:、filter: 和 lang:。

如何避免重复收集同样的帖子?+

按计划定时运行,并把每个工具的日期筛选条件设为上次运行以来的时间段:X 用 since:,Reddit 用 timeframe,Google News 用 openEndedDateRange,Threads 用 postedAfter,Telegram 用 oldestMessageDate。

AI 智能体能替我做社交聆听吗?+

可以。把 MCP 服务器连接到 Claude Code、Cursor 或其他 MCP 客户端,智能体会用 suggest_tools 找到合适的工具,读取其输入结构并运行,费用从你的余额中扣除。给它一个设置了消费上限的密钥。

关于创作者及其受众,请看网红研究;关于星级评分,请看评论监测;关于小红书、抖音和微博,请看中国社交媒体数据。

一个预付费密钥,搞定模型、数据和智能体

无需订阅。充值后按需使用,每笔费用都能在日志中查看。