Post(内容)对象

19 个平台的 81 个接口都返回 Post(内容)对象,28 个字段名完全一样,给一个平台写的代码不用改就能读其他平台。每次调用 $0.0003 到 $0.0200。

稳定对象 · 更新于 2026-10-17在 ChatGPT 里打开在 Claude 里打开

内容(Post)是平台上发布的一条东西:一条视频、一篇笔记、一条推文、一篇文章、频道里的一条消息。各平台的内容用同一套字段返回,text、author、published_at 和 metrics 里的点赞数,在抖音和 YouTube 上都是同一个位置。

author 是发这条内容的账号,带 id 和 username;它下面的评论用 post_id 指回它,视频的逐字稿也是。X 上的回复本身就是一条内容,post_id、parent_id、root_id 写明它挂在哪个回复串里。

字段

平台给不了的字段不会出现在这条数据里,而是写在 meta.unavailable 里。不会用猜的数或 0 顶上。

id 文本

编号,可原样传给取详情的接口

url 链接

能直接打开的链接

type 文本

内容形态:video image text article

title 文本

标题

text 文本

正文

lang 文本 standard

正文的语言

published_at 时间

发布时间

author 对象

作者

author.id 文本

作者的账号编号

author.username 文本

作者的账号名

author.name 文本

作者的显示名

author.avatar_url 链接 standard

作者头像

author.verified 是否 standard

作者是否认证

author.followers 整数 standard

作者的粉丝数

metrics 对象

互动数

metrics.likes 整数

点赞数

metrics.comments 整数

评论数

metrics.shares 整数

分享数

metrics.favorites 整数

收藏数

metrics.views 整数

播放或阅读数

metrics.reposts 整数

转发数

images 链接列表 standard

图片地址

hashtags 文本列表 standard

话题标签,不带 #

mentions 对象列表 standard

正文里提及的账号

mentions[].id 文本 standard

账号编号

mentions[].username 文本 standard

账号名

mentions[].name 文本 standard

显示名

is_pinned 是否 standard

是否被作者置顶

post_id 文本

它回复的那条内容所在的主帖编号;不是回复则为 null

parent_id 文本

它直接回复的那一条的编号;不是回复则为 null

root_id 文本

所在回复串里第一层那一条的编号

每个数取的是平台上的哪个数

同一个字段名,在不同平台上对应的动作不完全一样。这张表写明这个字段取的是平台自己的哪个数。

