TikTok作品搜索 API (V1)
通过关键词搜索 TikTok 帖子,提供偏移分页、排序、发布时间和区域控制。使用该接口支持区域内容发现、主题研究或监控与关键词相关的视频。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 用于API访问的安全令牌。 |
keyword | query | string | 是 | - | 搜索关键词。 |
offset | query | integer | 否 | 0 | 分页偏移量,从0开始,步长为20。 |
sortType | query | string | 否 | RELEVANCE | 搜索结果排序标准。 可用值: - RELEVANCE: 相关性(默认)- MOST_LIKED: 点赞最多 |
publishTime | query | string | 否 | ALL | 按发布时间筛选帖子。 可用值: - ALL: 全部时间- ONE_DAY: 最近24小时- ONE_WEEK: 最近7天- ONE_MONTH: 最近30天- THREE_MONTHS: 最近90天- HALF_YEAR: 最近180天 |
region | query | string | 否 | US | ISO 3166-1 alpha-2 国家代码(例如 'US'、'GB')。 |
代码示例
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/tiktok/search-post/v1?token=YOUR_API_KEY&keyword=VALUE'我想使用 JustOneAPI 提供的“作品搜索 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/tiktok/search-post/v1?token=YOUR_API_KEY&keyword=VALUE
接口地址: BASE_URL + /api/tiktok/search-post/v1?token=YOUR_API_KEY&keyword=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/tiktok/post-search-v1-zh.json
请求参数说明:
- token (query): 用于API访问的安全令牌。 (必填)
- keyword (query): 搜索关键词。 (必填)
- offset (query): 分页偏移量,从0开始,步长为20。
- sortType (query): 搜索结果排序标准。
可用值:
- `RELEVANCE`: 相关性(默认)
- `MOST_LIKED`: 点赞最多
- publishTime (query): 按发布时间筛选帖子。
可用值:
- `ALL`: 全部时间
- `ONE_DAY`: 最近24小时
- `ONE_WEEK`: 最近7天
- `ONE_MONTH`: 最近30天
- `THREE_MONTHS`: 最近90天
- `HALF_YEAR`: 最近180天
- region (query): ISO 3166-1 alpha-2 国家代码(例如 'US'、'GB')。
返回格式: 请根据实际 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 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。import requests
BASE_URL = "https://api.justoneapi.com" # 由 OpenAPI servers 提供
url = BASE_URL + "/api/tiktok/search-post/v1?token=YOUR_API_KEY&keyword=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")const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/tiktok/search-post/v1?token=YOUR_API_KEY&keyword=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`);
}
}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/search-post/v1?token=YOUR_API_KEY&keyword=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");
}
}
}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/search-post/v1?token=YOUR_API_KEY&keyword=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
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/tiktok/search-post/v1?token=YOUR_API_KEY&keyword=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
TikTok 帖子搜索的一页结果及分页信息。
| 字段 | 类型 | 说明 |
|---|---|---|
status_code | integer | TikTok 返回的搜索状态数字代码。 |
has_more | integer | 分页标记。值为 1 表示还有结果,值为 0 表示结果已结束。 |
cursor | integer | 分页游标。如果 has_more 表示还有结果,将此游标作为下一次请求的 offset。 |
aweme_list | array | null | TikTok 额外返回的帖子列表,可能为空数组或 null。搜索条目见 search_item_list。 |
search_item_list | array | null | 当前页的搜索条目。结果结束时此字段可能为 null。不同页可能出现同一帖子,可按每个条目的 aweme_info.aweme_id 去重。 |
search_item_list[] | object | 一条搜索结果。 |
帖子内容23 个字段
data.search_item_list[].aweme_info
搜索条目对应的帖子数据,包括内容、作者及可用的媒体元数据。
| 字段 | 类型 | 说明 |
|---|---|---|
aweme_id | string | 以文本表示的 TikTok 帖子 ID。 |
aweme_type | integer | TikTok 返回的帖子类型数字代码。 |
author_user_id | integer | TikTok 作者数字 ID。在 JavaScript 中请使用文本字段 author.uid,避免 ID 精度丢失。 |
create_time | integer | 帖子发布时间,Unix 时间戳,单位为秒。 |
desc | string | TikTok 返回的帖子文案。 |
desc_language | string | 帖子文案返回的语言代码。 |
content_desc | string | 帖子随附的补充描述。 |
search_desc | string | 供搜索结果展示的描述文字。 |
share_url | string | 帖子的分享链接。 |
region | string | 帖子返回的地区代码。 |
group_id | string | 以文本表示的内容分组标识。 |
is_ads | boolean | TikTok 是否将帖子标记为广告。 |
is_paid_content | boolean | TikTok 是否将帖子标记为付费内容。 |
is_close_friends_only | boolean | 帖子是否标记为仅亲密好友可见。 |
is_top | integer | 帖子返回的置顶数字标记。 |
is_vr | boolean | 帖子是否标记为 VR 内容。 |
has_danmaku | boolean | 帖子是否标记为含弹幕。 |
is_description_translatable | boolean | TikTok 是否将描述标记为可翻译。 |
is_text_sticker_translatable | boolean | TikTok 是否将文字贴纸标记为可翻译。 |
is_title_translatable | boolean | TikTok 是否将标题标记为可翻译。 |
prevent_download | boolean | 帖子是否标记为限制下载。 |
music_begin_time_in_ms | integer | 帖子中的音乐起始位置,单位为毫秒。 |
no_selected_music | boolean | TikTok 是否将帖子标记为未选配乐。 |
作者资料15 个字段
data.search_item_list[].aweme_info.author
发布帖子的 TikTok 账号。
| 字段 | 类型 | 说明 |
|---|---|---|
uid | string | 以文本表示的 TikTok 作者 ID。使用此字段可保留完整数字。 |
unique_id | string | 公开的 TikTok 用户名。 |
nickname | string | 作者的展示名称。 |
short_id | string | 作者返回的短标识字段。 |
custom_verify | string | 账号返回的自定义认证标签。 |
enterprise_verify_reason | string | 账号返回的企业认证说明。 |
verification_type | integer | 账号返回的认证类型数字代码。 |
follower_count | integer | 平台返回的作者粉丝数。 |
following_count | integer | 作者关注的账号数。 |
total_favorited | integer | 作者作品获得的点赞总量。 |
aweme_count | integer | 平台返回的作者发帖数量。 |
with_commerce_entry | boolean | 账号是否标记有电商入口。 |
with_shop_entry | boolean | 账号是否标记有店铺入口。 |
search_user_desc | string | 搜索结果中随作者返回的描述文字。 |
search_user_name | string | 搜索结果中随作者返回的名称文字。 |
作者头像35 个字段
data.search_item_list[].aweme_info.author
| 字段 | 类型 | 说明 |
|---|---|---|
avatar_168x168 | object | 作者头像的 168x168 版本。 |
avatar_168x168.uri | string | TikTok 返回的媒体标识或 URI。 |
avatar_168x168.url_list | array | 此媒体版本返回的访问地址列表。 |
avatar_168x168.url_list[] | string | 此媒体版本的一个访问地址。 |
avatar_168x168.width | integer | 媒体宽度,存在时以像素表示。 |
avatar_168x168.height | integer | 媒体高度,存在时以像素表示。 |
avatar_168x168.data_size | integer | 此媒体版本返回的数据大小值。 |
avatar_300x300 | object | 作者头像的 300x300 版本。 |
avatar_300x300.uri | string | TikTok 返回的媒体标识或 URI。 |
avatar_300x300.url_list | array | 此媒体版本返回的访问地址列表。 |
avatar_300x300.url_list[] | string | 此媒体版本的一个访问地址。 |
avatar_300x300.width | integer | 媒体宽度,存在时以像素表示。 |
avatar_300x300.height | integer | 媒体高度,存在时以像素表示。 |
avatar_300x300.data_size | integer | 此媒体版本返回的数据大小值。 |
avatar_larger | object | 较大的作者头像版本。 |
avatar_larger.uri | string | TikTok 返回的媒体标识或 URI。 |
avatar_larger.url_list | array | 此媒体版本返回的访问地址列表。 |
avatar_larger.url_list[] | string | 此媒体版本的一个访问地址。 |
avatar_larger.width | integer | 媒体宽度,存在时以像素表示。 |
avatar_larger.height | integer | 媒体高度,存在时以像素表示。 |
avatar_larger.data_size | integer | 此媒体版本返回的数据大小值。 |
avatar_medium | object | 中等尺寸的作者头像版本。 |
avatar_medium.uri | string | TikTok 返回的媒体标识或 URI。 |
avatar_medium.url_list | array | 此媒体版本返回的访问地址列表。 |
avatar_medium.url_list[] | string | 此媒体版本的一个访问地址。 |
avatar_medium.width | integer | 媒体宽度,存在时以像素表示。 |
avatar_medium.height | integer | 媒体高度,存在时以像素表示。 |
avatar_medium.data_size | integer | 此媒体版本返回的数据大小值。 |
avatar_thumb | object | 作者头像的缩略版本。 |
avatar_thumb.uri | string | TikTok 返回的媒体标识或 URI。 |
avatar_thumb.url_list | array | 此媒体版本返回的访问地址列表。 |
avatar_thumb.url_list[] | string | 此媒体版本的一个访问地址。 |
avatar_thumb.width | integer | 媒体宽度,存在时以像素表示。 |
avatar_thumb.height | integer | 媒体高度,存在时以像素表示。 |
avatar_thumb.data_size | integer | 此媒体版本返回的数据大小值。 |
互动数据10 个字段
data.search_item_list[].aweme_info.statistics
帖子返回的互动指标。
| 字段 | 类型 | 说明 |
|---|---|---|
aweme_id | string | 以文本表示的统计对应帖子 ID。 |
play_count | integer | 帖子返回的播放或观看次数。 |
digg_count | integer | 平台返回的帖子点赞数。 |
comment_count | integer | 平台返回的帖子评论数。 |
share_count | integer | 平台返回的帖子分享数。 |
collect_count | integer | 平台返回的帖子收藏数。 |
download_count | integer | 帖子返回的下载次数。 |
repost_count | integer | 平台返回的帖子转发次数。 |
forward_count | integer | 帖子单独返回的转发计数。 |
whatsapp_share_count | integer | 返回的 WhatsApp 分享次数。 |
视频与封面41 个字段
data.search_item_list[].aweme_info.video
视频元数据及媒体版本,存在时可用。
| 字段 | 类型 | 说明 |
|---|---|---|
duration | integer | 视频时长,单位为毫秒。 |
width | integer | 视频宽度,单位为像素。 |
height | integer | 视频高度,单位为像素。 |
ratio | string | TikTok 返回的视频分辨率或比例标签。 |
has_watermark | boolean | 视频是否标记为含水印。 |
cover_is_custom | boolean | 视频是否标记为使用自定义封面。 |
big_thumbs | array | 视频的缩略图拼图元数据,存在时可用。 |
big_thumbs[] | object | 一个缩略图拼图条目。 |
big_thumbs[].img_num | integer | 此拼图条目返回的缩略图数量。 |
big_thumbs[].img_url | string | 缩略图拼图地址。 |
big_thumbs[].img_x_len | integer | 拼图返回的缩略图列数。 |
big_thumbs[].img_y_len | integer | 拼图返回的缩略图行数。 |
big_thumbs[].img_x_size | integer | 单张缩略图的宽度,单位为像素。 |
big_thumbs[].img_y_size | integer | 单张缩略图的高度,单位为像素。 |
big_thumbs[].img_urls | array | 此条目返回的缩略图拼图地址列表。 |
big_thumbs[].img_urls[] | string | 一个缩略图拼图地址。 |
cover | object | 视频封面图片。 |
cover.uri | string | TikTok 返回的媒体标识或 URI。 |
cover.url_list | array | 此媒体版本返回的访问地址列表。 |
cover.url_list[] | string | 此媒体版本的一个访问地址。 |
cover.width | integer | 媒体宽度,存在时以像素表示。 |
cover.height | integer | 媒体高度,存在时以像素表示。 |
cover.data_size | integer | 此媒体版本返回的数据大小值。 |
origin_cover | object | 视频返回的原始封面版本。 |
origin_cover.uri | string | TikTok 返回的媒体标识或 URI。 |
origin_cover.url_list | array | 此媒体版本返回的访问地址列表。 |
origin_cover.url_list[] | string | 此媒体版本的一个访问地址。 |
origin_cover.width | integer | 媒体宽度,存在时以像素表示。 |
origin_cover.height | integer | 媒体高度,存在时以像素表示。 |
origin_cover.data_size | integer | 此媒体版本返回的数据大小值。 |
dynamic_cover | object | 视频的动态封面版本。 |
dynamic_cover.uri | string | TikTok 返回的媒体标识或 URI。 |
dynamic_cover.url_list | array | 此媒体版本返回的访问地址列表。 |
dynamic_cover.url_list[] | string | 此媒体版本的一个访问地址。 |
dynamic_cover.width | integer | 媒体宽度,存在时以像素表示。 |
dynamic_cover.height | integer | 媒体高度,存在时以像素表示。 |
dynamic_cover.data_size | integer | 此媒体版本返回的数据大小值。 |
animated_cover | object | 视频的动画封面版本。 |
animated_cover.uri | string | TikTok 返回的媒体标识或 URI。 |
animated_cover.url_list | array | 此媒体版本返回的访问地址列表。 |
animated_cover.url_list[] | string | 此媒体版本的一个访问地址。 |
播放与下载地址50 个字段
data.search_item_list[].aweme_info.video
| 字段 | 类型 | 说明 |
|---|---|---|
bit_rate | array | 可用的视频播放版本及其编码元数据。 |
bit_rate[] | object | 一个视频播放版本。 |
bit_rate[].bit_rate | integer | 此播放版本返回的码率。 |
bit_rate[].fps | integer | 此播放版本返回的每秒帧数。 |
bit_rate[].gear_name | string | 此播放版本的清晰度档位标签。 |
bit_rate[].quality_type | integer | 此播放版本返回的清晰度数字代码。 |
bit_rate[].HDR_type | string | 此播放版本返回的 HDR 类型标签。 |
bit_rate[].HDR_bit | string | 此播放版本返回的 HDR 位深标签。 |
bit_rate[].play_addr | object | 此播放版本的地址元数据。 |
bit_rate[].play_addr.uri | string | TikTok 返回的媒体标识或 URI。 |
bit_rate[].play_addr.url_list | array | 此媒体版本返回的访问地址列表。 |
bit_rate[].play_addr.url_list[] | string | 此媒体版本的一个访问地址。 |
bit_rate[].play_addr.width | integer | 媒体宽度,存在时以像素表示。 |
bit_rate[].play_addr.height | integer | 媒体高度,存在时以像素表示。 |
bit_rate[].play_addr.data_size | integer | 此媒体版本返回的数据大小值。 |
play_addr | object | 视频的播放媒体版本。 |
play_addr.uri | string | TikTok 返回的媒体标识或 URI。 |
play_addr.url_list | array | 此媒体版本返回的访问地址列表。 |
play_addr.url_list[] | string | 此媒体版本的一个访问地址。 |
play_addr.width | integer | 媒体宽度,存在时以像素表示。 |
play_addr.height | integer | 媒体高度,存在时以像素表示。 |
play_addr.data_size | integer | 此媒体版本返回的数据大小值。 |
play_addr_h264 | object | H.264 播放媒体版本。 |
play_addr_h264.uri | string | TikTok 返回的媒体标识或 URI。 |
play_addr_h264.url_list | array | 此媒体版本返回的访问地址列表。 |
play_addr_h264.url_list[] | string | 此媒体版本的一个访问地址。 |
play_addr_h264.width | integer | 媒体宽度,存在时以像素表示。 |
play_addr_h264.height | integer | 媒体高度,存在时以像素表示。 |
play_addr_h264.data_size | integer | 此媒体版本返回的数据大小值。 |
play_addr_bytevc1 | object | ByteVC1 播放媒体版本。 |
play_addr_bytevc1.uri | string | TikTok 返回的媒体标识或 URI。 |
play_addr_bytevc1.url_list | array | 此媒体版本返回的访问地址列表。 |
play_addr_bytevc1.url_list[] | string | 此媒体版本的一个访问地址。 |
play_addr_bytevc1.width | integer | 媒体宽度,存在时以像素表示。 |
play_addr_bytevc1.height | integer | 媒体高度,存在时以像素表示。 |
play_addr_bytevc1.data_size | integer | 此媒体版本返回的数据大小值。 |
download_addr | object | 视频返回的下载媒体版本。 |
download_addr.uri | string | TikTok 返回的媒体标识或 URI。 |
download_addr.url_list | array | 此媒体版本返回的访问地址列表。 |
download_addr.url_list[] | string | 此媒体版本的一个访问地址。 |
download_addr.width | integer | 媒体宽度,存在时以像素表示。 |
download_addr.height | integer | 媒体高度,存在时以像素表示。 |
download_addr.data_size | integer | 此媒体版本返回的数据大小值。 |
download_no_watermark_addr | object | 标记为无水印的下载版本。 |
download_no_watermark_addr.uri | string | TikTok 返回的媒体标识或 URI。 |
download_no_watermark_addr.url_list | array | 此媒体版本返回的访问地址列表。 |
download_no_watermark_addr.url_list[] | string | 此媒体版本的一个访问地址。 |
download_no_watermark_addr.width | integer | 媒体宽度,存在时以像素表示。 |
download_no_watermark_addr.height | integer | 媒体高度,存在时以像素表示。 |
download_no_watermark_addr.data_size | integer | 此媒体版本返回的数据大小值。 |
音乐详情48 个字段
data.search_item_list[].aweme_info.music
帖子关联的音乐或声音元数据。
| 字段 | 类型 | 说明 |
|---|---|---|
id | integer | 音乐或声音的数字 ID。在 JavaScript 中使用 id_str 可保留完整数字。 |
id_str | string | 以文本表示的音乐或声音 ID。 |
mid | string | 以文本返回的音乐标识字段。 |
title | string | 音乐或声音的标题。 |
author | string | 音乐或声音作者的展示名称。 |
album | string | 曲目返回的专辑名称。 |
duration | integer | 音乐或声音时长,单位为秒。 |
audition_duration | integer | 音乐返回的试听时长。 |
shoot_duration | integer | 使用该音乐录制时返回的时长。 |
video_duration | integer | 音乐元数据中返回的视频时长值。 |
create_time | integer | 音乐或声音的创建时间,存在时以 Unix 时间戳返回,单位为秒。 |
user_count | integer | 使用该音乐返回的用户数。 |
language | string | 音乐返回的语言代码。 |
owner_id | string | 以文本表示的声音所有者 TikTok 用户 ID。 |
owner_handle | string | 声音所有者的公开 TikTok 用户名。 |
owner_nickname | string | 声音所有者的展示名称。 |
is_original_sound | boolean | 是否标记为原声。 |
is_commerce_music | boolean | 是否标记为商业音乐。 |
is_author_artist | boolean | 音乐作者是否标记为艺人。 |
can_not_reuse | boolean | 声音是否标记为不可重复使用。 |
has_human_voice | boolean | 此声音是否标记为包含人声。 |
duration_high_precision | object | 音乐返回的高精度时长数值。 |
duration_high_precision.duration_precision | number | 声音的高精度时长值。 |
duration_high_precision.audition_duration_precision | number | 高精度试听时长值。 |
duration_high_precision.shoot_duration_precision | number | 高精度录制时长值。 |
duration_high_precision.video_duration_precision | number | 音乐元数据中的高精度视频时长值。 |
matched_song | object | 声音关联的匹配歌曲详情,存在时可用。 |
matched_song.id | string | 以文本表示的匹配歌曲 ID。 |
matched_song.title | string | 匹配歌曲的标题。 |
matched_song.author | string | 匹配歌曲作者的展示名称。 |
matched_song.full_duration | integer | 匹配歌曲返回的完整时长值。 |
matched_song.cover_medium | object | 匹配歌曲的封面版本。 |
matched_song.cover_medium.uri | string | TikTok 返回的媒体标识或 URI。 |
matched_song.cover_medium.url_list | array | 此媒体版本返回的访问地址列表。 |
matched_song.cover_medium.url_list[] | string | 此媒体版本的一个访问地址。 |
matched_song.cover_medium.width | integer | 媒体宽度,存在时以像素表示。 |
matched_song.cover_medium.height | integer | 媒体高度,存在时以像素表示。 |
matched_pgc_sound | object | 匹配到的已发布声音详情,存在时可用。 |
matched_pgc_sound.title | string | 匹配到的已发布声音标题。 |
matched_pgc_sound.author | string | 匹配到的已发布声音作者的展示名称。 |
matched_pgc_sound.cover_medium | object | 匹配的已发布声音封面版本。 |
matched_pgc_sound.cover_medium.uri | string | TikTok 返回的媒体标识或 URI。 |
matched_pgc_sound.cover_medium.url_list | array | 此媒体版本返回的访问地址列表。 |
matched_pgc_sound.cover_medium.url_list[] | string | 此媒体版本的一个访问地址。 |
matched_pgc_sound.cover_medium.width | integer | 媒体宽度,存在时以像素表示。 |
matched_pgc_sound.cover_medium.height | integer | 媒体高度,存在时以像素表示。 |
music_release_info | object | 曲目关联的发行元数据。 |
music_release_info.is_new_release_song | boolean | 歌曲是否标记为新发行。 |
音乐艺人与媒体38 个字段
data.search_item_list[].aweme_info.music
| 字段 | 类型 | 说明 |
|---|---|---|
artists | array | 音乐关联的艺人,存在时可用。 |
artists[] | object | 音乐关联的一位艺人。 |
artists[].uid | string | 以文本表示的艺人 TikTok 账号 ID。 |
artists[].handle | string | 艺人的公开 TikTok 用户名。 |
artists[].nick_name | string | 艺人的展示名称。 |
artists[].is_verified | boolean | 艺人账号是否标记为已认证。 |
artists[].avatar | object | 艺人的头像版本。 |
artists[].avatar.uri | string | TikTok 返回的媒体标识或 URI。 |
artists[].avatar.url_list | array | 此媒体版本返回的访问地址列表。 |
artists[].avatar.url_list[] | string | 此媒体版本的一个访问地址。 |
play_url | object | 声音的播放版本。 |
play_url.uri | string | TikTok 返回的媒体标识或 URI。 |
play_url.url_list | array | 此媒体版本返回的访问地址列表。 |
play_url.url_list[] | string | 此媒体版本的一个访问地址。 |
play_url.width | integer | 媒体宽度,存在时以像素表示。 |
play_url.height | integer | 媒体高度,存在时以像素表示。 |
play_url.data_size | integer | 此媒体版本返回的数据大小值。 |
cover_large | object | 大尺寸音乐封面。 |
cover_large.uri | string | TikTok 返回的媒体标识或 URI。 |
cover_large.url_list | array | 此媒体版本返回的访问地址列表。 |
cover_large.url_list[] | string | 此媒体版本的一个访问地址。 |
cover_large.width | integer | 媒体宽度,存在时以像素表示。 |
cover_large.height | integer | 媒体高度,存在时以像素表示。 |
cover_large.data_size | integer | 此媒体版本返回的数据大小值。 |
cover_medium | object | 中等尺寸音乐封面。 |
cover_medium.uri | string | TikTok 返回的媒体标识或 URI。 |
cover_medium.url_list | array | 此媒体版本返回的访问地址列表。 |
cover_medium.url_list[] | string | 此媒体版本的一个访问地址。 |
cover_medium.width | integer | 媒体宽度,存在时以像素表示。 |
cover_medium.height | integer | 媒体高度,存在时以像素表示。 |
cover_medium.data_size | integer | 此媒体版本返回的数据大小值。 |
cover_thumb | object | 音乐封面的缩略版本。 |
cover_thumb.uri | string | TikTok 返回的媒体标识或 URI。 |
cover_thumb.url_list | array | 此媒体版本返回的访问地址列表。 |
cover_thumb.url_list[] | string | 此媒体版本的一个访问地址。 |
cover_thumb.width | integer | 媒体宽度,存在时以像素表示。 |
cover_thumb.height | integer | 媒体高度,存在时以像素表示。 |
cover_thumb.data_size | integer | 此媒体版本返回的数据大小值。 |
附加声音详情48 个字段
data.search_item_list[].aweme_info.added_sound_music_info
附加声音的元数据,存在时可用。
| 字段 | 类型 | 说明 |
|---|---|---|
id | integer | 音乐或声音的数字 ID。在 JavaScript 中使用 id_str 可保留完整数字。 |
id_str | string | 以文本表示的音乐或声音 ID。 |
mid | string | 以文本返回的音乐标识字段。 |
title | string | 音乐或声音的标题。 |
author | string | 音乐或声音作者的展示名称。 |
album | string | 曲目返回的专辑名称。 |
duration | integer | 音乐或声音时长,单位为秒。 |
audition_duration | integer | 音乐返回的试听时长。 |
shoot_duration | integer | 使用该音乐录制时返回的时长。 |
video_duration | integer | 音乐元数据中返回的视频时长值。 |
create_time | integer | 音乐或声音的创建时间,存在时以 Unix 时间戳返回,单位为秒。 |
user_count | integer | 使用该音乐返回的用户数。 |
language | string | 音乐返回的语言代码。 |
owner_id | string | 以文本表示的声音所有者 TikTok 用户 ID。 |
owner_handle | string | 声音所有者的公开 TikTok 用户名。 |
owner_nickname | string | 声音所有者的展示名称。 |
is_original_sound | boolean | 是否标记为原声。 |
is_commerce_music | boolean | 是否标记为商业音乐。 |
is_author_artist | boolean | 音乐作者是否标记为艺人。 |
can_not_reuse | boolean | 声音是否标记为不可重复使用。 |
has_human_voice | boolean | 此声音是否标记为包含人声。 |
duration_high_precision | object | 音乐返回的高精度时长数值。 |
duration_high_precision.duration_precision | number | 声音的高精度时长值。 |
duration_high_precision.audition_duration_precision | number | 高精度试听时长值。 |
duration_high_precision.shoot_duration_precision | number | 高精度录制时长值。 |
duration_high_precision.video_duration_precision | number | 音乐元数据中的高精度视频时长值。 |
matched_song | object | 声音关联的匹配歌曲详情,存在时可用。 |
matched_song.id | string | 以文本表示的匹配歌曲 ID。 |
matched_song.title | string | 匹配歌曲的标题。 |
matched_song.author | string | 匹配歌曲作者的展示名称。 |
matched_song.full_duration | integer | 匹配歌曲返回的完整时长值。 |
matched_song.cover_medium | object | 匹配歌曲的封面版本。 |
matched_song.cover_medium.uri | string | TikTok 返回的媒体标识或 URI。 |
matched_song.cover_medium.url_list | array | 此媒体版本返回的访问地址列表。 |
matched_song.cover_medium.url_list[] | string | 此媒体版本的一个访问地址。 |
matched_song.cover_medium.width | integer | 媒体宽度,存在时以像素表示。 |
matched_song.cover_medium.height | integer | 媒体高度,存在时以像素表示。 |
matched_pgc_sound | object | 匹配到的已发布声音详情,存在时可用。 |
matched_pgc_sound.title | string | 匹配到的已发布声音标题。 |
matched_pgc_sound.author | string | 匹配到的已发布声音作者的展示名称。 |
matched_pgc_sound.cover_medium | object | 匹配的已发布声音封面版本。 |
matched_pgc_sound.cover_medium.uri | string | TikTok 返回的媒体标识或 URI。 |
matched_pgc_sound.cover_medium.url_list | array | 此媒体版本返回的访问地址列表。 |
matched_pgc_sound.cover_medium.url_list[] | string | 此媒体版本的一个访问地址。 |
matched_pgc_sound.cover_medium.width | integer | 媒体宽度,存在时以像素表示。 |
matched_pgc_sound.cover_medium.height | integer | 媒体高度,存在时以像素表示。 |
music_release_info | object | 曲目关联的发行元数据。 |
music_release_info.is_new_release_song | boolean | 歌曲是否标记为新发行。 |
附加声音艺人与媒体38 个字段
data.search_item_list[].aweme_info.added_sound_music_info
| 字段 | 类型 | 说明 |
|---|---|---|
artists | array | 音乐关联的艺人,存在时可用。 |
artists[] | object | 音乐关联的一位艺人。 |
artists[].uid | string | 以文本表示的艺人 TikTok 账号 ID。 |
artists[].handle | string | 艺人的公开 TikTok 用户名。 |
artists[].nick_name | string | 艺人的展示名称。 |
artists[].is_verified | boolean | 艺人账号是否标记为已认证。 |
artists[].avatar | object | 艺人的头像版本。 |
artists[].avatar.uri | string | TikTok 返回的媒体标识或 URI。 |
artists[].avatar.url_list | array | 此媒体版本返回的访问地址列表。 |
artists[].avatar.url_list[] | string | 此媒体版本的一个访问地址。 |
play_url | object | 声音的播放版本。 |
play_url.uri | string | TikTok 返回的媒体标识或 URI。 |
play_url.url_list | array | 此媒体版本返回的访问地址列表。 |
play_url.url_list[] | string | 此媒体版本的一个访问地址。 |
play_url.width | integer | 媒体宽度,存在时以像素表示。 |
play_url.height | integer | 媒体高度,存在时以像素表示。 |
play_url.data_size | integer | 此媒体版本返回的数据大小值。 |
cover_large | object | 大尺寸音乐封面。 |
cover_large.uri | string | TikTok 返回的媒体标识或 URI。 |
cover_large.url_list | array | 此媒体版本返回的访问地址列表。 |
cover_large.url_list[] | string | 此媒体版本的一个访问地址。 |
cover_large.width | integer | 媒体宽度,存在时以像素表示。 |
cover_large.height | integer | 媒体高度,存在时以像素表示。 |
cover_large.data_size | integer | 此媒体版本返回的数据大小值。 |
cover_medium | object | 中等尺寸音乐封面。 |
cover_medium.uri | string | TikTok 返回的媒体标识或 URI。 |
cover_medium.url_list | array | 此媒体版本返回的访问地址列表。 |
cover_medium.url_list[] | string | 此媒体版本的一个访问地址。 |
cover_medium.width | integer | 媒体宽度,存在时以像素表示。 |
cover_medium.height | integer | 媒体高度,存在时以像素表示。 |
cover_medium.data_size | integer | 此媒体版本返回的数据大小值。 |
cover_thumb | object | 音乐封面的缩略版本。 |
cover_thumb.uri | string | TikTok 返回的媒体标识或 URI。 |
cover_thumb.url_list | array | 此媒体版本返回的访问地址列表。 |
cover_thumb.url_list[] | string | 此媒体版本的一个访问地址。 |
cover_thumb.width | integer | 媒体宽度,存在时以像素表示。 |
cover_thumb.height | integer | 媒体高度,存在时以像素表示。 |
cover_thumb.data_size | integer | 此媒体版本返回的数据大小值。 |
话题、提及与搜索高亮37 个字段
data.search_item_list[].aweme_info
| 字段 | 类型 | 说明 |
|---|---|---|
cha_list | array | null | 帖子关联的话题标签或挑战条目,存在时可用。 |
cha_list[] | object | 帖子关联的一个话题标签或挑战。 |
cha_list[].cid | string | 以文本表示的话题标签或挑战 ID。 |
cha_list[].cha_name | string | 话题标签或挑战的名称。 |
cha_list[].desc | string | 话题标签或挑战的描述。 |
cha_list[].type | integer | TikTok 返回的话题标签或挑战类型数字代码。 |
cha_list[].use_count | integer | 话题标签或挑战返回的使用次数。 |
cha_list[].user_count | integer | 话题标签或挑战返回的用户数。 |
cha_list[].view_count | integer | 话题标签或挑战返回的浏览次数。 |
cha_list[].is_commerce | boolean | 话题标签或挑战是否标记为商业内容。 |
search_highlight | array | 搜索结果随附的文本高亮信息。 |
search_highlight[] | object | 搜索文本字段的一组高亮。 |
search_highlight[].field | string | 需要高亮的搜索文本字段名称。 |
search_highlight[].positions | array | 此文本字段中需要高亮的位置范围。 |
search_highlight[].positions[] | object | 此文本字段的一处高亮范围。 |
search_highlight[].positions[].begin | integer | 高亮范围的起始位置。 |
search_highlight[].positions[].end | integer | 高亮范围的结束位置。 |
content_desc_extra | array | 补充描述中的标注,例如话题标签或提及。 |
content_desc_extra[] | object | 补充描述中的一条标注。 |
content_desc_extra[].start | integer | 标注在对应文本中的起始位置。 |
content_desc_extra[].end | integer | 标注在对应文本中的结束位置。 |
content_desc_extra[].hashtag_id | string | 以文本表示的 TikTok 话题标签 ID。 |
content_desc_extra[].hashtag_name | string | 此标注关联的话题标签名称。 |
content_desc_extra[].user_id | string | 被提及的 TikTok 用户 ID,存在时以文本表示。 |
content_desc_extra[].type | integer | TikTok 返回的标注类型数字代码。 |
content_desc_extra[].sub_type | integer | TikTok 返回的标注子类型数字代码。 |
content_desc_extra[].is_commerce | boolean | 此标注是否标记为商业内容。 |
text_extra | array | 帖子文案中的标注,例如话题标签或提及。 |
text_extra[] | object | 帖子文案中的一条标注。 |
text_extra[].start | integer | 标注在对应文本中的起始位置。 |
text_extra[].end | integer | 标注在对应文本中的结束位置。 |
text_extra[].hashtag_id | string | 以文本表示的 TikTok 话题标签 ID。 |
text_extra[].hashtag_name | string | 此标注关联的话题标签名称。 |
text_extra[].user_id | string | 被提及的 TikTok 用户 ID,存在时以文本表示。 |
text_extra[].type | integer | TikTok 返回的标注类型数字代码。 |
text_extra[].sub_type | integer | TikTok 返回的标注子类型数字代码。 |
text_extra[].is_commerce | boolean | 此标注是否标记为商业内容。 |
可见性与互动权限14 个字段
data.search_item_list[].aweme_info
| 字段 | 类型 | 说明 |
|---|---|---|
status | object | TikTok 返回的帖子可见性和互动状态。 |
status.aweme_id | string | 这组状态信息对应的 TikTok 帖子 ID。 |
status.allow_comment | boolean | 是否标记为允许评论。 |
status.allow_share | boolean | 是否标记为允许分享。 |
status.download_status | integer | 帖子返回的下载状态数字代码。 |
status.is_delete | boolean | 帖子是否标记为已删除。 |
status.is_prohibited | boolean | 帖子是否标记为受限。 |
status.private_status | integer | 帖子返回的隐私状态数字代码。 |
interact_permission | object | 帖子的互动可用性和权限标记。 |
interact_permission.allow_adding_as_post | object | 是否标记为允许将内容添加为帖子。 |
interact_permission.allow_adding_to_story | integer | 是否标记为允许将内容添加到快拍。 |
interact_permission.duet | integer | 帖子返回的合拍可用标记。 |
interact_permission.stitch | integer | 帖子返回的拼接可用标记。 |
interact_permission.allow_create_sticker | object | 是否标记为允许创建贴纸。 |
分享5 个字段
data.search_item_list[].aweme_info.share_info
用于分享帖子的文本和链接元数据。
| 字段 | 类型 | 说明 |
|---|---|---|
share_title | string | 分享帖子时使用的标题。 |
share_desc | string | 分享帖子时使用的描述。 |
share_link_desc | string | 帖子分享链接的展示描述。 |
share_quote | string | 分享时附带的引用文字。 |
share_url | string | 帖子的分享链接。 |
地点与付费内容26 个字段
data.search_item_list[].aweme_info
| 字段 | 类型 | 说明 |
|---|---|---|
poi_data | object | 帖子关联的公开地点信息,存在时可用。 |
poi_data.poi_id | string | 以文本表示的地点 ID。 |
poi_data.poi_name | string | 公开的地点名称。 |
poi_data.location_desc | string | 描述地点位置的展示文字。 |
poi_data.poi_type | string | TikTok 返回的地点类型。 |
poi_data.video_count | integer | 地点返回的关联视频数。 |
poi_data.address_info | object | 地点关联的公开地址详情。 |
poi_data.address_info.city_name | string | 地点所在城市的名称。 |
poi_data.address_info.region_code | string | 地点返回的地区代码。 |
poi_data.address_info.address | string | 地点的公开地址文字。 |
poi_data.thumbnail | object | 公开地点附带的缩略图。 |
poi_data.thumbnail.uri | string | TikTok 返回的媒体标识或 URI。 |
poi_data.thumbnail.url_list | array | 此媒体版本返回的访问地址列表。 |
poi_data.thumbnail.url_list[] | string | 此媒体版本的一个访问地址。 |
poi_data.thumbnail.width | integer | 媒体宽度,存在时以像素表示。 |
poi_data.thumbnail.height | integer | 媒体高度,存在时以像素表示。 |
paid_content_info | object | 付费内容的展示元数据,存在时可用。 |
paid_content_info.collection_name | string | 付费合集的展示名称。 |
paid_content_info.episode_num | integer | 内容返回的集数编号。 |
paid_content_info.is_limited_free | boolean | 内容是否标记为限时免费。 |
paid_content_info.cover_url | object | 付费内容的封面元数据。 |
paid_content_info.cover_url.uri | string | TikTok 返回的媒体标识或 URI。 |
paid_content_info.cover_url.url_list | array | 此媒体版本返回的访问地址列表。 |
paid_content_info.cover_url.url_list[] | string | 此媒体版本的一个访问地址。 |
paid_content_info.cover_url.width | integer | 媒体宽度,存在时以像素表示。 |
paid_content_info.cover_url.height | integer | 媒体高度,存在时以像素表示。 |