参数
| 参数 | 必填 | 取值 |
|---|---|---|
platform | 是 | tiktok / instagram / youtube / twitter / douyin / xiaohongshu |
keyword | 是 | 搜索词,支持中文 |
limit | 否 | 返回条数,默认 20 |
每个平台能做什么(线上实际支持矩阵)
| 平台 | 搜索内容 | 搜达人 | 评论 | 账号详情 | 作品列表 | 热搜 |
|---|---|---|---|---|---|---|
| TikTok | ✓ | ✓ | ✓ | ✓ | ✓ | — |
| — | ✓ | ✓ | ✓ | ✓ | — | |
| YouTube | ✓ | — | ✓ | ✓ | ✓ | — |
| X / Twitter | ✓ | — | ✓ | ✓ | ✓ | — |
| 抖音 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| 小红书 | ✓ | ✓ | ✓ | ✓ | ✓ | — |
这张表来自线上 list_platforms 的实时返回,不是宣传口径。缺的能力就是没有,别按想象设计流程。
跨平台对比时的字段陷阱
- 点赞量级不可直接比:TikTok 百万级点赞常见,小红书几百点赞就可能是爆款,横向比较要用“相对自己平台的分位”。
- 抖音搜索结果的互动数常为 0,跨平台比之前先用
get_post把真实数据补齐。 - 单位统一为原始计数:接口不做“万/千”换算,自己格式化。
复制即可运行
cURL
curl -s https://lucydomi.com/mcp/v1/search_posts \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"platform": "tiktok", "keyword": "coffee", "limit": 10}'Python(标准库,无需安装依赖)
import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
PLATFORMS = ["tiktok", "youtube", "douyin", "xiaohongshu"]
for p in PLATFORMS:
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/search_posts",
data=json.dumps({"platform": p, "keyword": "咖啡", "limit": 10}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
try:
d = json.load(urllib.request.urlopen(req, timeout=60))
except Exception as e:
print(p, "failed:", e)
continue
best = max((i for i in d.get("items", []) if not i.get("error")),
key=lambda x: x.get("stats", {}).get("likes", 0), default=None)
print(p, "->", (best or {}).get("url"))
真实返回样例
下面这段来自线上真实调用,已截断并去掉图片/签名类字段。
{
"ok": true,
"platform": "douyin",
"tool": "search_posts",
"count": 3,
"items": [
{
"id": "7695994014143952488",
"url": "https://www.douyin.com/video/7695994014143952488",
"author": {"handle": null, "name": "曼松王子的茶"},
"text": "不在版纳,在昆明! 藏在巫家坝中央公园里的雨林瀑布咖啡馆。 #春咖咖 #昆明必打卡",
"created_at": "2026-10-13 11:47:20",
"stats": {"likes": 6793, "comments": 0, "shares": 0, "views": 0, "collects": 0}
},
{
"id": "7699746605349011121",
"url": "https://www.douyin.com/video/7699746605349011121",
"author": {"name": "昆明老曹"},
"text": "在滇池边发现一个喝咖啡,看风景的好地方~",
"created_at": "2026-10-23 14:29:18",
"stats": {"likes": 302, "comments": 0, "shares": 0, "views": 0, "collects": 0}
}
]
}常见问题
搜索结果能翻页吗?
按
limit 取到上限后要更多,就换关键词组合或加时间限定,接口不提供 page 参数。中文关键词搜海外平台准吗?
TikTok 用英文词效果明显更好;中文词在 TikTok 也能返回,但相关度低。
一个密钥能同时用六个平台吗?
需要对应分组的密钥:海外平台用海外分组,抖音/小红书用国内分组,同一账户可以同时开。
搜达人和搜内容有什么区别?
搜内容返回帖子;搜达人返回账号(粉丝数、简介),拿到 handle 后再用账号详情和作品列表深入。