字段在那里是什么平台
id由文章长链接里的 __biz、mid、idx 拼成;取文章要用 url,不能用它微信公众号
由所给长链接里的 __biz、mid、idx 拼成微信公众号
搜一搜给这条视频的加密编号(export/ 开头),原样照给:不是视频号作品详情、评论接口要的数字编号,同一条视频在以后的搜索里不保证还是这个编号微信视频号
文章:由文章长链接里的 __biz、mid、idx 拼成,和公众号文章列表给的相同,取文章要用 url;视频:搜一搜给这条视频的加密编号(export/ 开头),原样照给,不是视频号作品详情要的数字编号,同一条视频在以后的搜索里不保证还是这个编号微信搜一搜
频道账号名加消息序号,如 telegram/401,可原样传给取单条消息的接口Telegram
url作者主页上打开这条视频的链接抖音
文章的链接;视频号视频没有网页链接,为 null微信搜一搜
type附带视频的帖子是 video,只有图片的是 image,其余是 textYouTube
title搜索结果卡片上的标题,不带表情符号小红书
文章的标题,去掉了关键词高亮;视频没有单独的标题,为 null微信搜一搜
text视频简介YouTube
搜索结果卡片上的正文摘录,不是全文;完整正文用笔记详情取小红书
正文的前 100 个字;完整正文用笔记详情取小红书
文章的摘要,不是全文微信公众号
视频的文案,去掉了关键词高亮微信视频号
文章的摘要(不是全文)或视频的文案,去掉了关键词高亮微信搜一搜
图钉的描述Pinterest
published_at平台只给发布的日期(中国时间的自然日),写成这一天的 UTC 零点,不是发布的时刻抖音
author.username消息所在频道的账号名Telegram
author.name发布账号的名称;搜一搜不给账号编号微信视频号
公众号或视频号的名称;搜一搜不给账号编号微信搜一搜
author.avatar_url视频号的头像;文章的结果不带头像,为 null微信搜一搜
author.verified发布者是否有平台的认证标记;没有时为 nullPinterest
author.followers作者的关注者数LinkedIn
metrics.likes点赞数;一千以上平台只显示约数YouTube
全部心情(赞、大爱、哈哈等)的总数Facebook
卡片上显示的点赞数;“1.4万”这类是约数,“10万+”是下限;卡片没显示数时为 null微信视频号
视频卡片上显示的点赞数,“1.4万”这类是约数,“10万+”是下限,没显示数时为 null;文章的结果不带任何互动数,为 null微信搜一搜
全部心情(赞、庆祝、支持等)的总数LinkedIn
赞同数知乎
全部心情(赞等)的总数Pinterest
metrics.comments回复数X(推特)
直接回复数Threads
同一内容(含别人转存的副本)下的评论总数Pinterest
metrics.shares分享(发送给别人)的次数Threads
metrics.favorites书签数X(推特)
卡片上显示的另一个数,和视频号作品列表的收藏数是同一个数;约数、下限和 null 同点赞数微信视频号
视频卡片上显示的另一个数,和视频号作品列表的收藏数是同一个数,约数、下限和 null 同点赞数;文章为 null微信搜一搜
这一个图钉被转存的次数;同一内容的保存总数在 ext.savesPinterest
metrics.views视频的播放数;不是视频的帖子为 nullFacebook
阅读数;超过 10 万时平台只给“10万+”,这里是下限微信公众号
播放数;按热门排就是按它排B站
阅读数;不显示阅读数的微博为 null微博
浏览数;一千以上平台只显示约数Telegram
metrics.reposts转推数;引用另计,在 ext.quotesX(推特)
转发数微博知乎
转发数;引用另计,在 ext.quotesThreads
images视频封面YouTube
搜到的那一张图片,原图地址,会过期;笔记的其余图片用笔记详情取小红书
图钉的原图Pinterest
hashtags帖子的话题标签,一条帖子最多一个Threads
is_pinned是否置顶在所查账号的主页上Instagram
post_id所在对话的主帖编号X(推特)

哪些平台给不了哪些字段

一个平台的所有接口都给不了某个字段时,它才列在那个字段后面。

字段给不了的平台
url微信视频号
typeLinkedIn快手
titleTikTokInstagramFacebook微信视频号微博LinkedInThreads快手Telegram
langYouTubeInstagramFacebook微信公众号微信视频号微信搜一搜B站微博LinkedIn快手知乎TelegramPinterest
author.id微信搜一搜LinkedInTelegram
author.username微信视频号微信搜一搜B站微博
author.nameReddit
author.avatar_urlTelegram
author.verifiedTikTokYouTube抖音Reddit微信公众号微信视频号微信搜一搜LinkedIn知乎Telegram
author.followersYouTubeInstagram小红书RedditFacebook微信公众号微信视频号微信搜一搜Threads快手Telegram
metrics.likesRedditTelegram
metrics.comments微信搜一搜Telegram
metrics.sharesYouTubeInstagramX(推特)微信搜一搜微博LinkedIn知乎Telegram
metrics.favoritesYouTubeInstagramRedditFacebook微博LinkedInThreadsTelegram
metrics.views小红书Reddit微信视频号微信搜一搜LinkedInPinterest
metrics.repostsTikTokYouTubeInstagram抖音小红书RedditFacebook微信公众号微信视频号微信搜一搜B站LinkedIn快手TelegramPinterest
imagesTikTok微信公众号微信视频号微信搜一搜B站快手
hashtagsYouTubeInstagramRedditFacebook微信公众号微信视频号微信搜一搜LinkedIn快手知乎TelegramPinterest
mentions[].idYouTubeInstagram抖音RedditFacebook微信公众号微信视频号微信搜一搜B站微博LinkedInThreads快手知乎TelegramPinterest
mentions[].usernameTikTokYouTubeInstagram抖音小红书RedditFacebook微信公众号微信视频号微信搜一搜B站微博LinkedInThreads快手知乎TelegramPinterest
mentions[].nameTikTokYouTubeInstagram抖音RedditFacebook微信公众号微信视频号微信搜一搜B站微博LinkedInThreads快手知乎TelegramPinterest
is_pinnedYouTubeX(推特)Facebook微信公众号微信视频号微信搜一搜B站LinkedIn快手TelegramPinterest
post_idTikTokYouTubeInstagram抖音小红书RedditFacebook微信公众号微信视频号微信搜一搜B站微博LinkedInThreads快手TelegramPinterest
parent_idTikTokYouTubeInstagram抖音小红书RedditFacebook微信公众号微信视频号微信搜一搜B站微博LinkedInThreads快手TelegramPinterest
root_idTikTokYouTubeInstagramX(推特)抖音小红书RedditFacebook微信公众号微信视频号微信搜一搜B站微博LinkedInThreads快手知乎TelegramPinterest
同一个平台上,可能一个接口给不了、另一个接口能给:每个接口的页面列着它给不了的字段,每次返回也都写在 meta.unavailable 里。

