能拿到什么
| 支持的能力 | 搜视频 / 搜达人 / 达人详情 / 达人作品 / 视频详情 / 拉评论 |
|---|---|
| 返回字段 | url、文案、作者（id/handle/昵称）、发布时间、播放点赞评论分享、封面 |
| 接入方式 | MCP（Streamable HTTP）或 REST（GET/POST 均可） |
| 计费 | 按次计费，失败自动退款 |
字段长什么样
不管哪个平台，帖子类返回都是同一套结构：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": "tiktok", "keyword": "coffee", "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": "tiktok", "keyword": "coffee", "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": "tiktok",
"tool": "search_posts",
"count": 1,
"items": [
{
"platform": "tiktok",
"id": "7690199760430566669",
"url": "https://www.tiktok.com/@laceyglasley/video/7690199760430566669?_r=1&u_code=f0m7125f4ia4bk&preview_pb=0&sharer_language=en&_d=f0m710il3k0l0c&share_item_id=7690199760430566669&source=h5_m",
"author": {
"id": "7066058701889012782",
"handle": "laceyglasley",
"name": "Lacey"
},
"text": "One for me, one for you 🤎🍯 Salted Honey Spanish Latte (1-16oz drink) • 1 tbsp sweetened condensed milk • 1 tsp honey • Dash of cinnamon • Pinch of salt • Dash of cinnamon • 2 tsp instant espresso + 2oz warm water (or double shot of espresso) • Ice • 3-4oz milk Enjoy! #coffeetok #coffeeathome #instantespresso #coffeerecipe #spanishlatte ",
"created_at": "2026-09-27T13:03:24+00:00",
"stats": {
"likes": 68801,
"comments": 169,
"shares": 7732,
"views": 1017504,
"collects": 17981
},
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/owpgeRFaArQERuSqRE9CDLMEBEI3EAF5ACAufD~tplv-tiktokx-origin.image?biz_tag=musically_video.video_cover&dr=8593&idc=useast8&ps=933b5bde&refresh_token=9ebdfa7c&s=SEARCH&sc=cover&shcp=c1333099&shp=d05b14bd&t=bacd0480&x-expires=1792933200&x-signature=lpbiHJbGP7CmVDG3kmOcPkenHQo%3D"
}
]
}常见问题
要不要自己准备爬虫或代理？
不用。接口在服务端已经处理好抓取与清洗，你只拿到结构化 JSON；失败会自动退款。
可以商用吗？
返回的都是公开可见内容，可用于分析与产品功能；具体边界见「数据使用规范」页。
返回条数能调大吗？
limit 可以调，但单次调用是同步返回，建议按需分批拉取，避免单次超时。