跳转到主要内容
在 X 上关注我们，收听我们的 Social Media API Podcast，或订阅我们的 Newsletter，以获取最新动态。

​
2026 年 7 月

  • 7 月 8 日 - 更快的 API 响应时间。 我们上线了一轮后端性能优化，显著降低了我们最热门的一些端点的延迟。平均响应时间和 95 百分位（p95）响应时间都大幅下降，尤其在高负载下增益最大。改进最明显的是 profiles 和 analytics。无需任何 API 变更；每个请求都会自动变得更快。
    Endpoint平均更快p95 更快
    GET /profiles-71.6%-88.7%
    GET /analytics-59.5%-75.0%
    GET /user-51.0%-48.6%
    GET /post-47.6%-63.1%
    GET /messages-40.5%-59.4%
  • 7 月 7 日 - generateJWT 支持按会话设置 Instagram 关联方式。 generateJWT 接口现在接受一个可选的请求体参数 instagramLinkMethod，用于在单次关联会话中覆盖你的账户级 Instagram Login 设置。传入 “instagram” 时会启动直接 Instagram Login（无需 Facebook Page），传入 “facebook” 时，当用户在社交关联页面上点击 Instagram 按钮时，会通过已连接的 Facebook Page 进行关联。该覆盖只对由所返回 JWT URL 打开的关联页面生效——它会在授权跳转中保留，但绝不会更改你的账户级设置；省略该参数则保持现有行为。非法值会返回 400 并列出合法选项。详情请参见新的 Instagram Link Method 章节，包括两种流程之间的 功能差异。

​
2026 年 6 月

  • 6 月 24 日 - n8n 集成。 使用 n8n 内置的 MCP Client Tool 节点将 n8n 连接到 Ayrshare MCP Server，无需自定义代码，也无需安装社区节点。有关概览请参见新的 n8n 集成页面，有关搭建、三个实际示例、多租户 profiles、X BYO 以及可下载的入门工作流（Chat Trigger 到 AI Agent 再到 Ayrshare MCP 节点），请参见 完整 n8n 指南。另请参见 Connect & Setup 和 Tool Catalog。
  • 6 月 17 日 - Facebook 分析：Meta 停用 Reach 与 3 秒视频指标。 Meta 于 2026 年 6 月 15 日在所有 Graph API 版本中移除了唯一展示（unique-impression）和 3 秒视频观看的 Insights 指标。Facebook 帖子分析不再返回 impressionsUnique、impressionsFanUnique、impressionsOrganicUnique、impressionsPaidUnique 或 videoViewsUnique；社交分析不再返回 pagePostsImpressions* 系列（包括 pagePostsServedImpressionsOrganicUnique）。仍支持的字段（reactionsByType、videoViews、mediaView、pagePostEngagements、pageVideoViews）不受影响。请使用 mediaView / pageMediaView 表示 reach；计划推出一个 Total Unique Media Views 的替代指标。参考：Meta Graph API v25 changelog。
  • 6 月 15 日 - Facebook 账户受限错误码 476。 因 Meta 对账户施加了限制（Meta 子代码 2424009 与 1404078，或在没有子代码时 Meta 给出的限制描述）而失败的 Facebook 发帖，现在会返回专用的、不可重试的 code: 476（HTTP 400），而不是通用的可重试 code: 108。账户仍保持关联——请通过 Meta 的 Account Status 页面（Facebook → 头像 → Help → Account Status）解决该限制，那里会给出具体原因和 API 无法返回的申诉流程。详情请参见 Facebook Account Restriction。
  • 6 月 10 日 - LinkedIn 个人主页分析。 LinkedIn 个人（member）主页现在会返回一组更完善的分析数据。帖子分析包含 impressionCount、uniqueImpressionsCount（触达的成员数）、likeCount、commentCount、shareCount、engagement、reactions，对于视频帖子还包括 videoViews、videoViewers 和 videoWatchTimeMs。社交分析新增了终身 followersCount、每日 followersDaily 增长以及聚合的帖子指标。聚合的转发/反应/评论数为尽力而为，可能与 LinkedIn 界面略有出入。已有的关联账户必须在 Social Accounts 页面重新关联其 LinkedIn 主页以授予新的分析 scope——在此之前，分析会返回 code: 475（“re-link your LinkedIn profile to enable analytics”）。发帖不受影响。
  • 6 月 10 日 - TikTok 首条评论改为事件驱动。 TikTok 帖子的 首条评论不再基于固定的定时等待发出。由于 TikTok 异步处理视频，/post 响应现在会以 status: “pending” 的形式返回 TikTok 首条评论，并在 TikTok 处理完成、tikTokPublished webhook 解析出真实的视频 id 之后，自动发布该评论。视频 visibility 必须为 public，否则会返回明确的评论错误。此外，对仍在处理中的 TikTok 帖子调用 get-comments，现在会返回 code: 288，而不是一个通用的失败。
  • 6 月 8 日 - YouTube 缩略图失败现在会显式返回。 当 YouTube 视频成功发布但其自定义缩略图应用失败时，YouTube 结果现在会保持 status: “success”（视频保持在线），并新增一个 warnings 数组（feature: “thumbnail”、code: 307）来描述失败原因——此前该失败被埋在 thumbNail 子对象中，该字段目前仍保留以向后兼容。原本容易误导的 403 指引已更正为首先要求进行频道 手机验证（https://www.youtube.com/verify，未验证频道是主要原因），然后再考虑 OAuth 重新关联。新增的 发布前校验还会在上传前捕获非 PNG/JPG、超过 2MB 或无法访问的缩略图并跳过它们，因此视频仍会正常发布，同时在 warnings 中报告原因（缩略图问题永不会导致发帖失败）。请参见 YouTube Post API 和新的 YouTube Thumbnail Not Applied (Unverified Channel) 故障排查指南。
  • 6 月 8 日 - X BYOK 分析在余额耗尽时改为返回 code 416。 当 X/Twitter BYOK 账户所注册的 X Developer 账户 API 余额耗尽时，分析和用户查询路径现在会返回 code: 416（HTTP 402，X CreditsDepleted），并在 detail 中包含已注册的账户 id——此前它们被伪装成 code: 294（HTTP 400，“Unable to get X User”）。解决办法是在 X Developer Portal 中充值余额。这也使分析/查询路径与发帖路径（已经返回 416）保持一致。如果你的集成通过分析中的 294 来判定无效句柄，请增加对 416 的处理。
  • 6 月 4 日 - MCP Server 与 Claude Code 插件。 AI Agent 现在可以通过新的 MCP Server（https://api.ayrshare.com/mcp）驱动 Ayrshare API，包括 Claude Code 插件。请参见 Connect & Setup 和 Tool Catalog。原有的文档搜索 MCP 现更名为 Documentation MCP。

