Skip to content

TikTok帖子详情 API (V1) ​

GET
接口健康状态
健康 可用 少量可用 基本不可用 暂无数据
正在加载健康状态…

获取由帖子 ID 标识的 TikTok 帖子详情。使用该接口在进行内容审核、举报或相关互动分析之前查找已知的 TikTok 视频。

请求参数 ​

参数名位置类型必填默认值说明
tokenquerystring是-用于API访问的安全令牌。
postIdquerystring是-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 帖子详情,可能返回。

字段类型说明
idstringTikTok 帖子 ID。
descstringTikTok 帖子的说明文字。
createTimeinteger帖子发布时间,以 Unix 秒级时间戳返回。
textLanguagestring帖子文本的语言代码。
textTranslatablebooleanTikTok 是否将帖子文本标记为可翻译。
playlistIdstring与帖子关联的 TikTok 播放列表 ID,可能返回。
查询状态与分享7 个字段

data

TikTok 帖子详情及返回状态。成功响应有时只包含状态字段,未附带帖子详情。

字段类型说明
statusCodeintegerTikTok 帖子查询状态码。一份仅含状态的响应返回了非零值。
status_codeintegerTikTok 返回的另一项状态字段。一份没有帖子详情的实测响应中,此字段为 0。
status_msgstring帖子查询返回的状态消息,可能为空字符串。
itemInfoobject帖子信息外层对象,可能返回。
shareMetaobject分享帖子时使用的文本信息。
shareMeta.titlestring分享帖子时使用的展示标题。
shareMeta.descstring分享帖子时使用的展示描述。
作者10 个字段

data.itemInfo.itemStruct

字段类型说明
authorobject帖子作者的 TikTok 账号信息。
author.idstringTikTok 作者 ID。
author.secUidstringTikTok 用户的辅助标识符。
author.uniqueIdstringTikTok 用户的公开用户名。
author.nicknamestringTikTok 用户的显示名称。
author.verifiedboolean作者是否标记为已认证。
author.privateAccountbooleanTikTok 是否将该作者账号标记为私密。
author.avatarThumbstring作者头像缩略图 URL。
author.avatarMediumstring作者的中等尺寸头像 URL。
author.avatarLargerstring作者的较大尺寸头像 URL。
作者指标14 个字段

data.itemInfo.itemStruct

字段类型说明
authorStatsobject作者指标,以整数返回。
authorStats.followerCountinteger作者粉丝数。
authorStats.followingCountinteger作者关注数。
authorStats.videoCountinteger作者发布的视频数。
authorStats.heartCountinteger作者收到的点赞总数。
authorStats.heartintegerheart 字段返回的作者点赞计数。
authorStats.diggCountintegerTikTok 返回的作者 digg 计数。
authorStatsV2object作者指标,以十进制字符串返回。
authorStatsV2.followerCountstring作者粉丝数,以十进制字符串返回。
authorStatsV2.followingCountstring作者关注数,以十进制字符串返回。
authorStatsV2.videoCountstring作者发布的视频数,以十进制字符串返回。
authorStatsV2.heartCountstring作者收到的点赞总数,以十进制字符串返回。
authorStatsV2.heartstringheart 字段返回的作者点赞计数,以十进制字符串返回。
authorStatsV2.diggCountstringTikTok 返回的作者 digg 计数,以十进制字符串返回。
互动数据13 个字段

data.itemInfo.itemStruct

字段类型说明
statsobject帖子指标,以整数返回。
stats.playCountinteger帖子播放量。
stats.diggCountinteger帖子点赞数。
stats.commentCountinteger作品评论数。
stats.shareCountinteger帖子分享数。
stats.collectCountinteger帖子收藏数。
statsV2object帖子指标,以十进制字符串返回。
statsV2.playCountstring帖子播放量,以十进制字符串返回。
statsV2.diggCountstring帖子点赞数,以十进制字符串返回。
statsV2.commentCountstring帖子评论数,以十进制字符串返回。
statsV2.shareCountstring帖子分享数,以十进制字符串返回。
statsV2.collectCountstring帖子收藏数,以十进制字符串返回。
statsV2.repostCountstring帖子转发数,以十进制字符串返回。
说明文字与话题31 个字段

