参数
| 参数 | 必填 | 取值 |
|---|---|---|
| platform | 是 | tiktok / instagram / youtube / twitter / douyin / xiaohongshu |
| creator | 是 | 账号 handle 或平台内部 id |
| limit | 否 | 返回条数，默认 10；算中位数取最近 5–10 条即可 |
三个能直接算出来的指标
① 互动中位数 = 最近 N 条 (likes+comments+shares) 的中位数；② 发文节奏 = 相邻两条的发布时间间隔分布；③ 爆款率 = 互动高于自身中位数 3 倍的内容占比。这三个数比粉丝数有用得多。
快照与趋势
接口给当下快照。把每周的结果按 (platform, handle, 周次) 幂等落库，重复跑不产生重复行，两周之后就能看环比。
成本控制
日常监控只重拉「已入库」的那一小批账号；探索期的候选账号用一次即可，不要全量周更。
复制即可运行
cURL
curl -s https://lucydomi.com/mcp/v1/list_creator_posts \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"platform": "tiktok", "creator": "yourcoffeedude", "limit": 10}'Python（标准库）
import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/list_creator_posts",
data=json.dumps({"platform": "tiktok", "creator": "yourcoffeedude", "limit": 10}).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": "list_creator_posts",
"count": 2,
"items": [
{
"platform": "tiktok",
"id": "7160656578293697798",
"url": "https://www.tiktok.com/@yourcoffeedude/video/7160656578293697798?_r=1&u_code=ebljhhba8m5jj5&preview_pb=0&sharer_language=en&_d=ebljg2e6543055&share_item_id=7160656578293697798&source=h5_m",
"author": {
"id": "7096781983184159749",
"handle": "yourcoffeedude",
"name": "YourCoffeeDude"
},
"text": "My obsession ☕️🙌🏽",
"created_at": "2022-10-31T12:44:46+00:00",
"stats": {
"likes": 97430,
"comments": 215,
"shares": 1732,
"views": 633749,
"collects": 5792
},
"cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-p-0068/a33f0a309b394cc0aae038b21d3ad2d3_1667220288~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=c0728649&x-expires=1793008800&x-signature=wQmPtjXDxildr3JszPcwfmglsfY%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover"
},
{
"platform": "tiktok",
"id": "7212684522750479622",
"url": "https://www.tiktok.com/@yourcoffeedude/video/7212684522750479622?_r=1&u_code=ebljhhba8m5jj5&preview_pb=0&sharer_language=en&_d=ebljg2e6543055&share_item_id=7212684522750479622&source=h5_m",
"author": {
"id": "7096781983184159749",
"handle": "yourcoffeedude",
"name": "YourCoffeeDude"
},
"text": "Foamy Cinnamon Dalgona Coffee ☕️✨",
"created_at": "2023-03-20T17:39:43+00:00",
"stats": {
"likes": 588711,
"comments": 992,
"shares": 28141,
"views": 10979909,
"collects": 93224
},
"cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-aiso/o8PdShiVEEfuCheDDk4QjZnZ83bBABnilI0Low~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=9232&refresh_token=287d2420&x-expires=1793008800&x-signature=KUIKLmXEW3%2BeT7LdS9ecqHEMtRg%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover&item=7212684522750479622"
}
]
}常见问题
能拉指定时间范围吗？
不支持按时间筛选，取最近 N 条后在你这一侧按 created_at 过滤。
为什么同一条内容两次互动数不同？
公开互动数是异步刷新的，两次调用之间会变；对账时以同一时点为准。
作品很多怎么办？
按需分批；同步返回不适合一次拉几百条。