跳转到主要内容
POST
获取通过 Ayrshare 发送的帖子的实时分析数据(例如点赞、展示、观看和反应),通过 Ayrshare 帖子 ID 进行查询。 若要获取在 Ayrshare 外部发布的帖子的分析数据,请参见按社交帖子 ID 分析
Facebook:Meta 已下线部分覆盖率与视频指标(2026 年 6 月 15 日)。 Meta 在所有 Graph API 版本中移除了唯一展示与 3 秒视频观看的 Insights 指标,因此 Facebook 的 analytics 对象不再返回 impressionsUniqueimpressionsFanUniqueimpressionsOrganicUniqueimpressionsPaidUniquevideoViewsUnique。请使用 mediaView 作为覆盖指标(“总唯一媒体观看数”的后继指标已在规划中)。其他常用字段如 reactionsByTypevideoViews 不受影响。参考:即将进行的 API 变更 — 2026 年 6 月 15 日

附加信息

  • 目前支持以下平台:Bluesky、Facebook Pages、Instagram、X/Twitter、LinkedIn、Pinterest、Reddit、Snapchat、Threads、TikTok 和 YouTube。
  • API 返回的 Facebook 与 Instagram 评论数可能与社交应用中显示的数量不同。这可能有两种原因: - 某些用户设置了隐私选项,隐藏了对非好友或无相互关系用户的评论。这些私密评论仍会计入总评论数。 - Meta 上报的数据可能存在不一致。
  • API 返回的 Instagram igReelsAggregatedAllPlaysCount 与 playsCount 可能与社交应用中显示的数量不同。这可能有以下几个原因:
    • 该帖子被推广了。API 响应中仅包含自然播放。
    • Meta 上报的数据可能存在不一致。
  • X/Twitter Threads 会以对象数组形式返回,每个对象对应 Thread 中的一条推文。
  • 对于观看次数或频道粉丝较少的视频,YouTube 处理分析数据可能需要 24-48 小时。
  • TikTok 分析:
    • TikTok 更新分析数据(例如视频观看、人口统计、点赞、分享和评论)可能需要 24-48 小时。
    • 要获得 TikTok 分析访问权限,账户所有者必须:1. 至少发布一个视频。2. 在其 TikTok 移动应用的”分析”页面点击”开启”按钮。3. 拥有 100 名粉丝,才能获得关于观众和内容互动的更多洞察。
    • 如果媒体包含受版权保护的内容或被标记为版权违规,TikTok 不会返回该帖子的分析。受版权保护的内容示例包括 Reels 上的音频(TikTok 会将这些视频静音)。你可以在 TikTok 应用的”活动 -> 系统通知”下查看。
    • 如果视频闲置超过 7 天,某些 TikTok 分析字段可能不可用。要获取这些数据,请在视频上产生新的互动(观看、点赞、评论或分享),然后在 24-48 小时后重试。如果响应中未返回视频,原因很可能是该视频因违规(例如音乐版权侵权)而被过滤。这些字段包括:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • LinkedIn 个人(成员)资料现在会返回扩展的帖子分析矩阵。可用的成员指标为:
    • impressionCount — 帖子的展示次数
    • uniqueImpressionsCount — 触达的独立成员数(LinkedIn 的 MEMBERS_REACHED
    • likeCount — 表情反应数
    • commentCount — 评论数
    • shareCount — 帖子的转发数
    • engagement — 自然点击、点赞、评论和分享数除以展示数
    • reactions — 按类型划分的表情反应明细(当有反应时)
    • 对于视频帖子:videoViewsvideoViewersvideoWatchTimeMs
    视频指标仅在视频帖子中返回,且帖子创建超过一年后不可用。
  • Instagram 动态(Story)洞察数据仅在 24 小时内可用,无论动态是否已归档或加入精选。请注意:
    • 数值小于 5 的动态媒体指标会返回 0
    • 对于欧洲和日本用户创建的动态,replies 指标会返回 0
  • Facebook 动态分析数据不可用。
  • Pinterest 分析数据(展示、用户粉丝和点击)在 24-72 小时后可用。
  • 对于 YouTube Shorts,观看次数会返回 Short 开始播放或重播的次数,不要求最短观看时长。

请求头参数

请求体参数

id
string
必填
/post 端点 返回的 Ayrshare 帖子 ID。这是返回的顶层 Ayrshare id,而不是 postIds 中的社交帖子 ID。
platforms
array
用于获取分析的平台字符串数组。接受以下取值组成的字符串数组:
如果未包含 platforms,将返回该帖子发送到的所有社交网络的分析数据。
当累计指标(例如点赞、评论、观看)暂时无法从社交网络获取时,API 会自动使用存储的数据回填。每个平台的 analytics 对象中可能出现两个可选字段:
  • backfilledFrom(字符串,ISO 8601)— 当有一个或多个累计指标被存储数据替换时出现。该时间戳表示存储数据最后更新的时间。
  • recoveredFrom(字符串,ISO 8601)— 当由于 API 完全失败而使整个分析响应从存储数据中恢复时出现。该时间戳表示存储数据最后更新的时间。
存储数据超过 4 天将被视为过期,不再用于回填或恢复。
LinkedIn 个人(成员)分析——需重新关联。 在成员帖子分析上线之前关联的个人 LinkedIn 资料没有所需的分析权限范围。针对这些资料的分析请求会返回错误码 475(“重新关联你的 LinkedIn 资料以启用分析”)。账户所有者必须在”社交账户”页面重新关联其 LinkedIn 资料,以授予新的权限。重新关联后请等待几分钟,让 475 错误码清除(Ayrshare 与 LinkedIn 都会短暂缓存权限状态,通常约 5-10 分钟)。发布不受影响。LinkedIn 成员帖子计数为尽力而为的结果:聚合的 shareCount(RESHARE)、likeCount(REACTION)和 commentCount(COMMENT)总数与 LinkedIn UI 显示的数字可能略有差异。