​
2026 年 5 月

  • 5 月 22 日 - Bulk Post Profile-Key 路由修复。 POST /post/bulk 现在会遵循 Profile-Key 请求头，因此 CSV 行会发布到解析出的 用户配置，而不是主配置。此前带 Profile-Key 的批量上传会被静默地路由到主配置对应的社交账户。参见 Bulk Post。
  • 5 月 21 日 - TikTok DELETE /comments 权限范围澄清。 更新了 Delete Comments 和 Comments Overview 页面，说明在 TikTok 上 DELETE /comments 只对经过身份验证的 TikTok 账户本身撰写的评论（你自己的回复）成功。尝试删除第三方评论会返回 Ayrshare code: 328。需要审核其 TikTok 视频上第三方评论的客户请联系支持。API 行为无变化；仅文档更新。
  • 5 月 21 日 - 隐藏 TikTok 评论。 DELETE /comments 现在支持通过 hide=true 结合 videoId，对公众观众隐藏 TikTok 评论。成功响应会返回 action: “hide” 并回显评论文本；仅发送 hide=true 而不带 videoId 会被拒绝并返回 400。隐藏的评论仍然可以在 TikTok Studio 中被视频所有者看到。
  • 5 月 20 日 - Node SDK v1.3.0 —— 支持 X/Twitter BYO。 官方 Node SDK 现在提供 setTwitterByo(apiKey, apiSecret) 和 clearTwitterByo()，用于 X/Twitter 的 Bring-Your-Own-Keys。设置之后，每次 SDK 请求都会附加所需的 X-Twitter-OAuth1-Api-Key 和 X-Twitter-OAuth1-Api-Secret 请求头——自 2026 年 3 月 31 日起 Ayrshare 强制要求 BYO 后，这是 X/Twitter 操作所必需的。通过 npm install social-media-api@1.3.0 安装；发布说明请见 npm 和 GitHub。
  • 5 月 20 日 - Messaging 按用量计费。 Business Messaging 现在通过 Stripe 按用量计费，Launch 和 Business 方案下每个活跃会话 0.09</code>（Premium仍为<code>0.09</code>（Premium 仍为 <code>49/月的固定附加价格），每个计费周期最多 1,000 个活跃会话。参见 Messaging 定价。
  • 5 月 20 日 - Instagram 分析权限错误不再自动解绑账户。 当 Instagram 分析遇到缺少权限的错误（Meta errCode 10）时，账户不再被自动解绑。此前 scope/权限问题会被当作 token 撤销处理并静默断开账户，即便发帖仍然正常。Ayrshare 现在会保持账户关联，转而返回权限 scope 错误。
  • 5 月 19 日 - 按配置的 hideLogo。 Create Profile 和 Update Profile 新增布尔字段 hideLogo，可在单个用户配置的社交关联页面上隐藏账户级 logo。非常适合为个别合作方主页做白标化。
  • 5 月 19 日 - Facebook Boost 广告组预算共享。 Boost 接口现在接受一个新的可选布尔参数 adSetBudgetSharingEnabled（默认 false）。Meta 现在要求所有在没有 campaign-level budget 的情况下创建的 campaign 都必须包含该字段，Ayrshare 也会在每次请求中都发送——默认 false 与之前的行为一致，调用方无需改动。将其设为 true 可启用 Meta 的跨广告组优化，最多可将某个广告组预算的约 20% 转移到同一 campaign 内的其他广告组，以获得更好的整体表现。
  • 5 月 19 日 - Reddit Banned-Subreddit 错误。 向你被封禁的 subreddit 发帖现在会返回一个明确的、非重试安全的错误，而不是通用的可重试 code 121。这可防止调度器对一个永久被拒绝的帖子进行反复重试。参见 Ayrshare 错误码。
  • 5 月 19 日 - Bluesky 视频大小上限。 Bluesky 视频上传的最大大小现在是 100 MB（此前文档标注为 1 GB），以匹配 Bluesky 平台限制。超过 100 MB 的文件现在会在最开始就被拒绝，而不是在上传后期失败。参见 Bluesky 媒体指南。
  • 5 月 19 日 - Dashboard 支持 BYO Key 的 X/Twitter 消息功能。 Ayrshare 控制台的 Messaging 页面现在支持 Bring-Your-Own-Keys（BYO）账户的 X/Twitter 私信。你的 X consumer key 和 secret 会在浏览器会话中被收集，并在发送、刷新、抓取图片等操作中一并使用——不会保存任何 key。自从 X/Twitter 在 Ayrshare 上强制 BYO 后，这是必需的能力。
  • 5 月 19 日 - Facebook Ads 城市定位修复。 Facebook Ads Cities 接口（GET /ads/facebook/cities）现在能正确解析城市及其对应的区域数据。每条结果都包含 region、regionId 和 supportsRegion，以便在可用时定位到城市所属区域。使用 search 查询参数传入部分或完整的城市名。
  • 5 月 18 日 - YouTube 状态字段控制。 YouTube Post API 的 youTubeOptions 新增三个可选参数：license（“youtube” 或 “creativeCommon”）、embeddable（布尔）和 publicStatsViewable（布尔——控制观看页上的扩展统计面板；基础观看和点赞数无论如何都保持公开）。/history/youtube 响应现在也会返回这些字段。两个新的校验错误码 —— 455（非法 license）和 456（非法 embeddable 或 publicStatsViewable）—— 会在 Ayrshare 边缘拒绝格式错误的请求。变现开关（开启/关闭广告）不包含在内；那需要 YouTube CMS 凭据，且不通过标准 YouTube API 提供。
  • 5 月 18 日 - GMB 首条评论不再掩盖发帖成功。 修复了一个问题：在 Google Business Profile 发帖时包含 firstComment 会返回 code: 163 且没有 postIds，即便发帖已经成功。Google Business Profile 不支持帖子评论，因此 firstComment 在 GMB 上会被跳过，同时正常返回发帖成功结果。
  • 5 月 14 日 - 预防账户解绑。 各社交网络一直在悄悄推出更严格的反机器人控制，这导致异常多的用户账户被解绑。我们已上线多项后端改进以减少解绑并让错误信息更清晰，同时更新了 账户关联页面，让 UI 对用户更清楚——包括针对 Meta 网络（Facebook、Instagram、FB Groups、Threads、Messenger）的新 “Action required” 状态，当账户陷入身份验证悬置时会显示 “Resolve with Meta” 链接和 “Check again” 探测按钮，让用户无需解绑再关联即可解决问题。
  • 5 月 12 日 - Instagram 互动自动化（Beta）。 全新的 Automations API 让你的用户可以自动响应 Instagram 上的互动——当终端用户评论帖子、回复 story、发送私信或对私信作出反应时，触发 DM、webhook 或邮件。共支持 4 种触发类型（comment_keyword、story_reply、dm_reaction、dm_keyword）和 3 种动作类型（send_dm、fire_webhook、send_email），每条规则每种最多 50 个。包括每个动作 7 天的去重（可通过 dedupWindowMinutes 按动作配置）、每日 DM 上限（Business 1,000 / Enterprise 5,000）以及基于游标分页的活动日志。Business 与 Enterprise 方案可用。新增错误码 462–472，涵盖校验、层级门槛、活跃自动化上限、缺少关联账户以及功能开关准入。Beta —— 我们正在积极收集反馈，请将 bug 报告和功能需求发送给支持团队。
  • 5 月 12 日 - 定时发帖吞吐量提升。 我们为定时发帖处理增加了更多硬件资源，吞吐量和性能显著提升。之后我们还会为 YouTube 和 TikTok 添加更多平台专用硬件。
  • 5 月 12 日 - Instagram 账户状态错误的重新关联提示。 某些 Instagram 账户状态失败（Meta error_subcode 2207085，此前以通用的 code: 258 出现且没有指引）现在会返回 relink: true 和 retryAvailable: true，并附上引导用户解绑并重新关联 Instagram 账户（授予全部权限）的信息。参见错误码。
  • 5 月 11 日 - YouTube 瞬时错误码。 因上游瞬时问题导致的 YouTube 上传失败现在会返回新的 错误码 453（HTTP 504，Google ingest 超时）和 454（HTTP 503，服务不可用），并带有 retryAvailable: true 标志，你的集成可据此 自动重试。详情请参见错误码。
  • 5 月 11 日 - X/Twitter 分析与查询对所有 BYO 用户开放。 老的 X 附加功能门槛已从 /analytics/social 和 /lookups/x 中移除。任何 X/Twitter Bring-Your-Own-Keys 客户现在都可以查询任意句柄的分析并使用 X lookups 接口，而不会遇到 code: 3。调用会使用你自己的 X Developer App 凭据进行签名，并计入你自己的 X 速率限制。
  • 5 月 8 日 - Python SDK v1.3.0 —— 支持 X/Twitter BYO。 官方 Python SDK 现在提供 set_twitter_byo(api_key, api_secret) 和 clear_twitter_byo()，用于 X/Twitter 的 Bring-Your-Own-Keys。设置之后，每次 SDK 请求都会附加所需的 X-Twitter-OAuth1-Api-Key 和 X-Twitter-OAuth1-Api-Secret 请求头——自 2026 年 3 月 31 日起 Ayrshare 强制要求 BYO 后，这是 X/Twitter 操作所必需的。通过 pip install —upgrade social-post-api 安装；发布说明请见 GitHub 和 PyPI。
  • 5 月 4 日 - 自动图片格式转换。 WebP、HEIC 和 AVIF 图片现在会在发布到不接受这些格式的平台前，自动转换为 JPEG。WebP 转换适用于 Instagram、LinkedIn、TikTok、Google My Business、Threads 和 Snapchat。HEIC 和 AVIF 则在所有支持的平台上进行转换。无需 API 变更；转换在发送时透明进行。当转换无法完成时，新增错误码 450（转换失败）、451（源下载失败）和 452（转换后图片上传失败）会显式提示。
  • 5 月 4 日 - Instagram 错误现在包含 Meta 原始信息。 Instagram 媒体状态失败现在会在 details 字段中显示 Meta 底层的错误文本，同时保留 Ayrshare 错误码，因此调用方能够区分原因（例如 robots.txt/爬虫问题 vs. token 问题），无需再根据通用错误码猜测。参见 Instagram Post API 和错误码。