data.itemInfo.itemStruct

字段类型说明
textExtraarray帖子主说明文字的标注列表。
textExtra[]object附在帖子文本片段上的一条标注。
textExtra[].startinteger在对应文本中的起始偏移量,按 UTF-16 代码单元计。
textExtra[].endinteger在对应文本中的结束偏移量,按 UTF-16 代码单元计,结束位置不包含在内。
textExtra[].hashtagIdstring标注话题的 TikTok ID。
textExtra[].hashtagNamestring标注话题的显示名称。
textExtra[].typeinteger此文本标注的数字类型。
textExtra[].subTypeinteger此文本标注的数字子类型。
textExtra[].awemeIdstring与标注关联的 TikTok 帖子 ID,可能返回。
textExtra[].isCommerceboolean该文本标注是否被标记为与电商相关。
contentsarray帖子返回的结构化内容片段。
contents[]object帖子的一个结构化内容片段。
contents[].descstring此内容片段的说明文字。
contents[].textExtraarray此内容片段的文本标注列表。
contents[].textExtra[]object附在帖子文本片段上的一条标注。
contents[].textExtra[].startinteger在对应文本中的起始偏移量,按 UTF-16 代码单元计。
contents[].textExtra[].endinteger在对应文本中的结束偏移量,按 UTF-16 代码单元计,结束位置不包含在内。
contents[].textExtra[].hashtagIdstring标注话题的 TikTok ID。
contents[].textExtra[].hashtagNamestring标注话题的显示名称。
contents[].textExtra[].typeinteger此文本标注的数字类型。
contents[].textExtra[].subTypeinteger此文本标注的数字子类型。
contents[].textExtra[].awemeIdstring与标注关联的 TikTok 帖子 ID,可能返回。
contents[].textExtra[].isCommerceboolean该文本标注是否被标记为与电商相关。
challengesarray帖子关联的话题或挑战。
challenges[]object帖子关联的一个 TikTok 话题或挑战。
challenges[].idstring话题的 TikTok ID。
challenges[].titlestring话题的展示标题。
challenges[].descstring话题的展示描述。
challenges[].coverThumbstring该话题的缩略封面 URL。
challenges[].coverMediumstring该话题的中等尺寸封面 URL。
challenges[].coverLargerstring该话题的较大尺寸封面 URL。
视频与封面18 个字段

data.itemInfo.itemStruct.video

帖子的媒体、封面、播放文件与字幕。

字段类型说明
idstring媒体对象中返回的视频标识符。
videoIDstring媒体对象携带的另一个视频标识符。
durationinteger视频时长,单位为秒。
widthinteger视频画面宽度,单位为像素。
heightinteger视频画面高度,单位为像素。
ratiostringTikTok 返回的视频比例或分辨率标签。
definitionstring视频的清晰度展示标签。
formatstring视频的文件格式。
codecTypestring媒体的视频编解码器标签。
sizeinteger返回的视频文件大小。
bitrateinteger返回的视频码率。
coverstring视频封面图片地址。
dynamicCoverstring动态封面图片 URL,可能返回。
originCoverstring视频返回的原始封面图片 URL。
zoomCoverobject按尺寸标签索引的视频缩放封面图片。
zoomCover.{key}string对应尺寸标签的封面图片 URL。
playAddrstring视频返回的播放 URL。
downloadAddrstring视频返回的下载 URL,可能存在。
播放规格22 个字段

data.itemInfo.itemStruct.video

