id- 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url- 该记录在原平台上的可访问链接。
text- 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
author_name- 评价人名字(shop_product_reviews),平台已打码,如 n**h。
author_username- 作者用户名(@handle),通常可用于拼 URL。
like_count- 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
comment_count- 评论数。null 表示不公开,不等于 0。
share_count- 分享/转发数。null 表示不公开,不等于 0。
view_count- 浏览/播放数。null 表示不公开,不等于 0。
posted_at- 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
collect_count- 收藏数。null 表示不公开,不等于 0。
repost_count- 转发数。
duration_seconds- 时长,单位秒。非视频/音频内容为 null。
cover_image_url- 视频封面图链接(带签名,会过期)。
language- 内容语言代码(如 zh、en),由平台判定,可能不准。
country- 国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
hashtags- 正文里的话题标签数组,按出现顺序;没有时不出现这个字段。
music- 背景音乐:id、title(曲名)、author、is_original(是否原声)、play_url(音频地址,会过期)、cover_url。
is_ad- 是否广告视频。
is_pinned- 是否在作者主页置顶。
is_sponsored- 是否含赞助内容。
is_slideshow- 是否图文轮播(不是视频)。
has_shop_product- 视频是否挂了 TikTok Shop 商品;没有这个键表示无法判定。
author_id- 作者在原平台的唯一 ID。
author_url- 作者在原平台的主页链接。
author_avatar_url- 作者头像图片链接(多数平台带签名、会过期)。
author_is_private- 作者是否私密账号。
author_is_seller- 作者是否 TikTok Shop 卖家。
author_follower_count- 作者粉丝数。null 表示不公开。
platform- 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
user_id- 用户在原平台的唯一 ID。
username- 用户名(@handle)。
display_name- 显示名,可能与 username 不同。
bio- 个人简介,账号自己填写的文本。可能含换行和 emoji。
external_url- 主页外链。
follower_count- 粉丝数。null 表示不公开,不等于 0。
following_count- 关注数。null 表示不公开,不等于 0。
video_count- 视频数。
friend_count- 好友数。
is_verified- 是否为平台认证账号(蓝V等)。null 表示无法判定。
is_private- 是否私密账号。
avatar_url- 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
created_at- 创建时间,格式同 posted_at。
reply_count- 回复数,通常用于评论的子回复。null 表示不公开。
reply_to_id- 被回复评论 ID。
is_reply- 是否为回复。
liked_by_author- 评论是否被作者点赞。
pinned_by_author- 评论是否被作者置顶。
post_count- 发布内容总数。null 表示不公开,不等于 0。
connection_count- 关联数。
precision- 数据精确度标记。
segments- 字幕分段(带时间戳的文本)。
has_transcript- 是否有字幕可提取。
name- 名称。用于账号/商品/商家类能力,指该对象本身的名字。
price- 价格数值,不含货币符号;币种见 currency。
original_price- 原价。
currency- 价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
sold_count- 销量。
rating- 评分。分制随平台而异,同一行的
rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。 rating_scale- 上一列
rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 review_count- 评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
category- 分类名称,取值为原平台的分类体系,未做跨平台归一。
shop_name- 小店名称(TikTok Shop 用)。
image_url- 图片链接。多图能力可能返回 image_urls 数组。
categories- 分类。
product_count- 带货商品数。
avg_views- 平均播放量。衡量达人真实水位:粉丝数会造假,均播难。
hashtag_id- 话题 ID(hashtag_search、trending_hashtags)。
hashtag_name- 话题名,不带 #(hashtag_search、trending_hashtags)。
description- 简介或描述,通常比 text 短。
title- 标题。平台无标题概念时(如纯文本帖)为 null。
album- 专辑名(music_search / music_chart);原声、没登记专辑的没有这个字段。
use_count- 用过这首音乐的视频数(music_search / music_chart)。
is_commercial- 是否 TikTok 商用曲库里的音乐(music_search / music_chart)。
released_at- 音乐发行日期(music_search / music_chart);原声、没登记发行日期的没有这个字段。
audio_url- 试听音频链接(music_search / music_chart),多为 60 秒片段,带签名、会过期。
rank- 名次,从 1 起(music_chart / shop_hot_products)。
sec_uid- 账号的 secUid(user_search),TikTok 网页接口里长期不变的账号标识。
verified_label- 认证说明(user_search),如 Verified account;没认证的没有这个字段。
is_live- 账号此刻是否在直播(user_search)。
reply_to_reply_id- 这条回复是回给哪条回复的(comment_replies);直接回顶层评论的没有这个字段。
video_id- 评论所在视频的 ID(comment_replies)。
shop_id- 店铺 ID(shop_products),可以直接传给 shop_products 的 shop_id。
video_url- 无水印视频文件地址(video_download,mp4)。不用 Cookie、不限 IP,到 expires_at 失效;图文作品没有。
video_backup_urls- 同一个文件的备用地址(video_download),video_url 打不开时换用。
size_bytes- video_url 那个文件的大小,字节(video_download)。
hd_video_url- 更清晰的一档(video_download),通常 1080p;没有比 video_url 更清晰的就没有这个字段。
hd_width- hd_video_url 的宽度,像素(video_download)。
hd_size_bytes- hd_video_url 的文件大小,字节(video_download)。
watermarked_video_url- 带 TikTok 水印的下载地址(video_download);部分视频没有。
image_urls- 图文(轮播)作品的每张图片地址(video_download);只有图文作品有。
expires_at- 下载地址的失效时间(video_download,ISO,约在调用后 6 小时);过了要重新调用。
room_id- 直播间 ID(live_room);没在播的没有这个字段。
viewer_count- 调用那一刻的在线观众数(live_room)。
peak_viewer_count- 本场直播的在线峰值(live_room)。
total_viewer_count- 本场直播累计进入人次(live_room)。
stream_url- 直播拉流地址(live_room,FLV,带签名、会过期);没在播、在别人直播间连麦时没有。
variant- 买家买的规格(shop_product_reviews),如颜色、香型。
is_verified_purchase- 是否确认购买后写的评价(shop_product_reviews)。
is_incentivized- 是否带激励的评价(shop_product_reviews),如晒图返券。
trend- 这段时间里每天的热度(trending_hashtags):[{date, value}],value 0–100,最热那天是 100。