​
2026 年 4 月

  • 4 月 30 日 - API Explorer 支持 X/Twitter BYOK。 Ayrshare API Explorer 现在包含一个可折叠的 X/Twitter BYOK (Bring Your Own Keys) 面板，你只需粘贴一次 X API Key 和 API Secret，就会在每次外发请求中作为 X-Twitter-OAuth1-Api-Key 和 X-Twitter-OAuth1-Api-Secret 请求头附带——不再需要退到 curl 或 Postman 才能在 Explorer 中测试 BYOK。这些值通过 sessionStorage 限定在当前浏览器标签中，默认打码显示并可切换查看，一键即可清空。请参见 X BYO Key 搭建指南 了解如何获取你的凭据。
  • 4 月 28 日 - 社交分析增强（逐步上线中）。 社交分析接口新增 Instagram shareCount（在滚动 90 天窗口内的总分享数）和 YouTube lifetimeLikes（通过 youtube: { lifetime: true } 显式开启）；上线覆盖到你的账户后，这些新字段会出现在响应中。本次更新的文档更正：Instagram viewsCount 是 90 天滚动窗口（不是 180 天），mediaCount 始终是终身值，YouTube likes 受 quarters 范围约束，TikTok 主页级指标最多 60 天；当使用 quarters 时，每帖终身语义仍然适用。
  • 4 月 28 日 - Instagram Trial Reels。 /post 接口现在支持发布 Instagram Trial Reels——首次发布时仅对非粉丝可见的 Reels。将 instagramOptions.trialParams.graduationStrategy 设为 “MANUAL”（在 Instagram 应用内手动 “晋升”）或 “SS_PERFORMANCE”（Meta 根据早期表现自动 “晋升”）。三个新的校验错误码——447、448、449——会在 Ayrshare 边缘拒绝非法的 trial-reel 请求。
  • 4 月 24 日 - Instagram 发帖稳定性。 在高峰时段扩展了 Instagram 的自动重试处理，并全面改进了错误信息。现在你会收到具体的错误码：速率限制（code: 435）和媒体处理超时（code: 436）——让你在集成中更容易诊断问题并构建更聪明的重试逻辑。
  • 4 月 23 日 - Facebook 分析速率限制错误码 444。 Facebook Page 按 Page 分析的限流（Meta 错误 80001）现在会在 post 和 social 分析响应上返回 code: 444（HTTP 429）。此前这些限流被错误归类为 code: 161（“relink your account”）。如果你的集成依赖 161 触发重新关联流程，请更新识别 444，并改为退避重试。详情请参见 Facebook Analytics Rate Limit。
  • 4 月 23 日 - Meta 媒体爬虫故障排查。 新增帮助中心文章，介绍如何修复错误 code: 440（“social network could not download media from this URL”）以及相关的 Instagram code: 138 / Threads code: 379，这些都是由 robots.txt 或 bot 规则阻挡 Meta 发布爬虫引起的。参见 Meta Media Crawler Blocked。
  • 4 月 21 日 - 审核输入错误现在返回 400。 POST /validate/moderation 现在会针对调用方的输入问题（例如作为 imageUrl 的不支持文件，或不可达/格式错误的 URL）返回新的错误 code 438（HTTP 400），而不是带有重试指引的、有误导性的 500。真正的处理失败仍返回 code 331（HTTP 500）。参见错误码。
  • 4 月 20 日 - Caption 增强错误码 441。 Post 接口现在会在 shortenLinks 等 caption 增强失败时返回错误 code: 441（HTTP 502）。如果失败仅影响部分平台，则成功平台仍会发帖并出现在 postIds 中，同时顶层为 status: “error”，各平台的失败项出现在 errors[] 中。详情请参见 Caption Enhancement Errors。
  • 4 月 15 日 - Instagram 死 token 检测。 因 OAuth token 无效/过期——或 Page 角色/权限错误（Meta 子代码 492）——而失败的 Instagram 发帖，现在会返回 Ayrshare code 161（授权错误），并自动解绑受影响账户，以便通知用户重新关联，而不是此前那种掩盖了这些情况、令人误解的通用 code 138 “please try again” 响应。参见错误码和 Instagram Post API。
  • 4 月 9 日 - Instagram 与 TikTok 分析支持全时段数据与日期筛选。 当未指定 daily 也未指定 quarters 时，社交分析接口现在会返回 Instagram 和 TikTok 的全时段数据。使用 quarters（1–4，其中 1 = 90 天）或 daily=true 按日期范围筛选——现在 TikTok 也支持。启用时，TikTok 的评论、分享和观看的时间段标签及合计值会反映筛选后的日期范围。
  • 4 月 9 日 - 分析可靠性与恢复。 社交分析和帖子分析接口现在会在社交网络临时返回 0 时，自动从已保存数据中回填累积指标（粉丝、点赞、观看数）。响应新增两个可选字段 backfilledFrom 和 recoveredFrom，指示何时使用了存档数据。此外，当没有平台返回数据时，请求分析现在会返回 400 错误（code: 187），而不是空的成功响应。
  • 4 月 1 日 - generateJWT 支持通过请求头传递 X 凭据。 Generate JWT 接口现在接受 X-Twitter-OAuth1-Api-Key 和 X-Twitter-OAuth1-Api-Secret 请求头，用于传递你的 X consumer keys——与其他所有 X/Twitter 接口保持一致。为了向后兼容，请求体参数仍然被支持。

