能拿到什么
| 支持的能力 | 搜视频 / 搜达人 / 达人详情 / 达人作品 / 视频详情 / 拉评论(含楼中楼)/ 热榜 |
|---|---|
| 返回字段 | 视频 url、文案、作者、时间、播放点赞评论分享、封面;热榜含排名与热度值 |
| 接入方式 | MCP(Streamable HTTP)或 REST(GET/POST 均可) |
| 说明 | 国内平台按分组授权,需累计充值满 $30 解锁;调用失败自动退款 |
字段长什么样
不管哪个平台,帖子类返回都是同一套结构:items[] 里放 platform / id / url / author{id,handle,name} / text / created_at / stats{...} / cover;达人类是 handle / name / bio / followers / following / posts / verified / avatar / url。换平台不用改解析代码。
用 MCP 还是 REST
给模型用走 MCP:把 https://lucydomi.com/mcp 加进客户端配置,它自己选工具。写程序用走 REST:https://lucydomi.com/mcp/v1/search_posts,GET 传查询参数、POST 传 JSON body 都行,返回结构完全一致。
复制即可运行
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": "douyin", "keyword": "昆明 楼盘", "limit": 3}'Python(标准库,无需依赖)
import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/search_posts",
data=json.dumps({"platform": "douyin", "keyword": "昆明 楼盘", "limit": 3}).encode(),
headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
method="POST",
)
data = json.load(urllib.request.urlopen(req, timeout=60))
for it in data["items"]:
print(it.get("url"), it.get("text", "")[:60])真实返回样例
下面这段是线上真实返回(已截断到 1 条,去掉了计费字段)。
{
"ok": true,
"platform": "douyin",
"tool": "search_posts",
"count": 1,
"items": [
{
"platform": "douyin",
"id": "7688294953998633947",
"url": "https://www.douyin.com/video/7688294953998633947",
"author": {
"id": "",
"handle": null,
"name": "昆明大华锦绣麓城"
},
"text": "改善大三居,6.5米超大横厅,又是小高层#昆明楼盘推荐 #精装现房 #书包房",
"created_at": "2026-09-22 17:51:03",
"stats": {
"likes": 55,
"comments": 0,
"shares": 0,
"views": 0,
"collects": 0
},
"cover": "https://p9-byteindex-sign.byteimg.com/tos-cn-p-0015/oQavJEEgqIIA7BQu8DiPuAHiBr0JaAT4i19Py~tplv-obj.image?rk3s=c8d089e8&x-expires=1792868473&x-signature=CFV01nYPfd6UVezhoZrrQWRB7Zw%3D"
}
]
}常见问题
要不要自己准备爬虫或代理?
不用。接口在服务端已经处理好抓取与清洗,你只拿到结构化 JSON;失败会自动退款。
可以商用吗?
返回的都是公开可见内容,可用于分析与产品功能;具体边界见「数据使用规范」页。
返回条数能调大吗?
limit 可以调,但单次调用是同步返回,建议按需分批拉取,避免单次超时。