> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 最新动态 > 了解 Ayrshare 的最新进展。查看我们的更新日志，掌握所有精彩新功能。 [在 X 上关注我们](https://twitter.com/intent/user?screen_name=ayrshare)，收听我们的 [Social Media API Podcast](https://ayrshare.podbean.com/)，或订阅我们的 [Newsletter](https://dashboard.mailerlite.com/forms/42719/54642298519029076/share)，以获取最新动态。 ## 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](https://www.youtube.com/verify)，未验证频道是主要原因），然后再考虑 OAuth 重新关联。新增的 **发布前校验**还会在上传前捕获非 PNG/JPG、超过 2MB 或无法访问的缩略图并跳过它们，因此视频仍会正常发布，同时在 `warnings` 中报告原因（缩略图问题永不会导致发帖失败）。请参见 [YouTube Post API](/apis/post/social-networks/youtube#youtube-thumbnails) 和新的 [YouTube Thumbnail Not Applied (Unverified Channel)](/help-center/technical-support/youtube_thumbnail_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](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](/apis/comments/delete-comments) 和 [Comments Overview](/apis/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（Premium 仍为 $49/月的固定附加价格），每个计费周期最多 1,000 个活跃会话。参见 Messaging 定价。
5 月 20 日 - Instagram 分析权限错误不再自动解绑账户。 当 Instagram 分析遇到缺少权限的错误（Meta errCode 10）时，账户不再被自动解绑。此前 scope/权限问题会被当作 token 撤销处理并静默断开账户，即便发帖仍然正常。Ayrshare 现在会保持账户关联，转而返回权限 scope 错误。
5 月 19 日 - 按配置的 hideLogo。 [Create Profile](/apis/profiles/create-profile) 和 [Update Profile](/apis/profiles/update-profile) 新增布尔字段 hideLogo，可在单个用户配置的社交关联页面上隐藏账户级 logo。非常适合为个别合作方主页做白标化。
5 月 19 日 - Facebook Boost 广告组预算共享。 [Boost 接口](/apis/ads/facebook/boost-post)现在接受一个新的可选布尔参数 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 账户（授予全部权限）的信息。参见[错误码](/errors/errors-ayrshare)。
5 月 11 日 - YouTube 瞬时错误码。 因上游瞬时问题导致的 YouTube 上传失败现在会返回新的错误码 453（HTTP 504，Google ingest 超时）和 454（HTTP 503，服务不可用），并带有 retryAvailable: true 标志，你的集成可据此自动重试。详情请参见[错误码](/errors/errors-ayrshare)。
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](/apis/post/social-networks/instagram) 和[错误码](/errors/errors-ayrshare)。

## 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）。参见[错误码](/errors/errors-ayrshare)。
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" 响应。参见[错误码](/errors/errors-ayrshare)和 [Instagram Post API](/apis/post/social-networks/instagram)。
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](/dashboard/connect-social-accounts/x-twitter-byo-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](/apis/comments/post-comment) 和 [Reply to a Comment](/apis/comments/reply-to-comment) 接口的 comment 文本字符串新增了 @ 提及支持的文档，包括 LinkedIn 服务器端解析细节以及各平台 @ 提及语法的链接。
X/Twitter 消息分页。 [Get Messages](/apis/messages/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）新增了按内容类型的更大上限。完整详情请参见[媒体指南](/media-guidelines/overview)。
X/Twitter 消息支持 BYO Key。 [Get Messages](/apis/messages/get-messages) 和 [Send Message](/apis/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](/apis/post/social-networks/x-twitter) 让你对账户有更强的控制、更好的数据可移植性，以及带品牌的 OAuth 流程。所有用户必须在 2026 年 3 月 31 日前完成迁移。
可编辑的短链接。 你现在可以在发布后[更新短链接](/apis/links/update-short-link)。
定时发帖处理稳定性。 修复了定时发帖处理任务可能内存不足并返回 503 的问题。增加了资源分配、加入了分页查询处理，并引入了分布式应用锁以防止重复执行——确保每次定时发帖处理都是唯一且可靠的运行。
Facebook 与 Instagram 历史改进。 改进了 [/history/facebook](/apis/history/history-platform) 和 [/history/instagram](/apis/history/history-platform) 接口：对于 Facebook，过期/归档的 Stories 现在默认会被过滤掉，因此只有活跃 Stories 会与普通帖子一起显示，同时新增 since 和 until 查询参数，可以用 ISO UTC 日期字符串按时间筛选。对于 Facebook 和 Instagram，新增的 dataType 参数允许你只请求 posts、只请求 stories，或两者都要（默认）。
移除 X 速率限制。 作为 [X/Twitter BYO Keys 迁移](/dashboard/connect-social-accounts/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](/apis/analytics/social-by-id) 接口。
历史分页。 为 Threads 和 X/Twitter 的[按平台获取帖子历史](/apis/history/history-platform) API 添加了分页支持。不再受 500 条帖子的限制——现在可以通过分页拉取更长的历史，并将调用拆成更小的分块，以获得更快、更高效的响应。
免费试用增强。 免费试用用户现在可以测试 [Messaging API](/apis/messages/overview) 和 [Max Pack](/additional/maxpack)——在免费试用期结束前不会产生费用。
更好的错误信息。 为 [X/Twitter](/apis/post/social-networks/x-twitter) 和 [LinkedIn](/apis/post/social-networks/linkedin) 的错误信息补充了更多细节，让你更容易诊断 API 调用中的问题。
Instagram 评论修复。 修复了一个问题：带嵌套回复的 Instagram 顶层评论未从 [Get Comments](/apis/comments/get-comments) 接口正确返回。
Python SDK。 更新了我们的 [Python SDK](https://pypi.org/project/social-post-api/)，加入了最新特性与改进。
X/Twitter Webhook URL。 [Direct Message Event webhook](/apis/webhooks/actions#direct-message-event) 的负载中现在包含新的 ayrshareUrl 字段，提供一个便捷的未鉴权 URL。
Status Page Slack 集成。 你可以将我们 [Status Page](https://status.ayrshare.com) 的更新自动接入 Slack。只需点击右上角的 "Get Updates" 并选择 Slack 选项即可。

## 2026 年 1 月

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

## 2025 年 12 月今年我们以专注于透明度和可靠性收官，同时也在 2026 年 Q1 规划了大量新特性。

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

## 2025 年 11 月

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

## 2025 年 10 月

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

## 2025 年 9 月