​
2026 年 3 月

  • 3 月 30 日 - X 余额耗尽错误显式返回。 当 BYOK X/Twitter Developer 账户的 API 余额用尽时，此前会以 processing 状态卡住且没有错误的发帖现在会正确失败，并返回 code: 416（X Credits Depleted，HTTP 402）。code: 416 的检测也扩展为覆盖 X 中提到余额的 HTTP 429 响应。详情请参见错误码。
  • 3 月 28 日 - Instagram 发帖返回 null 修复。 修复了一个边角问题：Instagram 帖子在平台上成功了，但 /post 响应返回的是 null，而不是带有 postIds 和 id 的正常成功响应。现在成功的 Instagram 发帖始终会返回一个可被你集成解析的有效响应。
  • 3 月 26 日 - Instagram 每日 reach 修复。 修复了一个问题：当 daily=true 时，Instagram 社交分析会遗漏每日 reach 数据。在 daily 模式下，响应现在返回一个嵌套的 reach 对象（包含 period 和一个 values 时间序列）；非 daily 模式下仍返回标量 reachCount，并在每日数据暂时不可用时作为回退。
  • 3 月 26 日 - X/Twitter BYOK 强制执行的错误码。 随着 Bring Your Own Keys 要求正式生效，X/Twitter 请求会返回你可据以分支处理的具体错误码：419（HTTP 400，缺少 X-Twitter-OAuth1-Api-Key/Secret 请求头）、416（HTTP 402，X Developer 账户余额耗尽）和 417（HTTP 403，OAuth 1.0a 应用权限未设为 Read/Write/DM）。参见错误码了解具体信息和处理方式。
  • 3 月 23 日 - X 关键词搜索。 面向 BYOK 客户的新 关键词搜索接口。可以在 X/Twitter 上搜索匹配关键词、话题标签和高级搜索操作符的推文。支持分页、按语言与位置过滤，返回标准化的推文数据。
  • 3 月 23 日 - Listening 板块。 新增了 Listening 板块，在 Brand 接口的基础上扩展了新特性，例如关键词搜索。
  • 3 月 19 日 - 评论中的 @ 提及。 为 Post a Comment 和 Reply to a Comment 接口的 comment 文本字符串新增了 @ 提及支持的文档，包括 LinkedIn 服务器端解析细节以及各平台 @ 提及语法的链接。
  • X/Twitter 消息分页。 Get Messages 接口现在支持 X/Twitter 的 limit 查询参数，允许你只获取最新的 N 条消息（1–100），无需完整同步历史。结合基于游标的 next 参数分页，可以实现高效的轮询——先取一小批，检查是否已有，再按需继续翻页。
  • 提高视频大小上限。 由于社交发布现在大量围绕视频内容，我们在多个平台提高了视频上传上限：LinkedIn（200 MB → 500 MB）、TikTok（1 GB → 10 GB）、X Premium 长视频（1 GB → 16 GB），并为 Facebook（Reels 2 GB、Stories 4 GB、Feed 10 GB）和 Pinterest（2 GB）新增了按内容类型的更大上限。完整详情请参见媒体指南。
  • X/Twitter 消息支持 BYO Key。 Get Messages 和 Send Message 接口现在支持 BYO（Bring Your Own）X/Twitter API 凭据。BYO 用户无法通过 webhook 获取实时 DM 通知；请改用 GET Messages 接口进行轮询。
  • Bring Your Own Keys（X）。 X/Twitter 账户连接方式的重大变更。全新的 Bring Your Own Keys 让你对账户有更强的控制、更好的数据可移植性，以及带品牌的 OAuth 流程。所有用户必须在 2026 年 3 月 31 日前完成迁移。
  • 可编辑的短链接。 你现在可以在发布后更新短链接。
  • 定时发帖处理稳定性。 修复了定时发帖处理任务可能内存不足并返回 503 的问题。增加了资源分配、加入了分页查询处理，并引入了分布式应用锁以防止重复执行——确保每次定时发帖处理都是唯一且可靠的运行。
  • Facebook 与 Instagram 历史改进。 改进了 /history/facebook 和 /history/instagram 接口：对于 Facebook，过期/归档的 Stories 现在默认会被过滤掉，因此只有活跃 Stories 会与普通帖子一起显示，同时新增 since 和 until 查询参数，可以用 ISO UTC 日期字符串按时间筛选。对于 Facebook 和 Instagram，新增的 dataType 参数允许你只请求 posts、只请求 stories，或两者都要（默认）。
  • 移除 X 速率限制。 作为 X/Twitter BYO Keys 迁移的一部分，Ayrshare 不再对 X 分析强制任何月度或日度速率限制。你的用量现在受你自己的 X Developer 账户限额约束。

