id- 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url- 该记录在原平台上的可访问链接。
text- 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
like_count- 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
retweet_count- 转发数。
reply_count- 回复数,通常用于评论的子回复。null 表示不公开。
view_count- 浏览/播放数。null 表示不公开,不等于 0。
posted_at- 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
author_username- 作者用户名(@handle),通常可用于拼 URL。
author_name- 作者昵称(显示名)。
author_url- 作者在原平台的主页链接。
author_follower_count- 作者粉丝数。null 表示不公开。
bookmark_count- 书签(收藏)数。
language- 内容语言代码(如 zh、en),由平台判定,可能不准。
conversation_id- 所属对话串 ID(根推文 ID),同一串的回复据此归在一起。
is_quote- 是否引用推文。
reply_to_user_id- 所回复用户的数字 ID。
source- 发推客户端(如 Twitter for iPhone);平台没给时没有这个键。
media- 推文图片 / 视频:type(photo / video / animated_gif)、url(图片或视频封面)、width、height、duration_sec(视频秒数)、video_url(码率最高的 mp4)。
hashtags- 正文里的话题标签数组,按出现顺序;没有时不出现这个字段。
mentions- 正文里 @ 到的用户名。
links- 正文里的外链(展开后的完整网址)。
author_id- 作者在原平台的唯一 ID。
author_avatar_url- 作者头像图片链接(多数平台带签名、会过期)。
author_post_count- 作者推文总数。
author_media_count- 作者发过的媒体数。
author_banner_url- 作者主页横幅图链接。
platform- 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
user_id- 用户在原平台的唯一 ID。
username- 用户名(@handle)。
display_name- 显示名,可能与 username 不同。
bio- 个人简介,账号自己填写的文本。可能含换行和 emoji。
follower_count- 粉丝数。null 表示不公开,不等于 0。
following_count- 关注数。null 表示不公开,不等于 0。
post_count- 发布内容总数。null 表示不公开,不等于 0。
is_verified- 是否为平台认证账号(蓝V等)。null 表示无法判定。
location- 地理位置描述,原文透传,格式随平台而异。
avatar_url- 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
created_at- 创建时间,格式同 posted_at。
name- 名称。用于账号/商品/商家类能力,指该对象本身的名字。
rank- 趋势榜名次。
volume- 话题讨论量。
period- 统计时段。
collected_at- 该条数据的抓取时刻。趋势变化快,用它判断新鲜度。
is_protected- 账号是否为受保护状态(推文仅粉丝可见)。
media_count- 账号发过的图片 / 视频数(retweeters)。
affiliation- 账号挂的机构标签(如员工账号挂的公司名「X」);没挂时没有这个字段。
account_status- 账号状态,正常是 active(被封或停用时为其他值)。
account_based_in- X「关于此账号」页显示的账号所在国家 / 地区(如 United States);X 没显示时没有这个字段。
is_location_accurate- X 是否认为 account_based_in 准确(false 表示可能用了代理或 VPN 等)。
signup_source- 账号注册来源(如 United States App Store);X 没显示时没有这个字段。
username_change_count- 账号改过几次用户名。
last_username_change_at- 最近一次改用户名的时间;没改过时没有这个字段。
verified_since- 账号开始拿到认证标记的时间。
target_username- 被查是否被关注的账号(check_follow 原样带回)。
is_following- username 是否关注了 target_username(check_follow)。
is_retweeted- username 是否转推过这条帖子(check_retweet)。
description- 简介或描述,通常比 text 短。
topic- 社群的主话题(如 Finance)。
is_nsfw- 社群是否标为成人内容。
banner_url- 社群横幅图链接。
rules- 社群规则(每条的标题)。