参数
| 参数 | 必填 | 取值 |
|---|---|---|
| platform | 是 | tiktok / instagram / youtube / twitter / douyin / xiaohongshu |
| post_id | 是 | 内容 id;抖音、TikTok 也可直接传视频链接里的数字 id |
什么时候用它,而不是搜索结果
搜索结果适合「找」;get_post 适合「盯」。同一条内容每周重拉一次存库,就能算出它自己的增长曲线——搜索接口给的是当下快照,历史只能你自己落库。
字段口径
帖子类统一结构:id / url / author{id,handle,name} / text / created_at / stats{likes,comments,shares,views,collects} / cover。换平台不用改解析代码。
注意
公开页面的互动数是异步刷新的,拿到的就是那一刻的公开值;跨源对账时以同一时点为准。X 没有内容详情能力,需要走搜索结果里的条目。
复制即可运行
cURL
curl -s https://lucydomi.com/mcp/v1/get_post \
-H "Authorization: Bearer $BUSYBEE_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{"platform": "tiktok", "post_id": "7690199760430566669"}'Python(标准库)
import os, json, urllib.request
KEY = os.environ["BUSYBEE_API_KEY"]
req = urllib.request.Request(
"https://lucydomi.com/mcp/v1/get_post",
data=json.dumps({"platform": "tiktok", "post_id": "7690199760430566669"}).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": "get_post",
"count": 1,
"items": [
{
"platform": "tiktok",
"id": "7690199760430566669",
"url": "https://www.tiktok.com/@laceyglasley/video/7690199760430566669?_r=1&u_code=f010gde0glmh90&preview_pb=0&sharer_language=en&_d=f1i72admgdkmah&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": 69266,
"comments": 172,
"shares": 7795,
"views": 1025561,
"collects": 18090
},
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/owpgeRFaArQERuSqRE9CDLMEBEI3EAF5ACAufD~tplv-tiktokx-cropcenter-q:300:400:q70.heic?dr=8596&refresh_token=8e27f36d&x-expires=1793008800&x-signature=lHdmNCUkg8DnvObUZyvU0ghoIIk%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=1d1a97fc&idc=useast5&s=AWEME_DETAIL&sc=cover&biz_tag=tt_video"
}
]
}常见问题
能拿到私密或已删除内容吗?
不能。只读公开可见内容,删除或转为私密后接口会明确报错。
能给评论数和播放数的历史曲线吗?
不能。每次返回当下快照,历史需要你自己按周落库。
id 从哪来?
搜索结果的 items[].id 直接可用;也可以从分享链接里取。