​
2026 年 2 月

  • 2 月 25 日 - X/Twitter 视频标题与描述。 发布到 X/Twitter 的视频现在支持在 X Post API 的 twitterOptions 对象上设置 videoTitle 和 videoDescription，用于上传到 X Media Studio 的媒体。它们与现有的 thumbNail 支持一同为视频提供更丰富的元数据。
  • 批量分析。 新增了对社交帖子 ID 批量分析的支持，通过新的 postIds 参数，一次分析调用最多可包含 100 条帖子。详细信息请见 Analytics on a Post by Social ID 接口。
  • 历史分页。 为 Threads 和 X/Twitter 的按平台获取帖子历史 API 添加了分页支持。不再受 500 条帖子的限制——现在可以通过分页拉取更长的历史，并将调用拆成更小的分块，以获得更快、更高效的响应。
  • 免费试用增强。 免费试用用户现在可以测试 Messaging API 和 Max Pack——在免费试用期结束前不会产生费用。
  • 更好的错误信息。 为 X/Twitter 和 LinkedIn 的错误信息补充了更多细节，让你更容易诊断 API 调用中的问题。
  • Instagram 评论修复。 修复了一个问题：带嵌套回复的 Instagram 顶层评论未从 Get Comments 接口正确返回。
  • Python SDK。 更新了我们的 Python SDK，加入了最新特性与改进。
  • X/Twitter Webhook URL。 Direct Message Event webhook 的负载中现在包含新的 ayrshareUrl 字段，提供一个便捷的未鉴权 URL。
  • Status Page Slack 集成。 你可以将我们 Status Page 的更新自动接入 Slack。只需点击右上角的 “Get Updates” 并选择 Slack 选项即可。

​
2026 年 1 月

  • 1 月 21 日 - 链接分析自定义域名修复。 Link Analytics 接口（GET /links/:id）现在使用你配置的自定义域名返回短链接，而不是默认的 Ayrshare 域名。如果你使用自定义短链接域名（Business/Enterprise），分析中的 URL 现在会与你的实际链接一致。
  • 1 月 15 日 - Instagram 出站消息删除同步。 当在原生 Instagram 应用中删除已发送的 Instagram 出站消息时，现在会在 Ayrshare 的 Messages 数据中被正确标记为已删除——与入站消息现有行为一致。对话历史现在在两个方向都能保持准确。
  • MCP Server。 应大家的呼声——我们重新上线了 MCP Server！将你的 AI 工具直接连接到 Ayrshare API。
  • 自助注册。 为 Business Plan 和 Launch Plan 新增了自助注册。新客户现在可以通过 Launch Plan 的 14 天免费试用体验 Ayrshare 平台。
  • X/Twitter 视频缩略图。 X/Twitter 视频帖子现在支持包含缩略图预览图片（作为 URL）。它会作为上传视频时的元数据发送。
  • Instagram 话题标签数量。 根据 Instagram 发布的新规范，Instagram 帖子 的话题标签数量限制调整为 5 个。
  • Bluesky 视频时长。 为与 Bluesky API 要求保持一致，Bluesky 视频媒体的时长上限调整为三分钟。