字段类型说明
PlayAddrStructobject播放文件信息及备用 URL。
PlayAddrStruct.Uristring播放文件的媒体引用。
PlayAddrStruct.Widthinteger播放画面宽度,单位为像素。
PlayAddrStruct.Heightinteger播放画面高度,单位为像素。
PlayAddrStruct.DataSizeinteger返回的播放文件大小。
PlayAddrStruct.UrlListarray播放文件的可用 URL 列表。
PlayAddrStruct.UrlList[]string一个可用的播放文件 URL。
bitrateInfoarray可用的播放版本及其码率和文件信息。
bitrateInfo[]object此视频的一个播放版本。
bitrateInfo[].Bitrateinteger此版本的码率。
bitrateInfo[].BitrateFPSinteger此播放版本的帧率。
bitrateInfo[].CodecTypestring此播放版本的编解码器标签。
bitrateInfo[].Formatstring此播放版本的文件格式。
bitrateInfo[].GearNamestring此播放选项返回的版本名称。
bitrateInfo[].QualityTypeinteger此版本的数字清晰度级别。
bitrateInfo[].PlayAddrobject播放文件信息及备用 URL。
bitrateInfo[].PlayAddr.Uristring播放文件的媒体引用。
bitrateInfo[].PlayAddr.Widthinteger播放画面宽度,单位为像素。
bitrateInfo[].PlayAddr.Heightinteger播放画面高度,单位为像素。
bitrateInfo[].PlayAddr.DataSizeinteger返回的播放文件大小。
bitrateInfo[].PlayAddr.UrlListarray播放文件的可用 URL 列表。
bitrateInfo[].PlayAddr.UrlList[]string一个可用的播放文件 URL。
字幕29 个字段

data.itemInfo.itemStruct.video

字段类型说明
claInfoobject视频的详细字幕信息。
claInfo.enableAutoCaptionboolean是否启用自动字幕。
claInfo.hasOriginalAudioboolean该视频是否标明含有原始音频。
claInfo.noCaptionReasonintegerTikTok 返回的字幕可用性数字原因码。
claInfo.originalLanguageInfoobject视频的原始语言信息。
claInfo.originalLanguageInfo.languagestring原始语言的显示名称。
claInfo.originalLanguageInfo.languageCodestring原始语言的语言代码。
claInfo.originalLanguageInfo.languageIDstring原始语言的标识符。
claInfo.captionInfosarray详细字幕信息中的字幕轨道列表。
claInfo.captionInfos[]object详细字幕信息中的一条字幕轨道。
claInfo.captionInfos[].captionFormatstring字幕轨道的文件格式。
claInfo.captionInfos[].languagestring字幕语言的显示名称。
claInfo.captionInfos[].languageCodestring该字幕轨道的语言代码。
claInfo.captionInfos[].languageIDstring该字幕轨道的语言标识符。
claInfo.captionInfos[].isAutoGenboolean字幕轨道是否被标记为自动生成。
claInfo.captionInfos[].isOriginalCaptionboolean该轨道是否被标记为原始字幕。
claInfo.captionInfos[].expirestring字幕 URL 到期时间,以 Unix 秒级时间戳字符串返回。
claInfo.captionInfos[].urlstring该字幕轨道返回的 URL。
claInfo.captionInfos[].urlListarray该字幕轨道的可用链接列表。
claInfo.captionInfos[].urlList[]string该字幕轨道的一个 URL。
subtitleInfosarray视频信息中另行列出的字幕轨道。
subtitleInfos[]object视频列出的一条字幕轨道。
subtitleInfos[].Formatstring字幕轨道返回的文件格式。
subtitleInfos[].LanguageCodeNamestring字幕轨道的语言代码标签。
subtitleInfos[].LanguageIDstring字幕轨道的语言标识符。
subtitleInfos[].Sizeinteger字幕资源的大小。
subtitleInfos[].Sourcestring字幕轨道的来源标签。
subtitleInfos[].Urlstring字幕资源返回的 URL。
subtitleInfos[].UrlExpireinteger字幕 URL 的到期时间,以 Unix 秒级时间戳返回。
音乐12 个字段

data.itemInfo.itemStruct

字段类型说明
musicobject帖子展示的公开音轨信息。
music.idstring音轨的 TikTok ID。
music.titlestring音轨的显示标题。
music.authorNamestring音轨的贡献者显示名称。
music.originalboolean音轨是否被标记为原声。
music.durationinteger返回的音轨时长。
music.isCopyrightedboolean音轨是否带有版权标记。
music.is_commerce_musicboolean音轨是否带有商用音乐标记。
music.coverThumbstring音轨的缩略封面 URL。
music.coverMediumstring音轨的中等尺寸封面 URL。
music.coverLargestring音轨的大尺寸封面 URL。
music.playUrlstring音轨返回的播放 URL。

响应示例 ​

正在加载响应示例…