id- 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
handle- 用户短名。
name- 名称。用于账号/商品/商家类能力,指该对象本身的名字。
url- 该记录在原平台上的可访问链接。
custom_domain- 自定义域名,配了说明作者有意长期经营。
bio- 个人简介,账号自己填写的文本。可能含换行和 emoji。
language- 内容语言代码(如 zh、en),由平台判定,可能不准。
subscriber_count- 订阅数。Substack 只对部分账号公开,null 不等于 0。
payments_enabled- 该出版物是否开通了付费订阅。
avatar_url- 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
cover_url- 封面图。
platform- 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
author_name- 作者昵称(显示名)。
author_username- 作者用户名(@handle),通常可用于拼 URL。
title- 标题。平台无标题概念时(如纯文本帖)为 null。
subtitle- 副标题。
text- 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
publication_name- 出版物(Newsletter)名称。
publication_handle- 出版物短名。
publication_url- 出版物链接。
like_count- 点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
comment_count- 评论数。null 表示不公开,不等于 0。
repost_count- 转发数(区别于引用转发)。null 表示不公开。
word_count- 正文字数。
reading_time_minutes- 预计阅读时长,分钟。
post_type- 内容类型(newsletter/podcast/thread 等)。
audience- 受众范围(everyone/paid 等)。
is_paid- 是否为付费内容。
podcast_url- 播客音频链接。
image_url- 图片链接。多图能力可能返回 image_urls 数组。
posted_at- 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
updated_at- 更新时间。
tags- 标签数组。无标签时为空数组,不是 null。
reply_count- 回复数,通常用于评论的子回复。null 表示不公开。
reply_to_id- 被回复内容的 ID。
is_reply- 是否为回复(Notes 场景)。
is_pinned- 是否置顶。
is_author- 评论者是否为文章作者本人。
user_id- 用户在原平台的唯一 ID。
username- 用户名(@handle)。
display_name- 显示名,可能与 username 不同。
twitter_username- 关联的 Twitter 用户名。
kind- 条目类别。
restacked_post- 这条短帖转发(restack)的原文,含标题和链接;不是转发时不出现这个字段。
attachment_urls- 短帖附带的附件链接;没有附件时不出现这个字段。