​
2025 年 12 月

今年我们以专注于透明度和可靠性收官，同时也在 2026 年 Q1 规划了大量新特性。
  • 12 月 23 日 - 响应中包含 X/Twitter URL 实体。 X/Twitter 的发帖和 history 响应现在会为推文正文中的链接包含 URL 实体数据：顶层的 urls 数组携带 X 的原始字段（display_url、expanded_url），另有一个 camelCase 的 entities 对象，其中同样的链接以 entities.urls[].displayUrl / expandedUrl 的形式出现——让你的集成更容易渲染链接预览并检测外链。
  • X/Twitter 实体。 X/Twitter 的 帖子分析 和 平台历史 接口现在会返回从推文文本中解析出的实体，包括 URL、@ 提及、话题标签和 cashtag，以及它们的位置信息和展示 URL。
  • Facebook 帖子分析。 Facebook 帖子分析 新增了 mediaView、mediaViewIsFromAds 和 mediaViewIsFromFollowers 等指标，用于替代已弃用的展示量指标。
  • Bluesky 评论。 改进了 Bluesky 评论获取 的支持，正确处理 AT Protocol 风格的帖子和评论 ID。
  • Threads 关联。 增强了 Threads 账户关联，可以在账户上没有 name 或 username 字段时依然正常处理。
  • 24/7 监控。 引入了专门的 DevOps 团队全天候监控平台，提升可靠性。
  • 每月账单。 系统现在会自动向主账户持有人发送每月账单邮件，让定价和付款更加透明。

​
2025 年 11 月

  • Instagram Token 刷新。 为使用直接 IG 登录（无 Facebook Page）关联 Instagram 的用户增加了长效 Instagram token 的自动刷新。
  • Facebook 分析更新。 Facebook 帖子分析 现在返回增强的展示量指标，包括 post_impressions_paid_unique、post_impressions_fan_unique、post_impressions_organic_unique 和 post_impressions_unique。
  • Facebook Page Insights。 新增了 Facebook 社交分析 字段：pageFollows、pageMediaView、pageMediaViewIsFromAds 和 pageMediaViewIsFromFollowers，同时支持聚合与按天分解。
  • Instagram 分析。 Instagram 社交分析 的 viewsCount 和 reachCount 指标现在同时支持直接 Instagram Login 和 Facebook 关联账户。
  • LinkedIn 提及。 修复了 LinkedIn 提及 的处理逻辑，能够正确区分对组织的提及和对个人的提及。
  • Dashboard 改进。 重构了 Ayrshare Web Dashboard 的 API 页面，性能更好，Messaging 用量卡片布局也更清晰。
  • 团队扩张。 我们正在扩展开发团队，以加快支持响应和特性研发。

​
2025 年 10 月

  • Ayrshare 被 Saas.group 收购。 Ayrshare 已被 Saas.group 收购。团队正在扩张，以加快特性开发并提升客户支持。
  • Webhook 历史。 新增按动作获取过去 6 个月webhook 历史的接口。
  • Facebook 广告定位。 除国家定位外，你现在可以在 boost Facebook 帖子时指定地区或城市。
  • LinkedIn 视频缩略图。 LinkedIn 历史接口 现在为视频帖子返回 thumbnailUrl，让你的应用更容易展示视频预览。
  • Reddit 帖子分析。 增强了 Reddit 帖子分析 的可靠性，改进了认证处理以避免速率限制。
  • Instagram 历史。 改进了 Instagram 帖子历史 中对大量结果集的处理，适用于帖子较多的账户。
  • Facebook 广告。 Facebook 广告历史接口 现在明确说明基于 campaign 结构会返回哪些广告。
  • Instagram 协作。 补充文档说明：由于 Instagram API 限制，某些已接受的协作帖可能不会从平台历史接口返回。

​
2025 年 9 月

  • TikTok 草稿。 向 TikTok 发送草稿帖 现在同时支持图片和视频。
  • Facebook 广告。 根据欧盟《数字服务法》（DSA）的 要求，Facebook 要求所有面向欧盟部分地区投放的广告都必须 提供定义广告受益方与付款方的值。你现在可以查询 DSA 推荐并将其加入 广告中。
  • 媒体管理。 GET media 接口 已增强以包含已上传的 大媒体文件，并会显示 expireAt 字段。
  • Threads 发帖。 轻松在 Threads 上创建 thread（也称为 threadstorm），即在 Meta Threads 上一系列相连的帖子。
  • 私信。 Facebook 和 Instagram Messaging 现在 支持发送音频文件 （AAC 或 WAV）。

​
2025 年 8 月

​
2025 年 7 月

​
2025 年 6 月

  • Instagram Login（即将推出）。 在社交 关联页面上启用或禁用 Instagram Login。Instagram Login 将在未来几周内默认启用。 如果你需要包括话题标签搜索、协作、位置标注或品牌数据在内的高级功能， 必须手动禁用此选项，改用 Facebook Page 认证。 我们建议大多数客户使用新的直接 Instagram Login， 因为它工作流程更简单，且不需要 Facebook Page。
  • 推出 Snapchat。 Ayrshare 现在支持 Snapchat。Snapchat API 支持将内容直接发布到 Stories 和 Spotlight，并 获取分析和历史。Stories 是 24 小时后消失的 临时帖子，而 Spotlight 帖子是永久的，可以帮助创作者和 企业触达更广泛的受众。
  • MCP Server。 将 Ayrshare API Docs MCP 服务 连接到你的 AI Agent。通过将 Ayrshare API 文档 MCP 服务连接到 Cursor 或 Claude Desktop 等 AI 开发工具，你可以让 AI Agent 直接访问 Ayrshare 的 文档。
  • 复制帖子。 将现有帖子复制到 另一个平台。这个新接口允许你在不同平台或不同配置下 复用成功的帖子。
  • Developer Dashboard。 开发者控制台的 发帖流程有两项新改进。除了上传媒体文件之外， 你现在也可以使用 URL 发布媒体。同时你现在还可以 查看用于发布帖子的 JSON，帮助你验证 JSON 的正确性。
  • 用户管理。 User 接口 现在会 实时返回已连接社交网络的状态，用户连接或断开 社交媒体账户时会自动更新。
  • YouTube。 在 YouTube 上发布视频时，现在可以通过设置 containsSyntheticMedia 参数披露 realistic Altered or Synthetic (A/S) 内容。查看 文档。
  • Facebook。 获取 Facebook 评论 现在会返回 指向具体评论的直接 URL。

