分析 API 概述

Ayrshare 的一项关键能力是可以获取帖子和社交账户的实时分析数据。 具体而言，你可以衡量并分析用户内容的表现和互动情况，例如视频观看次数、点赞、链接点击和分享，以及用户的影响力。 借助分析数据，你可以为用户构建自定义报告、将数据回传到你的 AI 模型中，或对帖子表现进行分析。 分析端点主要有三种类型：

1. 帖子分析：获取某条帖子的分析数据
2. 社交分析：获取某个社交账户的分析数据
3. 链接分析：获取某个短链接的分析数据

​

数据的新鲜程度

每个成功的分析响应都会携带两个时间戳：

• lastUpdated：你当前看到的指标是何时从社交网络获取的。
• nextUpdate：请求最早会在何时再次获取新的指标。

在这两个时间之间，重复请求会返回相同的数字。更频繁地调用并不会产生更新的数据，因此 nextUpdate 才是安排轮询计划的有用信号。 该间隔不是固定的，你也不应该为它硬编码一个值：它会因社交网络而异，在某些网络上还会因帖子的发布时间长短而异。互动大多集中在帖子发布后的头几天，因此一条数字已不再变化的较早帖子，其刷新频率可以远低于新近的帖子——在 LinkedIn 上，发布超过约十天的帖子每天最多刷新一次。账户分析使用自己的间隔。nextUpdate 始终会告诉你当前响应适用的是哪个间隔。 如果你需要按计划获取这些数字，请从响应中读取 nextUpdate，而不要按固定的定时器轮询——它会告诉你何时才有新数据可以获取。 错误响应可能会省略这两个字段，因此请以防御性的方式读取它们，而不要假设它们始终存在。

​

帖子分析

可以获取单条帖子的分析数据。如果你希望获取某条特定帖子（无论是通过 Ayrshare 发送还是在社交网络上手动发布的）的详细分析数据，这非常有用。 以下社交网络支持帖子分析：

• Bluesky
• Facebook
• Instagram
• LinkedIn
• Pinterest
• Reddit
• Snapchat
• Threads
• TikTok
• YouTube
• X/Twitter

可以通过提供 Ayrshare 帖子 ID 或原始帖子的社交帖子 ID 来获取特定帖子的分析数据。

​

社交分析

你还可以获取账户级别的社交分析数据，例如互动、粉丝数量与人口统计信息，以及账户元数据。 如果你想获取整个社交账户（而不是某条特定帖子）的分析数据，请使用此端点。 以下社交网络支持社交账户级别的分析：

• Facebook
• Google Business Profile
• Instagram
• LinkedIn
• Pinterest
• Reddit
• Snapchat
• Threads
• TikTok
• YouTube
• X/Twitter

你也可以选择获取聚合摘要或按天的社交分析数据。

​

链接分析

你还可以获取短链接的分析数据。如果你想了解某个链接（无论是通过 Ayrshare 发送还是在社交网络上手动发布的）收到了多少点击，这非常有用。 链接分析数据可在 /links 端点中找到。