Docs
搜索文档...⌘K

帖子

API + MCP
GET/v3/social-media/posts

对此端点的请求免费,不会消耗任何 API 单位。

查询参数

offsetinteger

要跳过的结果数量。

默认:0
limitinteger

要返回的结果数量。

默认:50
order_directionstring

结果返回顺序:升序或降序。

允许的值:ascdesc
order_bystring

帖子的排序字段。基于指标的排序仅适用于已发布的帖子。

允许的值:dateviewsunique_viewscommentslikes
date_tostring

历史周期的结束日期,格式为 YYYY-MM-DD。

date_fromstring

历史周期的开始日期,格式为 YYYY-MM-DD。

search_querystring

用于按内容筛选帖子的文本搜索查询。

author_idsstring

用于筛选的作者用户 ID 列表(以逗号分隔)。

channel_idsstring

用于筛选的渠道 ID 列表(以逗号分隔)。

statusstring必填

帖子的发布生命周期阶段。

允许的值:publishedscheduleddraftfaileddeleted
outputstring

输出格式。

允许的值:jsonphp

响应

postsarray<object>
author_idstring or null

作者的唯一标识符。

author_namestring or null

作者的名称。

auto_commentstring or null

发布后自动发布的评论文本。

channelsarray<object>

与帖子关联的社交媒体频道。

channel_idstring
channel_kindstring
channel_usernamestring
channel_display_namestring
channel_profile_image_urlstring or null
created_atstring

作者创建帖子的时间戳。

external_post_idstring or null

平台特定的帖子标识符。

permalinkstring or null

平台上已发布帖子的 URL。

post_idinteger

帖子的唯一标识符。

status_timestampstring

与当前状态关联的时间戳。

text_contentstring

帖子的文本内容。