TikTok帖子详情 API (V1)
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…
获取由帖子 ID 标识的 TikTok 帖子详情。使用该接口在进行内容审核、举报或相关互动分析之前查找已知的 TikTok 视频。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 用于API访问的安全令牌。 |
postId | query | string | 是 | - | TikTok帖子的唯一ID。 |
代码示例
bash
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE'text
我想使用 JustOneAPI 提供的“帖子详情 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE
接口地址: BASE_URL + /api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/tiktok/post-details-v1-zh.json
请求参数说明:
- token (query): 用于API访问的安全令牌。 (必填)
- postId (query): TikTok帖子的唯一ID。 (必填)
返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。
响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败,请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 账户余额不足
- 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。python
import requests
BASE_URL = "https://api.justoneapi.com" # 由 OpenAPI servers 提供
url = BASE_URL + "/api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")js
const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
final String url = BASE_URL + "/api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}go
package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}php
<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/tiktok/get-post-detail/v1?token=YOUR_API_KEY&postId=VALUE';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}返回字段
业务成功时(code = 0)的主要返回字段。
帖子基本信息6 个字段
data.itemInfo.itemStruct
所请求的 TikTok 帖子详情,可能返回。
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | TikTok 帖子 ID。 |
desc | string | TikTok 帖子的说明文字。 |
createTime | integer | 帖子发布时间,以 Unix 秒级时间戳返回。 |
textLanguage | string | 帖子文本的语言代码。 |
textTranslatable | boolean | TikTok 是否将帖子文本标记为可翻译。 |
playlistId | string | 与帖子关联的 TikTok 播放列表 ID,可能返回。 |
查询状态与分享7 个字段
data
TikTok 帖子详情及返回状态。成功响应有时只包含状态字段,未附带帖子详情。
| 字段 | 类型 | 说明 |
|---|---|---|
statusCode | integer | TikTok 帖子查询状态码。一份仅含状态的响应返回了非零值。 |
status_code | integer | TikTok 返回的另一项状态字段。一份没有帖子详情的实测响应中,此字段为 0。 |
status_msg | string | 帖子查询返回的状态消息,可能为空字符串。 |
itemInfo | object | 帖子信息外层对象,可能返回。 |
shareMeta | object | 分享帖子时使用的文本信息。 |
shareMeta.title | string | 分享帖子时使用的展示标题。 |
shareMeta.desc | string | 分享帖子时使用的展示描述。 |
作者10 个字段
data.itemInfo.itemStruct
| 字段 | 类型 | 说明 |
|---|---|---|
author | object | 帖子作者的 TikTok 账号信息。 |
author.id | string | TikTok 作者 ID。 |
author.secUid | string | TikTok 用户的辅助标识符。 |
author.uniqueId | string | TikTok 用户的公开用户名。 |
author.nickname | string | TikTok 用户的显示名称。 |
author.verified | boolean | 作者是否标记为已认证。 |
author.privateAccount | boolean | TikTok 是否将该作者账号标记为私密。 |
author.avatarThumb | string | 作者头像缩略图 URL。 |
author.avatarMedium | string | 作者的中等尺寸头像 URL。 |
author.avatarLarger | string | 作者的较大尺寸头像 URL。 |
作者指标14 个字段
data.itemInfo.itemStruct
| 字段 | 类型 | 说明 |
|---|---|---|
authorStats | object | 作者指标,以整数返回。 |
authorStats.followerCount | integer | 作者粉丝数。 |
authorStats.followingCount | integer | 作者关注数。 |
authorStats.videoCount | integer | 作者发布的视频数。 |
authorStats.heartCount | integer | 作者收到的点赞总数。 |
authorStats.heart | integer | heart 字段返回的作者点赞计数。 |
authorStats.diggCount | integer | TikTok 返回的作者 digg 计数。 |
authorStatsV2 | object | 作者指标,以十进制字符串返回。 |
authorStatsV2.followerCount | string | 作者粉丝数,以十进制字符串返回。 |
authorStatsV2.followingCount | string | 作者关注数,以十进制字符串返回。 |
authorStatsV2.videoCount | string | 作者发布的视频数,以十进制字符串返回。 |
authorStatsV2.heartCount | string | 作者收到的点赞总数,以十进制字符串返回。 |
authorStatsV2.heart | string | heart 字段返回的作者点赞计数,以十进制字符串返回。 |
authorStatsV2.diggCount | string | TikTok 返回的作者 digg 计数,以十进制字符串返回。 |
互动数据13 个字段
data.itemInfo.itemStruct
| 字段 | 类型 | 说明 |
|---|---|---|
stats | object | 帖子指标,以整数返回。 |
stats.playCount | integer | 帖子播放量。 |
stats.diggCount | integer | 帖子点赞数。 |
stats.commentCount | integer | 作品评论数。 |
stats.shareCount | integer | 帖子分享数。 |
stats.collectCount | integer | 帖子收藏数。 |
statsV2 | object | 帖子指标,以十进制字符串返回。 |
statsV2.playCount | string | 帖子播放量,以十进制字符串返回。 |
statsV2.diggCount | string | 帖子点赞数,以十进制字符串返回。 |
statsV2.commentCount | string | 帖子评论数,以十进制字符串返回。 |
statsV2.shareCount | string | 帖子分享数,以十进制字符串返回。 |
statsV2.collectCount | string | 帖子收藏数,以十进制字符串返回。 |
statsV2.repostCount | string | 帖子转发数,以十进制字符串返回。 |
说明文字与话题31 个字段
data.itemInfo.itemStruct
| 字段 | 类型 | 说明 |
|---|---|---|
textExtra | array | 帖子主说明文字的标注列表。 |
textExtra[] | object | 附在帖子文本片段上的一条标注。 |
textExtra[].start | integer | 在对应文本中的起始偏移量,按 UTF-16 代码单元计。 |
textExtra[].end | integer | 在对应文本中的结束偏移量,按 UTF-16 代码单元计,结束位置不包含在内。 |
textExtra[].hashtagId | string | 标注话题的 TikTok ID。 |
textExtra[].hashtagName | string | 标注话题的显示名称。 |
textExtra[].type | integer | 此文本标注的数字类型。 |
textExtra[].subType | integer | 此文本标注的数字子类型。 |
textExtra[].awemeId | string | 与标注关联的 TikTok 帖子 ID,可能返回。 |
textExtra[].isCommerce | boolean | 该文本标注是否被标记为与电商相关。 |
contents | array | 帖子返回的结构化内容片段。 |
contents[] | object | 帖子的一个结构化内容片段。 |
contents[].desc | string | 此内容片段的说明文字。 |
contents[].textExtra | array | 此内容片段的文本标注列表。 |
contents[].textExtra[] | object | 附在帖子文本片段上的一条标注。 |
contents[].textExtra[].start | integer | 在对应文本中的起始偏移量,按 UTF-16 代码单元计。 |
contents[].textExtra[].end | integer | 在对应文本中的结束偏移量,按 UTF-16 代码单元计,结束位置不包含在内。 |
contents[].textExtra[].hashtagId | string | 标注话题的 TikTok ID。 |
contents[].textExtra[].hashtagName | string | 标注话题的显示名称。 |
contents[].textExtra[].type | integer | 此文本标注的数字类型。 |
contents[].textExtra[].subType | integer | 此文本标注的数字子类型。 |
contents[].textExtra[].awemeId | string | 与标注关联的 TikTok 帖子 ID,可能返回。 |
contents[].textExtra[].isCommerce | boolean | 该文本标注是否被标记为与电商相关。 |
challenges | array | 帖子关联的话题或挑战。 |
challenges[] | object | 帖子关联的一个 TikTok 话题或挑战。 |
challenges[].id | string | 话题的 TikTok ID。 |
challenges[].title | string | 话题的展示标题。 |
challenges[].desc | string | 话题的展示描述。 |
challenges[].coverThumb | string | 该话题的缩略封面 URL。 |
challenges[].coverMedium | string | 该话题的中等尺寸封面 URL。 |
challenges[].coverLarger | string | 该话题的较大尺寸封面 URL。 |
视频与封面18 个字段
data.itemInfo.itemStruct.video
帖子的媒体、封面、播放文件与字幕。
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 媒体对象中返回的视频标识符。 |
videoID | string | 媒体对象携带的另一个视频标识符。 |
duration | integer | 视频时长,单位为秒。 |
width | integer | 视频画面宽度,单位为像素。 |
height | integer | 视频画面高度,单位为像素。 |
ratio | string | TikTok 返回的视频比例或分辨率标签。 |
definition | string | 视频的清晰度展示标签。 |
format | string | 视频的文件格式。 |
codecType | string | 媒体的视频编解码器标签。 |
size | integer | 返回的视频文件大小。 |
bitrate | integer | 返回的视频码率。 |
cover | string | 视频封面图片地址。 |
dynamicCover | string | 动态封面图片 URL,可能返回。 |
originCover | string | 视频返回的原始封面图片 URL。 |
zoomCover | object | 按尺寸标签索引的视频缩放封面图片。 |
zoomCover.{key} | string | 对应尺寸标签的封面图片 URL。 |
playAddr | string | 视频返回的播放 URL。 |
downloadAddr | string | 视频返回的下载 URL,可能存在。 |
播放规格22 个字段
data.itemInfo.itemStruct.video
| 字段 | 类型 | 说明 |
|---|---|---|
PlayAddrStruct | object | 播放文件信息及备用 URL。 |
PlayAddrStruct.Uri | string | 播放文件的媒体引用。 |
PlayAddrStruct.Width | integer | 播放画面宽度,单位为像素。 |
PlayAddrStruct.Height | integer | 播放画面高度,单位为像素。 |
PlayAddrStruct.DataSize | integer | 返回的播放文件大小。 |
PlayAddrStruct.UrlList | array | 播放文件的可用 URL 列表。 |
PlayAddrStruct.UrlList[] | string | 一个可用的播放文件 URL。 |
bitrateInfo | array | 可用的播放版本及其码率和文件信息。 |
bitrateInfo[] | object | 此视频的一个播放版本。 |
bitrateInfo[].Bitrate | integer | 此版本的码率。 |
bitrateInfo[].BitrateFPS | integer | 此播放版本的帧率。 |
bitrateInfo[].CodecType | string | 此播放版本的编解码器标签。 |
bitrateInfo[].Format | string | 此播放版本的文件格式。 |
bitrateInfo[].GearName | string | 此播放选项返回的版本名称。 |
bitrateInfo[].QualityType | integer | 此版本的数字清晰度级别。 |
bitrateInfo[].PlayAddr | object | 播放文件信息及备用 URL。 |
bitrateInfo[].PlayAddr.Uri | string | 播放文件的媒体引用。 |
bitrateInfo[].PlayAddr.Width | integer | 播放画面宽度,单位为像素。 |
bitrateInfo[].PlayAddr.Height | integer | 播放画面高度,单位为像素。 |
bitrateInfo[].PlayAddr.DataSize | integer | 返回的播放文件大小。 |
bitrateInfo[].PlayAddr.UrlList | array | 播放文件的可用 URL 列表。 |
bitrateInfo[].PlayAddr.UrlList[] | string | 一个可用的播放文件 URL。 |
字幕29 个字段
data.itemInfo.itemStruct.video
| 字段 | 类型 | 说明 |
|---|---|---|
claInfo | object | 视频的详细字幕信息。 |
claInfo.enableAutoCaption | boolean | 是否启用自动字幕。 |
claInfo.hasOriginalAudio | boolean | 该视频是否标明含有原始音频。 |
claInfo.noCaptionReason | integer | TikTok 返回的字幕可用性数字原因码。 |
claInfo.originalLanguageInfo | object | 视频的原始语言信息。 |
claInfo.originalLanguageInfo.language | string | 原始语言的显示名称。 |
claInfo.originalLanguageInfo.languageCode | string | 原始语言的语言代码。 |
claInfo.originalLanguageInfo.languageID | string | 原始语言的标识符。 |
claInfo.captionInfos | array | 详细字幕信息中的字幕轨道列表。 |
claInfo.captionInfos[] | object | 详细字幕信息中的一条字幕轨道。 |
claInfo.captionInfos[].captionFormat | string | 字幕轨道的文件格式。 |
claInfo.captionInfos[].language | string | 字幕语言的显示名称。 |
claInfo.captionInfos[].languageCode | string | 该字幕轨道的语言代码。 |
claInfo.captionInfos[].languageID | string | 该字幕轨道的语言标识符。 |
claInfo.captionInfos[].isAutoGen | boolean | 字幕轨道是否被标记为自动生成。 |
claInfo.captionInfos[].isOriginalCaption | boolean | 该轨道是否被标记为原始字幕。 |
claInfo.captionInfos[].expire | string | 字幕 URL 到期时间,以 Unix 秒级时间戳字符串返回。 |
claInfo.captionInfos[].url | string | 该字幕轨道返回的 URL。 |
claInfo.captionInfos[].urlList | array | 该字幕轨道的可用链接列表。 |
claInfo.captionInfos[].urlList[] | string | 该字幕轨道的一个 URL。 |
subtitleInfos | array | 视频信息中另行列出的字幕轨道。 |
subtitleInfos[] | object | 视频列出的一条字幕轨道。 |
subtitleInfos[].Format | string | 字幕轨道返回的文件格式。 |
subtitleInfos[].LanguageCodeName | string | 字幕轨道的语言代码标签。 |
subtitleInfos[].LanguageID | string | 字幕轨道的语言标识符。 |
subtitleInfos[].Size | integer | 字幕资源的大小。 |
subtitleInfos[].Source | string | 字幕轨道的来源标签。 |
subtitleInfos[].Url | string | 字幕资源返回的 URL。 |
subtitleInfos[].UrlExpire | integer | 字幕 URL 的到期时间,以 Unix 秒级时间戳返回。 |
音乐12 个字段
data.itemInfo.itemStruct
| 字段 | 类型 | 说明 |
|---|---|---|
music | object | 帖子展示的公开音轨信息。 |
music.id | string | 音轨的 TikTok ID。 |
music.title | string | 音轨的显示标题。 |
music.authorName | string | 音轨的贡献者显示名称。 |
music.original | boolean | 音轨是否被标记为原声。 |
music.duration | integer | 返回的音轨时长。 |
music.isCopyrighted | boolean | 音轨是否带有版权标记。 |
music.is_commerce_music | boolean | 音轨是否带有商用音乐标记。 |
music.coverThumb | string | 音轨的缩略封面 URL。 |
music.coverMedium | string | 音轨的中等尺寸封面 URL。 |
music.coverLarge | string | 音轨的大尺寸封面 URL。 |
music.playUrl | string | 音轨返回的播放 URL。 |
响应示例
正在加载响应示例…