​
2025 年 5 月

​
2025 年 4 月

​
2025 年 3 月

​
2025 年 2 月

​
2025 年 1 月

​
2024 年 12 月

  • Dashboard。Web 控制台中的 User Profiles 页面性能 已优化。无论账户中有多少个用户配置，你现在都能获得流畅的 滚动与加载体验。
  • Dashboard。Web 控制台的 Posts 页面现在允许你在历史时间轴中 包含已删除的帖子。这样你就可以像访问成功帖子一样 访问、筛选和搜索已删除的帖子。
  • 已删除帖子。如果你或你的用户在社交网络上手动删除了帖子，你可以在 Ayrshare 中将其标记为手动 删除。这样可以防止 Ayrshare 未来尝试 删除该帖子，并让你获得更准确的帖子历史。
  • Webhook。你现在可以通过一次调用获取所有用户配置的 已注册 webhook。
  • 分析。Instagram 帖子分析 现在包含 分享数、新增粉丝数、主页访问数以及主页活动计数。
  • 评论。TikTok 评论 现在会返回 发表评论的用户姓名。
  • 评论。X 评论 现在会返回 该评论回复的推文 ID。

​
2024 年 11 月

​
2024 年 10 月

Ayrshare Dashboard API Calls

​
2024 年 9 月

  • Facebook 分析。History Get All Posts 和 Analytics 接口现在会返回点赞了 Facebook 帖子的用户。 每个用户会返回用户名和用户 ID。
  • 内容审核。新增 Moderation 接口， 用于检查内容是否有害或不当。该接口 同时支持文本和图片。
  • LinkedIn 关联。此前连接 LinkedIn 公司主页需要 用户是该主页的 Super Admin。现在管理 LinkedIn 公司主页的 Content Admin 也可以连接，从而进行发帖、获取分析和 管理评论。
  • 用户管理。User 接口 现在会 为 Facebook 和 Instagram 同时返回 Page ID 和 User ID。
  • Dashboard。Web 控制台的 Post 页面现在会在 帖子来源于 RSS 订阅时显示一个图标提示。
  • Facebook Reviews。Facebook Reviews 现在会返回 评论者的头像。
  • Google Reviews。Google Business Profile Reviews 现在会返回你所有 的评论，即使有成千上万条。

​
2024 年 8 月

  • LinkedIn 历史。现在你可以获取 LinkedIn 个人 主页的帖子历史。此前只有 LinkedIn 公司主页会返回历史。 需要重新关联 LinkedIn 与 Ayrshare。
  • LinkedIn 分析。为 LinkedIn 个人和公司主页新增了可用的 数据点，包括 likedBy 和 comment 详情。
  • LinkedIn 查询。brand 接口 现在允许 查询个人或公司。这可以用来查看谁点赞了 你的帖子。
  • Facebook 历史。你可以将 Facebook Page 历史 的结果限制为仅显示该 Page 自己 发布的帖子，从而过滤掉所有并非由该 Page 发布的内容。
  • 用户配置。user 接口 现在返回一个新的 字段，即上次为该用户配置发起 API 调用的时间戳。
  • X 长文。你可以为 Premium X 账户发布长文。长文最多可 25,000 个字符。你也可以在调用分析或历史时 获取完整的长文数据， 包括长文正文中的完整内容和 URL。
  • Web Dashboard。改进了发帖页面设计，并新增多个内容类型。 你现在可以直接从控制台发布 Facebook 与 Instagram Reels 或 Stories，或 YouTube Shorts。
Updated API Dashboard
  • 团队管理。邀请团队 成员 时，现在可以看到他们 是否接受了邀请，或从 Dashboard 的 User Profiles 页面重新发送邀请。
  • AI 视频标题。视频转录 现在会附带一个建议标题。这对上传 YouTube 视频很有用—— YouTube 每次上传视频都要求提供标题。（需 Max Pack）
  • 暂停帖子。你可以通过 post 接口暂停和恢复定时 帖子。
  • 情感分析。generate 接口 现在 可以为帖子或评论生成情感分析，判断是负面、正面还是中性。 结果还包括改进建议。
  • Instagram 分析。Instagram 分析 已 增强，可返回互动受众的更多人口统计数据。
  • TikTok 图片。你现在可以使用图片在 TikTok 发帖。此前必须是视频。

​
2024 年 7 月

​
2024 年 6 月

  • Ayrshare Messaging API。Ayrshare Messaging 附加功能 是一个可选的付费附加功能， 让你的平台可以管理用户的私信，包括 Facebook Messenger、 Instagram Messaging 和 X/Twitter Messaging。
  • YouTube 评论。你现在可以通过 YouTube 评论 ID 在 YouTube 上删除评论。
  • 自动话题标签。全新重构的自动话题标签 系统 会给出更相关的话题标签，且不再对 帖子长度设限。每条帖子的话题标签数量上限也提升到 10 个。
  • Web Dashboard。控制台 UI 已更新：可以一键 移除发帖页面中所有目标社交网络，同时 API Key 页面新增 代码示例区域。
  • 用户配置管理。Profiles 接口已 增强，允许你按拥有活跃社交账户或 包含特定平台的配置过滤结果。

