Post
获取单个 TikTok 视频。
GET | POST /v1/tiktok/post参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。
传入内容
| 传入 | 读取内容 | 说明 |
|---|---|---|
id | 该视频 | 数字 id、URL 或分享链接 |
每次调用只传一个来源。所有标识符也都接受页面 URL。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | Numeric video id, or the video URL / share link (vm.tiktok.com/…). |
请求
curl "https://gateway.apinoa.com/v1/tiktok/post?id=7698770783367171359" \
-H "x-api-key: $APINOA_API_KEY"响应
在 data 中返回 Post。 真实响应的节选：数组只保留前几项，长文本已截断。
{
"success": true,
"data": {
"platform": "tiktok",
"id": "7698770783367171359",
"url": "https://www.tiktok.com/@tiktok/video/769877078336…",
"author": {
"platform": "tiktok",
"id": "107955",
"handle": "tiktok",
"displayName": "TikTok",
"url": "https://www.tiktok.com/@tiktok",
"avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-usea…",
"verified": true,
"counts": {
"followers": 96400000,
"following": 1,
"posts": 1512
},
"ext": {
"secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBS…",
"signature": "Your next discovery is waiting on TikTok.",
"totalLikes": 466000000,
"likesGiven": 4377
}
},
"text": "The throwback sounds we didn’t know we were missi…",
"createdAt": "2026-10-20T15:23:03.000Z",
"lang": "en",
"media": [
{
"type": "video",
"url": "https://www.tiktok.com/aweme/v1/play/?faid=1988&f…",
"width": 720,
"height": 1280,
"thumbnailUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-usea…",
"durationSec": 105,
"variants": [
{
"url": "https://www.tiktok.com/aweme/v1/play/?faid=1988&f…",
"width": 720,
"height": 1280,
"bitrate": 1710350,
"contentType": "video/mp4"
}
],
"ext": {
"playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/…",
"downloadAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/…",
"dynamicCover": "https://p19-common-sign.tiktokcdn-us.com/tos-usea…",
"definition": "720p",
"videoQuality": "normal",
"ratio": "720p",
"codec": "h264",
"format": "mp4",
"bitrate": 1710350,
"sizeBytes": 22592237,
"loudness": -23.6,
"peak": 0.53703,
"hasOriginalAudio": true,
"autoCaption": true,
"bitrateVariants": [
{
"gearName": "normal_720_0",
"fps": 30,
"codec": "h264",
"sizeBytes": 22592237
}
],
"subtitles": [
{
"lang": "eng-US",
"langId": "2",
"url": "https://v16m-webapp.tiktokcdn-us.com/33b86e5d3f3c…",
"format": "webvtt",
"source": "ASR"
}
]
}
}
],
"metrics": {
"likes": 5229,
"comments": 1640,
"shares": 503,
"views": 351700,
"reposts": 0,
"saves": 450
},
"entities": {
"mentions": [
{
"handle": "adambarrera",
"id": "6707847482024723461"
}
]
},
"audio": {
"id": "7698770883132853023",
"title": "original sound",
"artist": "TikTok",
"url": "https://v16m.tiktokcdn-us.com/c8470014c6bdd52cea2…"
},
"ext": {
"music": {
"original": true,
"coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-usea…",
"durationSec": 105,
"isCommerceMusic": true
},
"duetEnabled": true,
"stitchEnabled": true,
"diversificationLabels": [
"Music"
],
"locationCreated": "US",
"suggestedWords": [
"nostalgia sounds"
]
}
}
}错误
| 状态 | 代码 | 含义 |
|---|---|---|
| 400 | INVALID_PARAMS | 参数缺失、未知或超出范围。消息中会指出是哪一个。 |
| 401 | UNAUTHORIZED | 缺少 x-api-key 请求头，或密钥已吊销或未知。 |
| 402 | INSUFFICIENT_BALANCE | 余额不足以支付本次调用。请在控制台充值。 |
| 404 | NOT_FOUND | 账号、帖子或分组不存在，或为私密、已删除、有年龄限制。 |
| 429 | MARKETPLACE_SATURATED | 并发调用过多。请等待 Retry-After 秒后重试。 |
| 502 | UPSTREAM_ERROR | 平台返回了无法使用的内容。请退避后重试。 |
全部错误代码见 Errors。失败的调用不计费。
价格
价格 每次调用 $0.001。标价；单日调用超过 1,000 次后单价下调。