Skip to main content
GET
此端点用于获取当前已认证用户或 user profile 的详细信息,包括:
  • 所有已关联社交媒体账户的完整列表
  • 社交媒体用户名和 profile 信息
  • 账户状态和使用指标
返回的数据反映截至上一次刷新时已连接社交网络的状态,并会在用户连接或断开其社交媒体账户时更新。
响应缓存。 响应最多会被缓存 60 秒。lastUpdated 和 nextUpdate 字段描述的正是这个缓存窗口:lastUpdated 是快照构建的时间,nextUpdate 是它过期的时间。nextUpdate 是缓存过期标记,而不是就绪信号。 它会被打在每一次响应上,包括 displayNames 中尚未列出你刚刚收到通知的账户的那次响应,因此它无法告诉你一个新关联的账户何时完成传播。如果你正在对一次全新关联的 social webhook 进行核对,请持续轮询,直到你预期的账户真正出现在 displayNames 中——不要把单次响应,或者 nextUpdate 的到来,当作该关联缺失或已完成的确认。
Threads 的 username 与 displayName。 在 displayNames 的 Threads 条目中,username 是账户的 handle(例如 ayrshare),displayName 是个人资料上显示的名称(例如 Ayrshare)。两者可能不同,因此请使用 username 或 profileUrl 来查找 Threads 账户。
若未关联任何社交账户,则不会返回 activeSocialAccounts。 若要获取特定 User Profile 的数据,请在 header 中添加 Profile-Key。
  • 如果你的业务需要一次性收集所有 user profile 数据,请使用 /user/batch 端点。
  • 如果你希望在用户关联或解绑社交账户时收到通知,请参阅 /webhooks 端点。

Header 参数

Query 参数

boolean
默认值:false
返回额外的 Instagram 详情,例如账户类型(business 或 creator)和已用配额。 除非你确实需要这些附加数据,否则不建议启用,因为会拖慢响应时间。

每月发帖配额

响应会显示该资料的每月发帖配额已使用了多少:
  • monthlyPostCount:本月已计入配额的帖子数。
  • monthlyPostQuota:每月上限。当配额为 10,000 或以上时(例如 Business 计划),该字段会被省略。上限仍然适用。
计数在每月 1 日 00:07 UTC 重置,而不是在你的账单日期。失败的发帖尝试也会计入。monthlyApiCalls 是另一个计数器,不是发帖配额。关于哪些内容会计入以及配额用完时会发生什么,请参见我可以发布多少帖子和调用多少 API?。