​
2024 年 5 月

  • Google Business。你现在可以更新你的 Google Business Profile 位置 数据，包括电话号码、网站 URL、地图位置等。
  • 历史搜索。使用 History 接口，你现在可以在你所有用户配置中搜索 帖子 ID。当你有一个帖子 ID 但不知道它属于哪个用户配置时非常有用。
  • 用户配置标签。为用户配置添加你自己的标签， 以便更好地组织和管理配置。Web 控制台也允许你在 User Profiles 页面 查看已分配的标签并按标签搜索。
  • YouTube 字幕。使用 SRT 或 SVB 文件为 YouTube 视频添加你 自己的自定义字幕。
  • NPM 包。发布了更新的 Node.js NPM 包，新增了接口 并提供了更详细的文档。该包也已改名为 social-media-api。
  • Facebook 评论。你现在可以在 Facebook 评论中将图片作为 评论的一部分。
  • LinkedIn 评论。LinkedIn Comments 现在会返回该具体评论的 点赞数。
  • LinkedIn Brands。用于查询 LinkedIn 数据 的 Brands 接口新增了账户的本地化名称、 公司专长和公司描述等信息。
  • 禁用评论。你可以在 Instagram、LinkedIn 和 TikTok 的帖子上 禁用评论。适用于新帖或已发布的帖子。
  • 历史帖子。可以获取来自 TikTok 且并非通过 Ayrshare 发布的 帖子的历史数据。
  • Instagram 分析。为 Instagram Stories 新增了可用数据点，包括回复、分享和退出计数。
  • AI 生成。使用 AI 基于一张或多张图片生成社交媒体 帖子文本。也可以用来写图片说明。
  • Web Dashboard。控制台中列出的每个用户配置，你都可以查看 其已连接的社交网络。将鼠标悬停在每个社交网络图标上可查看 在该社交网络上的名称。
  • 社交关联。在 Web 控制台和你的社交关联页面上，现在会在 Page 或公司名称旁显示 对应主页的头像。

​
2024 年 4 月

​
2024 年 3 月

  • Instagram 协作者。Instagram 协作允许你与其他账户共同创作内容。公开的原作者 可以将另一个私密或公开账户标记为协作者。为媒体帖子添加 Instagram 协作者。
  • Google Business Profile。现在可以获取更多 Google Business Profile 数据，包括指向评论和地图的 链接、place Id 等。要获取这些额外数据需要重新关联 Google Business Profile。
  • Facebook Page、Instagram、Google Profile 位置。在 Page 关联 界面上，你现在可以为 Facebook Page、Instagram 账户和 Google Business Profile 显示 Page 位置。
  • Facebook Profile 分析。Facebook 社交主页 分析 现在最多返回 4 个季度的数据。 你可以选择返回聚合数据或按天数据。
  • Facebook 历史。Facebook Stories 现在也会由 Get All History 接口 返回。
  • 社交关联页面。Ayrshare 社交关联页面现在支持 跳转 到最初打开它的标签或窗口。
  • Facebook Reviews。你现在可以回复 Facebook 上的评论。
  • Instagram Followers。Instagram Get Followers Online 已增强 UTC 格式。 该数据返回每小时 Instagram 在线粉丝的历史总数， 从而帮助你为最大化互动优化发帖时机。
  • Instagram 轮播。现在可以在 Instagram 轮播 中同时发布视频和图片。 最多可包含 10 项组合媒体。
  • TikTok。TikTok caption 现在支持使用 “\n” 字符换行。

​
2024 年 2 月

  • Reviews。使用新的 /reviews 接口获取、回复和删除 Google Business Profile 和 Facebook Pages 上的评论。
  • LinkedIn 评论。对于在 Ayrshare 之外发出的评论，可通过评论 ID 获取 LinkedIn 评论。
  • LinkedIn 提及。评论和评论回复中的 LinkedIn 提及 现在会解析为对应的组织 handle。
  • 公开主页数据。你现在可以在 brand 接口 中搜索 Facebook Page 和 LinkedIn 名称。查询用户或公司 的社交媒体公开信息，例如粉丝、 头像和网站。这些用户和公司无需是 已关联的 Ayrshare 用户。
  • Facebook 评论。用于 Facebook 评论 的评论接口现在会在响应体中直接返回 回复。
  • Instagram 被封禁的话题标签。可通过新的 API 接口 或新的 Web 工具 检查被封禁的话题标签。 这可以帮助你避免账户被暂停或隐性封禁。
  • Facebook Groups。Facebook 宣布将移除 Facebook Groups 的 API 访问权限。了解 详情。

​
2024 年 1 月

  • 更长的 Instagram 视频。Instagram 视频帖子 现在 支持最长 15 分钟、1 GB。此前上限为 60 秒和 100 MB。
  • 翻译帖子文本。在 100 多种语言中选择要将你的帖子文本 翻译成什么语言。例如可以从英语翻译到法语，或从西班牙语翻译到德语。 源语言会被自动检测。
  • 错误信息翻译。错误信息可以自动 翻译 为你选择的语言。 当你希望以用户偏好的语言直接向他们展示错误时，这非常有用。
  • Pinterest 分析。获取全部历史 时可以拿到更多的 Pinterest 数据点，包括帖子标题、备注和 board id。
  • 检查帖子长度。Check Post Length 接口 现在包含对 Facebook、Google Business Profile、LinkedIn、Pinterest 和 YouTube 的校验。
  • 新的用户批量接口。当你需要大量数据集时，批量 接口是一个很好的选择。你可以使用批量接口获取所有用户配置的 json 文件，然后使用 webhook 在文件准备好时通知你。
  • LinkedIn 历史帖子。获取在 Ayrshare 之外发布的 LinkedIn 帖子的历史数据。
  • LinkedIn 帖子反应。LinkedIn 的 Get All Post 接口 现在会返回帖子的 反应，例如 Likes、Praise、Maybe 和 Appreciation。
  • 上次 API 调用时间。在 Web 控制台的 API Key 区域可以查看你 上次使用该 API Key 的时间。
  • Ayrshare Dashboard 历史。Web 控制台现在允许你通过新的 “Load more” 按钮 加载所有历史帖子或 webhook 日志。
  • Webhook 错误。查看你 webhook 的错误率， 了解成功与错误响应的比例。

​
更早的更新

请查看 Update Archive 查看更早的更新。