返回 Post(内容)的接口

每个平台旁边的数字,是它有几个接口返回这种对象。

接口路径价格
TikTok 话题作品GET/v1/tiktok/hashtags/videos/list$0.0020
TikTok 用户作品GET/v1/tiktok/users/videos/list$0.0020
TikTok 视频详情GET/v1/tiktok/videos/get$0.0020
TikTok 视频搜索GET/v1/tiktok/videos/search$0.0020
YouTube 频道视频GET/v1/youtube/channels/videos/list$0.0020
YouTube 视频详情GET/v1/youtube/videos/get$0.0020
YouTube 视频搜索GET/v1/youtube/videos/search$0.0020
YouTube 频道帖子GET/v1/youtube/channels/posts/list$0.0020
YouTube 帖子详情GET/v1/youtube/posts/get$0.0020
Instagram 话题帖子GET/v1/instagram/hashtags/posts/list$0.0020
Instagram 帖子详情GET/v1/instagram/posts/get$0.0020
Instagram 用户帖子GET/v1/instagram/users/posts/list$0.0020
X 社群帖子GET/v1/x/communities/posts/list$0.0003 / 条
X 列表帖子GET/v1/x/lists/posts/list$0.0020
X 长文详情GET/v1/x/posts/article/get$0.0020
X 帖子详情GET/v1/x/posts/get$0.0003
X 帖子引用列表GET/v1/x/posts/quotes/list$0.0003 / 条
X 帖子回复列表GET/v1/x/posts/replies/list$0.0020
X 帖子搜索GET/v1/x/posts/search$0.0020
X 帖子对话串GET/v1/x/threads/posts/list$0.0003 / 条
X 用户提及GET/v1/x/users/mentions/list$0.0003 / 条
X 用户帖子列表GET/v1/x/users/posts/list$0.0020
抖音话题视频GET/v1/douyin/hashtags/videos/list$0.0020
抖音巨量算数达人热门视频GET/v1/douyin/index/creators/videos/list$0.0020
抖音巨量算数关键词热门视频GET/v1/douyin/index/videos/search$0.0020
抖音用户视频GET/v1/douyin/users/videos/list$0.0020
抖音视频详情GET/v1/douyin/videos/get$0.0020
抖音视频播放量GET/v1/douyin/videos/metrics$0.0020
抖音相关视频GET/v1/douyin/videos/related$0.0020
抖音视频搜索GET/v1/douyin/videos/search$0.0200
抖音视频榜GET/v1/douyin/videos/trending$0.0020
小红书图片搜索GET/v1/xiaohongshu/images/search$0.0200
小红书笔记详情GET/v1/xiaohongshu/notes/get$0.0200
小红书笔记搜索GET/v1/xiaohongshu/notes/search$0.0200
小红书话题笔记GET/v1/xiaohongshu/topics/notes/list$0.0200
小红书用户笔记GET/v1/xiaohongshu/users/notes/list$0.0200
Reddit 帖子详情GET/v1/reddit/posts/get$0.0020
Reddit 帖子搜索GET/v1/reddit/posts/search$0.0020
Reddit 热门帖子GET/v1/reddit/posts/trending$0.0020
Reddit 社区帖子GET/v1/reddit/subreddits/posts/list$0.0020
Reddit 用户帖子GET/v1/reddit/users/posts/list$0.0020
Facebook 主页帖子GET/v1/facebook/pages/posts/list$0.0020
Facebook 帖子详情GET/v1/facebook/posts/get$0.0020
微信公众号文章列表GET/v1/wechat_mp/accounts/articles/list$0.0200
微信公众号文章详情GET/v1/wechat_mp/articles/get$0.0200
微信公众号文章互动数据GET/v1/wechat_mp/articles/metrics$0.0200
微信视频号作品详情GET/v1/wechat_channels/videos/get$0.0200
微信视频号合集里的视频GET/v1/wechat_channels/collections/videos/list$0.0200
微信视频号用户作品GET/v1/wechat_channels/users/videos/list$0.0200
微信搜一搜视频号视频搜索GET/v1/wechat_channels/videos/search$0.0200
微信搜一搜综合搜索GET/v1/wechat/posts/search$0.0200
B站用户投稿GET/v1/bilibili/users/videos/list$0.0020
B站视频详情GET/v1/bilibili/videos/get$0.0020
B站视频搜索GET/v1/bilibili/videos/search$0.0020
B站综合热门GET/v1/bilibili/videos/trending$0.0020
微博详情GET/v1/weibo/posts/get$0.0020
微博实时搜索GET/v1/weibo/posts/search$0.0020
微博用户微博GET/v1/weibo/users/posts/list$0.0020
LinkedIn 公司帖子GET/v1/linkedin/companies/posts/list$0.0020
LinkedIn 帖子详情GET/v1/linkedin/posts/get$0.0020
LinkedIn 帖子搜索GET/v1/linkedin/posts/search$0.0020
Threads 帖子详情GET/v1/threads/posts/get$0.0020
Threads 帖子搜索GET/v1/threads/posts/search$0.0020
Threads 用户帖子GET/v1/threads/users/posts/list$0.0020
快手用户作品GET/v1/kuaishou/users/videos/list$0.0200
快手作品详情GET/v1/kuaishou/videos/get$0.0020
快手视频搜索GET/v1/kuaishou/videos/search$0.0200
知乎回答详情GET/v1/zhihu/answers/get$0.0020
知乎文章详情GET/v1/zhihu/articles/get$0.0020
知乎专栏文章列表GET/v1/zhihu/columns/articles/list$0.0020
知乎想法详情GET/v1/zhihu/pins/get$0.0020
知乎内容搜索GET/v1/zhihu/posts/search$0.0020
知乎问题回答GET/v1/zhihu/questions/answers/list$0.0020
知乎问题详情GET/v1/zhihu/questions/get$0.0020
知乎用户回答GET/v1/zhihu/users/answers/list$0.0020
知乎用户文章GET/v1/zhihu/users/articles/list$0.0020
知乎用户想法GET/v1/zhihu/users/pins/list$0.0020
Telegram 频道消息GET/v1/telegram/channels/messages/list$0.0020
Telegram 单条消息GET/v1/telegram/messages/get$0.0020
Pinterest 图钉详情GET/v1/pinterest/pins/get$0.0020
Pinterest 图钉搜索GET/v1/pinterest/pins/search$0.0020

示例

tiktok.hashtags.videos.list 返回的一条,录制于 2026-10-12 18:47 UTC。名字、正文和编号是示例,链接也是;数字是原样。

Post(内容) · tiktok.hashtags.videos.list
{
  "id": "7324847345040857368",
  "url": "https://www.tiktok.com/@hannah.w.photo/video/7324847345040857368",
  "type": "video",
  "text": "Weekend hiking from last night, no filter. Settings in the comments.",
  "lang": "en",
  "published_at": "2026-10-06T15:16:22.000Z",
  "author": {
    "id": "6049772375495468810",
    "username": "hannah.w.photo",
    "name": "Hannah Weiss",
    "avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/523134e9dfaaa0b34294~c5_100x100.jpeg"
  },
  "metrics": {
    "likes": 10289,
    "comments": 101,
    "shares": 364,
    "favorites": 852,
    "views": 86424
  },
  "hashtags": [
    "outdoors",
    "weekendvibes",
    // … 另有 3 条
  ],
  "mentions": []
}

完整的返回在这个接口的页面上 →

相关

其他对象