Skip to main content
在 X 上关注我们，收听我们的 Social Media API Podcast，或订阅我们的 Newsletter，以获取最新动态。

​
2026 年 10 月

  • 10月14日 - 现已提供每月帖子配额重置日期和代码 106 的文档。 文档现在说明了每月帖子配额：配额在每月 1 日（UTC）重置，而不是在您的账单日期重置；失败和被拦截的发帖尝试也会计入配额。如果 /post 返回 HTTP 429 及 code: 106，而您以为触发了速率限制，实际上是该 profile 已用完其每月帖子配额。请参阅我可以发布多少帖子和调用多少 API？，了解哪些内容会计入配额以及如何查看您的用量。
  • 10月14日 - Bluesky 视频保留真实宽高比。 从 Amazon S3 URL（任何 amazonaws.com 主机）发布到 Bluesky 的方形或竖屏视频，在 Bluesky 信息流、帖子视图和应用中都会在两侧显示黑边，尽管上传的文件本身是正确的。帖子记录无论视频的实际形状如何都声明 16:9 的宽高比，而 Bluesky 根据该声明确定播放器尺寸。现在，只要能够读取视频，Bluesky 视频帖子就会携带视频实测的宽度和高度，因此 1:1 或 9:16 的视频会以其真实形状呈现。发布方式无需任何更改：照常发送相同的 mediaUrls 即可。此修复之前发布的帖子保留创建时的宽高比；请重新发布以进行更正。请参阅 Bluesky 媒体指南。
  • 10月13日 - Facebook 和 Instagram 推广支持广告活动预算。 现在，推广可以通过 budget.level: “campaign” 将预算设置在广告活动上而不是广告集上，支持每日预算或总预算。该功能使用推广请求体的嵌套格式。对于每日广告活动预算，历史记录中的 budgetDaily 会显示该广告活动的预算。请参阅 Facebook 推广和 Instagram 推广。
  • 10月13日 - X 媒体上传在额度耗尽时返回代码 416。 当 BYOK X/Twitter 账户所注册的 X Developer 账户的 API 额度用尽时，图片和视频上传现在会返回 code: 416（HTTP 402，X CreditsDepleted），并在 details 中附上 X 的说明。此前，图片上传失败时返回 code: 117 (“Please check the media file size, dimensions, and content-type”)，视频返回 code: 115，两者都把问题指向了一个从未出错的媒体文件。解决方法是在 console.x.com 购买额度（Billing → Credits）。这些上传不会重试，因为在账户获得额度之前，任何重试都不会成功。这使媒体上传与发布和分析路径保持一致，后两者早已返回 416。如果您的集成依据 117 或 115 判断 X 上的媒体问题，请添加对 416 的处理。
  • 10月13日 - 被锁定的 X 账户在媒体上传时返回代码 224。 当 X 暂时锁定账户时，向 X 发布图片或视频会失败：图片返回 code: 117 (“Please check the media file size, dimensions, and content-type”)，视频返回 code: 115，导致您去检查一个本来没有问题的媒体文件。这些上传现在会返回 code: 224 (“X/Twitter account locked. Please go to twitter.com to unlock.”)，并在 details 中附上 X 自己的说明。要解决此问题，请登录 x.com 并完成 X 的解锁步骤，然后重新发布。无需重新关联，账户仍与 Ayrshare 保持关联。
  • 10 月 13 日 - Facebook 评论 webhook 现已正常触发。 为 Facebook 主页注册的 comments webhook 此前从未收到任何事件：Ayrshare 没有订阅承载主页评论的 Meta 字段，因此没有任何事件到达，也没有任何错误。现在 Facebook 主页已完成订阅，只要资料上启用了消息功能（Messaging Add-On），评论事件就会被投递。已连接的主页会自动重新订阅，无需重新关联或重新注册。Facebook 评论以 Meta 主页 feed 结构 (comment_id, post_id, message, from.name) 送达，与 Instagram 的结构不同；两者请参阅 Comments Action。Instagram 评论 webhook 保持不变。
  • 10 月 13 日 - 可打开聊天的推广按钮。Facebook 或 Instagram 推广的按钮现在可以打开 Messenger、WhatsApp 或 Instagram Direct 对话，而非网页，因此您现在可以推广一篇能与您的企业发起聊天的帖子。请发送 callToAction.destination（messenger、whatsapp 或 instagramDm）以及对应的按钮类型，不要发送 link，并使用 engagement 或 interactions 目标。此时广告会针对对话进行优化。此功能使用推广请求体的嵌套格式。请参见 Facebook 推广和 Instagram 推广。
  • 10 月 9 日 - 推广到您现有的 Facebook 和 Instagram 广告活动。推广不再必须创建自己的广告活动。使用 attachTo.campaignId 时，它会在您已在 Meta 中运行的广告活动中添加新的广告集和广告。使用 attachTo.adSetId（加上该广告集的 attachTo.campaignId）时，它仅添加广告，并且您需省略 budget、targeting 和 bidAmount，因为广告集会保留其自身的设置。之后暂停或激活推广只会改变推广所创建的内容，绝不会改变您的广告活动或广告集。此功能使用推广请求体的嵌套格式。请参见 Facebook 推广和 Instagram 推广。
  • 10 月 9 日 - 减少 Instagram 误报的重新关联错误，轮播发布更快。现在，对于 Instagram 刚刚接受的帖子，我们会在发布前稍作等待，并在发布轮播前检查其是否已就绪，因此 Instagram 拒绝首次尝试的情况大幅减少。此前，在媒体处理完成后立即发布的帖子可能会以 code: 259 失败，并提示您取消关联并重新关联 Instagram 账户，即使账户本身没有问题、重试该帖子也能成功；此外，由于 Instagram 拒绝了首次发布尝试，大多数轮播比实际需要多花约 10 秒。您无需做任何更改；因此原因而出现的 259 并不需要重新关联。
  • 10 月 8 日 - Instagram 和 Threads 视频帖子发布更快。我们优化了视频发布流程以加快实时发布速度：Instagram 上的典型等待时间从约 20 秒缩短至 5 秒，Threads 上从约 31 秒缩短至 6 秒。较长或分辨率更高的视频仍可能需要 25 到 30 秒，因为这是 Meta 自身处理它们所需的时间。你无需做任何更改。
  • 10 月 8 日 - 可按带 act_ 的账户 ID 列出 Facebook 和 Instagram 广告。当 accountId 带有 act_ 前缀（例如 act_1234567890）时，Facebook 和 Instagram 已推广广告现在会返回你的广告。此前只有纯数字形式有效：带前缀的形式会返回空的 ads 列表，就好像该账户没有任何广告。同样的修复也适用于 GraphQL ads 查询和 MCP list_ads 工具。在这些接口中，不是有效广告账户 ID 的 accountId 现在也会返回 code: 101，而不是空列表。
  • 10 月 8 日 - Facebook 和 Instagram 评论错误现在包含平台给出的原因。当 Facebook 或 Instagram 拒绝通过发布评论或回复评论发送的评论或回复时，错误现在会在 details 中包含平台给出的原因及其错误代码和子代码，例如 “Instagram Comment Not Added: Your Instagram comment was not added (code 20, subcode 1772107)“。此前这些错误只返回一条通用消息，您无法得知评论失败的原因。
  • 10 月 7 日 - Threads 短暂未就绪时，Threads 帖子不再因 Code 379 而失败。部分 Threads 帖子即使本身没有任何问题，也会因 code: 379（“Error posting to Threads.”）和 HTTP 500 而失败。Ayrshare 现在会等待最多 30 秒让 Threads 接受帖子，Threads 评论、回复和首条评论也会获得同样的等待。如果 Threads 仍未准备好接受帖子，您将收到 code: 522（HTTP 400，retryAvailable: true），而不是 379。关于如何安全地重试，请参见 Code 522。
  • 10 月 7 日 - Connect Accounts 邮件发送失败时仍会返回链接 URL。如果您请求我们通过邮件将链接 URL 发送给用户，而邮件无法发送，生成链接 URL 和 创建 Link Session 现在仍会返回该 URL，并附带 emailSent: false 和一个 emailError 对象，这样您可以通过其他方式把它发给用户。此前，发送失败会返回 code: 333 且不返回 URL；而缺少 termsUrl, privacyUrl, company 或 contactEmail 的 email 对象会被静默跳过。现在这种情况也会返回 emailError，并由 details 列出缺少的字段。如果您在收到 code: 333 时会重试，请检查这一点：改为在成功响应中查找 emailError，详见 Connect Accounts 邮件。
  • 10 月 6 日 - Pin 支持 Pinterest AI 披露。Pinterest 发布现在支持 pinterestOptions.aiDisclosures，您可以在创建图片、轮播或视频 Pin 时发送 AI_MODIFIED、SYNTHETIC_PERFORMER 或两者。披露适用于整个 Pin。如果省略该字段或其为空，则不会有任何变化；如果该字段无效，Pin 仍可发布，且 Pinterest 结果中会包含一条警告，说明披露未被转发。
  • 10 月 6 日 - Facebook Reels 可邀请合作者主页。在 Reel 帖子的 faceBookOptions.collaborators 中添加一个 Facebook 主页 ID，即可邀请该主页作为合作者；每个 Reel 支持一个主页。邀请会在 Reel 发布后发送，您可以通过 Collaborator Request Status 查询其状态。Facebook 仍可能拒绝该邀请，例如当该主页与您的主页属于同一个 Business 资产组合时：此时 Reel 仍会保持发布状态，响应会在 warnings 中附带警告。如需安排此类 Reel，请使用 scheduleDate，而不是 draft 或 scheduledPublishDate。请参见 Facebook Reels。
  • 10 月 5 日 - 实时 Facebook 和 Instagram 广告洞察。历史记录显示的是我们计费的每日支出，每晚复制一次，覆盖过去 30 天。新的洞察端点则实时读取 Meta 的数据，因此您现在可以针对过去 37 个月内任意时间范围报告某个活动或广告。每一行代表一天，包含 spend、impressions、reach、clicks、cpm、cpc、ctr、actions、conversionValue 以及广告账户的 currency。使用 metrics 选择所需的指标，使用 breakdowns 按 age、gender、country 或 placement 细分每一天的数据，并使用 cursor 对较长的时间范围进行分页。使用 breakdowns 时，Meta 仅报告过去 13 个月的 reach。广告组报告目前尚不可用。请参阅 Facebook 洞察和 Instagram 洞察。
  • 10 月 5 日 - LinkedIn 个人主页的每日粉丝增长。Analytics on a Social Network（/analytics/social）中的 followersDaily 对 LinkedIn 个人主页始终返回空数组。现在它会返回过去 30 天的每日粉丝数。
  • 10 月 5 日 - Pinterest 用户名。对于 Pinterest 账户，User Profile Details 响应中的 username 返回的是所选图板的名称而不是账户用户名，因此 profileUrl 指向一个不存在的个人资料页。现在 username 返回账户用户名，profileUrl 会打开正确的个人资料页，无需重新关联。displayName 仍返回图板名称。
  • 10 月 5 日 - Threads 用户名。对于 Threads 账户，User Profile Details 响应中的 username 返回的是账户的显示名称而不是其账号名（handle），因此 profileUrl 指向一个不存在的个人资料页。现在 username 返回账号名，profileUrl 会打开正确的个人资料页，无需重新关联。如果您将 username 显示为账户名称，请改用 displayName。
  • 10 月 2 日 - 支持在美国以外推广特殊广告类别帖子。 带有 specialAdCategories（例如 housing）且定位美国以外地点的 Facebook 或 Instagram 推广会失败并返回 “You’ve chosen audience locations that are outside of the countries you selected for your Special Ad Categories”，同时在您的广告账户中留下一个空活动。Meta 需要知道特殊类别广告投放的国家/地区，而我们之前没有告知，因此 Meta 默认使用美国。现在我们会从您的 locations 中获取这些国家/地区，包括每个地区和城市所属的国家/地区，因此您现在可以在美国以外推广住房、就业和金融类帖子。如果推广在活动创建后失败，我们现在还会尝试删除该活动，因此失败的推广应该不会再留下空活动。请参阅 Boost Post。
  • 10 月 1 日 - Facebook 社区标准拦截错误码 249 的说明已更新并正式收录文档。 随 249 返回的消息不再声称帖子本身违反了 Facebook 的社区标准。Facebook 通常将拦截施加在账号或主页上，而不是帖子上，且不会通过 API 返回具体原因，因此该消息现在会引导至 Facebook 的 Account Status 页面：登录 Facebook，点击右上角的头像，打开 Help 部分并选择 Account Status，即可查看真实原因并进行申诉。当 Facebook 提供了说明文本时，它仍会原样放在 details 中。这也是 249 首次被公开收录到文档中，请参阅 Facebook 社区标准拦截。仅消息文本有所变化，数值错误码、HTTP 状态和响应结构均保持不变。客户端应匹配数值 code，而不是确切的消息文本。
  • 10 月 1 日 - 关联页面现在会提示链接已过期。 关联 URL 默认有效期为 5 分钟。以前，如果链接在您的用户仍在登录社交网络时过期，关联页面会显示通用的 “There was an error linking” 消息，导致您的用户继续使用同一个已过期的链接重试。现在，他们会被告知链接已过期，需要获取新链接。在 Snapchat 和 TikTok 上，您的用户可能会返回到一个未登录的页面，现在他们会看到 Link expired 页面，而不是 Ayrshare 登录页面。如果您使用 Ayrshare Connect Widget，此类失败的 error 事件现在会包含 code，链接过期时为 503，因此您的代码可以为用户创建新链接。如需给用户更多时间，请在创建链接时调高 expiresIn（最多 2880 分钟，Max Pack）。

​
2026 年 9 月

  • 9 月 29 日 - 使用 GraphQL 查询 Ayrshare API。 现在，除 REST API 外，还新增了位于 https://api.ayrshare.com/graphql 的 GraphQL 端点，你可以在一个请求中执行多个受支持的操作，而无需为每个操作单独发起调用。它使用相同的 API Key、配置文件作用范围和计划限制，而 REST 仍是功能完整的 API。由于 GraphQL schema 是类型化且自描述的，你的编辑器可以自动补全每个可用的操作和参数，代码生成器也可以据此为你所用的语言生成类型。每个由 API 支撑的根字段计为一次 API 调用，与等效的 REST 调用完全相同：包含四个根操作的查询会计入四次配额调用，而不是一次；选择嵌套的响应字段则不会增加调用次数。单个请求最多可发起五次 API 调用，请求体上限为 64 KB，这意味着媒体字节无法通过 GraphQL 传输。请改用 mediaUploadUrl 获取上传 URL，将文件直接 PUT 到其 uploadUrl，然后在帖子中使用返回的 accessUrl。编写错误处理时需要注意一点：失败的操作仍会返回 HTTP 200，并在响应体中报告失败，因此请始终检查 errors，而不要仅依赖状态码。GraphQL 错误列出了会改变状态码的情况。你可以在 GraphQL Explorer 中无需编写任何代码即可试用，并参见 GraphQL API 概述开始使用。
  • 9 月 29 日 - Facebook 主页支持私信自动化。 自动化现在可以在与资料关联的 Facebook 主页上运行，而不仅限于 Instagram。创建自动化时设置 “platform”: “facebook” 并使用 dm_keyword 或 dm_reaction 触发器，即可在有人向你的主页发送关键词或对你的某条消息作出表情反应时，在 Messenger 中自动回复。send_dm 会从主页发送，fire_webhook 和 send_email 的工作方式与 Instagram 上相同。该资料需要为 Facebook 激活 Messaging。评论和动态触发器仍仅限 Instagram。请参见 Facebook 主页。
  • 9 月 29 日 - Facebook 唯一覆盖指标回归。 自 Meta 于 6 月 15 日下线其唯一展示指标以来，Facebook 分析仅报告总观看数（mediaView 和 pageMediaView），同一用户会被重复计数。帖子分析现在会返回 totalMediaViewUnique，即帖子被播放或展示给的唯一用户数；社交网络分析则会为您的 Page 返回 pageTotalMediaViewUnique。两者均来自 Meta 的 Total Unique Media Views 指标，也就是 Meta 为已下线字段推出的替代指标。Meta 按天报告 Page 的该指标值，因此 pageTotalMediaViewUnique 是这些每日计数的总和：同一用户在两个不同日期查看了您的内容会被计为两次。所有现有字段均保持不变。有关各个已下线字段对应的替代字段，请参见 6 月 15 日迁移说明。
  • 9 月 29 日 - Meta 无法抓取你的媒体时，错误信息更清晰。 媒体抓取 / 爬虫被拦截导致的失败（Meta 子代码 2207052）以前返回通用、可重试的 code: 440（Instagram；Facebook Reels 为 code: 108），现在改为返回专用、不可重试的 code: 479（HTTP 400）。当 Ayrshare 已将媒体重新托管到自己的 CDN 上、Meta 仍无法抓取时，就会返回该代码。错误信息会指出可能的原因（主机通过 robots.txt 或 CDN/WAF 规则拦截了 Meta 的爬虫 facebookexternalhit / Facebot）以及解决方法（放行这些爬虫，或改用 Meta 可以访问的主机提供媒体）。真正的临时性接收失败（子代码 2207032 / 2207003）仍返回 code: 440（Instagram；Facebook Reels 为 code: 108），并附带重试建议。参见Meta 媒体爬虫被封禁和错误代码参考。
  • 9 月 28 日 - 更新帖子现在会拒绝未做任何更改的请求，并可单独接受 disableComments。 此前当 disableComments 是您发送的唯一字段时，更新帖子会返回 code: 101，因此您必须额外添加其他字段（例如 notes）才能开启或关闭评论。现在它可以单独使用。另一方面，此前没有任何更新内容的请求会返回 status: “success”，但实际上没有做任何更改。这包括仅含 id 的请求、空的 youTubeOptions，以及将 visibility 放在顶层而不是 youTubeOptions 内发送的请求，因此拼写错误看起来也像是成功了。这些请求现在会返回 code: 101。如果您在顶层发送 visibility，请注意：它从未更改过视频，现在会返回错误而不是成功。请将其移到 youTubeOptions 内。
  • 9 月 28 日 - 更改 YouTube 视频的可见性不再重置其许可。 此前通过更新帖子更改 youTubeOptions.visibility 会将视频的许可重置为 Standard YouTube License，因此以 “creativeCommon” 发布的视频在您将其设为公开或不公开列出的那一刻就会失去 Creative Commons 许可。现在许可会被保留。如果您在此修复之前更改过 Creative Commons 视频的可见性，请在 YouTube Studio 中检查其许可。
  • 9 月 25 日 - 推广的 Facebook 帖子现在会定位到您选择的性别。 推广 Facebook 帖子此前会忽略文档中记载的 gender 参数，因此使用 “gender”: “female” 或 “male” 发送的推广会展示给所有性别，而请求本身仍然成功。现在 gender 已生效，Instagram 推广同样适用。如果您发送了 gender，请注意：除 all、male 或 female 以外的值现在会返回 code: 101，而不是悄悄地定位所有人。不含 gender 的请求不受影响。
  • 9 月 25 日 - 准确查看每条自动化发送了什么。 Get Automation Activity 中的每个动作结果现在都会记录该动作发送的内容：发送给该用户的私信文本、入队时的邮件，或附带投递 id 的 webhook 事件数据。这些内容位于新的 sent 字段中，旁边是 config，后者记录该动作在当时的设置。此前活动记录只显示每个动作的状态，因此一旦你编辑了自动化，就无法查看之前某次运行实际发送了什么。这两个字段在发送失败时也会记录，过长的文本会被缩短以满足大小限制，发生截断时会设置 truncated。参见sent 包含的内容。
  • 9 月 24 日 - 用你自己的服务器撰写每条自动化私信。 此前，send_dm 自动化会向每个人发送相同的模板，只有 之类的占位符会变化。在动作上设置 messageUrl 后，每当规则匹配时，我们都会询问你的端点要对这个人说什么，并将其回答作为私信发送，因此每位评论者都能收到由你自己的系统为其撰写的消息，例如附有其专属追踪链接的回复。如果你的端点响应缓慢、返回错误或返回无法使用的内容，我们会改为发送该动作的常规 message。我们从不重试对你端点的失败调用，因为重试可能会发送第二条私信。在 Get Activity 上，messageSource 显示 send_dm 是基于哪段文本构建的：你端点的文本还是常规 message。它在文本选定后即被记录，包括随后发送失败的情况，因此请查看 status 以确认私信是否已发出。参见动态消息内容。
  • 9 月 24 日 - Instagram 自动化 Webhook 现在携带其上下文并可报告结果。 自动化触发的 webhook 现在包含 activityId、actionId、eventId、commentId、commentText、postId 和 storyId，因此你可以将它与 Get Activity 返回的那一行精确匹配，而不必从 recipientId、triggerId 和关键词去猜——当两个人同时评论同一个关键词时那样做会产生歧义。在自动化的 fire_webhook 动作上设置 “sendCompletedEvent”: true，即可在派发完成时同时收到 automation.completed，附带其 status 和每个动作的结果，因此你通常无需轮询即可得知结果（Get Activity 仍是用于对账的权威记录）。两个事件现在都携带 type 字段（automation.triggered 或 automation.completed）；每个现有字段都保持不变，未选择开启的接收方仍然每次触发恰好收到一个载荷。参见 webhook 事件。
  • 9 月 24 日 - 让评论自动化在每条帖子上运行，而不是一帖一条。 comment_keyword 触发器现在可以将 “all” 作为其 postId，这样当有人在所连接账户的任意帖子或 Reel 上评论关键词时，规则都会触发。此前 postId 必须指定某一条特定内容，这意味着每次发布都要新建一条自动化——一旦忘记，规则就会悄悄地什么也覆盖不到。动态触发器同样接受将 storyId 设为 “all”。“all” 绝不会触及另一个资料的内容，你的每日私信上限以及锚定于互动的发送规则与单帖规则完全一样地适用。去重按自动化计数，因此在一条 “all” 规则上，某人在去重窗口内于两条帖子上评论只会收到一条私信。将 dedupWindowMinutes 设为 0 会为每条匹配的评论都发送私信，包括同一帖子上的重复评论。该值必须是全小写的 “all”；诸如 “ALL” 之类的变体现在会被拒绝，而不会被保存为一条永远不会触发的规则。你自己的评论现在也不再运行自动化的 fire_webhook 或 send_email 动作。过去用关键词回复你的粉丝会触发它们，而一条 “all” 规则会在每条帖子上这样做；这些活动现在会被记录为 skipped，与私信此前的处理一致。现有自动化不受影响——具体的 postId 仍只匹配那一条帖子。参见常青规则。在动态触发器上，省略 storyId 的行为仍与 “all” 相同，但请优先使用显式取值：省略方式将在未来版本中被淘汰，并会提前在即将进行的 API 变更上公告。
  • 9 月 24 日 - 对回复帖请求 X 评论现在会返回其回复。 此前，针对本身是一条回复的 X 帖子调用 Get Comments，即使该帖子有自己的回复也会返回空列表，因为 Ayrshare 查找了错误的对话。这类帖子现在会返回其回复。自身开启一段对话的 X 帖子保持不变，仍会返回与之前相同的全部内容。另外，当 X 因你自己的 X 开发者账号而拒绝读取时，你现在会收到带类型的错误，而不是空列表：X 额度耗尽时返回 code: 416（HTTP 402），X 对请求进行速率限制时返回 code: 364（HTTP 429），因此“额度用尽”不再看起来像“没有评论”。这两种错误都不会被缓存，因此你解决问题后读取会立即重试；在多平台读取中，响应为 status: “partial”，失败的 X 分支会列在 errors[] 中，与其他失败分支的处理方式一致。已被删除的帖子，或你的 X 凭证无法查看的帖子，仍会返回空列表且不带错误。参见错误码 364 和 416。
  • 9 月 21 日 - Get Messages 现在在 X/Twitter 上也返回有界分页。 针对 X/Twitter、不带 limit 发送的 Get Messages 请求，现在最多返回 100 条已存储的消息——使用 conversationsOnly 时最多返回 100 个会话——并附带一个 meta.pagination 游标。正是这种请求此前会在一次响应中返回你的全部已存储历史记录，因此从未跟随游标的集成现在只会看到最新的 100 条，必须跟随 meta.pagination.next 获取其余部分。只要 meta.pagination.hasMore 为 true 就继续。status、action 和 conversationsOnly 仍然适用于这种请求，但它们现在一次只作用于一个有界的页面：经筛选的页面可能较短，或为空但 hasMore 仍为 true，因此请跟随游标，而不要把较短的页面当作结束。在 X/Twitter 上发送 limit 的行为保持不变，仍会通过 X 自己的游标分页读取 X 的实时时间线，该方式不应用上述三个筛选条件。游标现在会记录它来自两者中的哪一组，因此在跟随游标时传入或省略 limit 都不会悄悄地把你切换到另一组。
  • 9 月 21 日 - Google Business Profile 分析支持日期范围和每日数据。 社交网络分析现在对 gmb 同样支持 quarters 和 daily，与 Facebook、Instagram、Snapchat、TikTok 和 YouTube 已有的行为一致。传入 quarters（1 到 4，每个季度 90 天）可针对最近的时间窗口生成报告，而不再局限于固定的过去 24 个月累计总量；传入 daily: true 可让每个指标以按天的 values 序列返回并附带 total，因此你可以基于 Google Business Profile 数据构建上月或上季度报告以及时间序列图表。此前这两个参数对 gmb 会被静默忽略，只能获取 24 个月的总量。如果你已经在包含 gmb 的请求上发送 quarters 或 daily，请检查你的代码：这些参数以前对该网络会被忽略，因此同样的请求现在会返回更窄的时间窗口；并且在 daily: true 时，每个 gmb 指标会以 对象而不是单个数字返回——绘制图表或对这些数值求和的代码需要读取 total（或 values 序列），而不是直接读取指标本身。不带这两个参数发送 gmb 的请求完全不变。当日期范围生效时，响应中还会返回 quarters。
  • 9 月 21 日 - quarters: 0 现在在 Facebook 和 YouTube 上同样表示全时段数据。 在社交网络分析上，发送 quarters: 0 在文档中一直表示“无日期范围”——即与省略该参数时相同的全时段数据——Instagram、Snapchat 和 TikTok 也确实是这样处理的。但 Facebook 和 YouTube 并非如此：它们会把任何 quarters 值都当作对日期范围的请求，并静默返回单个季度，因此 quarters: 0 在 Facebook 上得到的大约是 85 天而不是完整的时间窗口，而这些网络无法解析为数字的值则根本不会返回任何可用的时间窗口。两者现在都与文档记录的行为以及其他所有网络保持一致。如果你向 Facebook 或 YouTube 发送 quarters: 0、负数的 quarters 或非数字的 quarters，请检查这一点：同一个未作任何改动的请求现在会返回完整的全时段窗口而不是单个季度，因此数字会更大，响应覆盖的时间段也更长。发送 quarters: 1 可以得到你此前意外获得的那个单季度。quarters 取值为 1 到 4 的请求，以及完全省略该参数的请求，在所有网络上都保持不变。
  • 9 月 18 日 - 在你自己的控制台内部关联社交账户。 Ayrshare Connect 小组件就是一个 script 标签：加载它，在布局中每个网络所在的位置放一个插槽，我们就在那里渲染一个连接按钮，并且它已经显示该账户是否已关联。此前，让用户连接账户的方式只有两种：把他们送到我们托管的页面，或者你自己动手构建——每个网络一个会话、在点击处理器中同步打开的弹窗、一次 event.origin 检查，以及带宽限窗口的 popup.closed 轮询，这些浏览器管道你必须在第一个账户连接成功之前全部做对。小组件接管了这一切以及取消关联，并通过十个事件报告发生的事情——包括 state，它在挂载时以及每次变化时提供每个网络的实时账户状态，因此你永远不用为此轮询。使用 —ayr-connect-* 设计令牌设置样式；如果你的页面发送 Content-Security-Policy，请添加 script-src 和 frame-src 条目。小组件需要 Max Pack。参见 Ayrshare Connect 小组件。
  • 9 月 17 日 - Get Messages 现在返回有界的已存储历史分页。 Get Messages 现在在 Facebook、Instagram 和 WhatsApp 上默认最多返回 100 条消息或会话。此前，省略 limit 可能会加载整个已存储的历史记录，耗尽服务器内存，并以 503/504 错误中断其他请求。默认值和最大值均为 100；将 limit 设置为 1 到 100 之间的整数可获得更小的页面。要获取更多内容，请将 meta.pagination.next 作为下一次请求的 next 参数传入，并保持相同的用户配置和筛选条件。只要 meta.pagination.hasMore 为 true 就继续，即使经筛选的页面较短或为空。现有响应字段保持不变，但此前期望在一次响应中获得全部历史记录的 Facebook、Instagram 和 WhatsApp 集成现在必须跟随游标。X/Twitter 的行为及其现有的可选提供商游标协议保持不变——X/Twitter 已于 9 月 21 日跟进，请参见上方对应条目。
  • 9 月 14 日 - 你的 X 和 Threads 选项现在同样适用于线程。 以前发布线程时，随线程一起发送的几乎所有选项都会被丢弃。长视频是最明显的例子：longVideo: true 与 thread: true 一起发送时，会在帖子到达 X 之前就被拒绝并返回 code: 182 —— “最长 140 秒” —— 因此长视频在线程中根本无法使用。现在它可以正常发布，并按 4 小时的长视频上限而不是标准的 2 分 20 秒进行校验。更隐蔽的另一半影响的帖子要多得多：altText、字幕、地理限制、replySettings、subscribersOnly 和 Pro Media 选项会被静默丢弃——线程照常发布，而这些选项根本没有被应用，响应中也没有任何说明。在 Threads 上，allowCountries 也以同样的方式被丢弃。所有这些选项现在都会生效。大多数适用于线程中的每条帖子；poll、quoteTweetId、replyId 和 replySettings 仅适用于第一条帖子，因为 X 只在那里接受它们。altText 和字幕仅适用于第一条帖子上的媒体——后续帖子上的媒体在发布时不会带有它们，因此暂时不要期望在多媒体线程中为每张图片提供描述。参见哪些选项适用于线程。如果你已经在线程上发送选项，有两项变更需要你注意。账户无权使用的选项现在会使线程失败，而不再被忽略：从没有 X Subscriptions 的账户发送 subscribersOnly 会返回 code: 111 且不会发布任何内容，而此前线程会公开发出。在 Threads 上，从 Meta 未授予地理限制资格的账户发送 allowCountries 会返回 code: 101 且不会发布任何内容，而此前线程会不受限制地发出——请先检查 /user 上的 isEligibleForGeoRestrictions。这两者都与单条帖子一贯的行为一致。最后，将 longPost 与 thread 一起发送现在会返回一条警告，说明 longPost 已被忽略；线程仍会发布，因为线程会将你的文本拆分到多条独立的帖子中，无法以长格式发布任何内容。错误码 182、101、111 和 275 现已记录在错误码中。
  • 9 月 14 日 - 为 Instagram Reel 附加授权音乐。 你现在可以搜索 Instagram 的音频目录，并在发布 Reel 时附加一首授权曲目。使用 GET /media/instagram/audio/search 查找曲目，用音频查询核对你已有的曲目，然后在发帖时将其 id 作为 instagramOptions.audioConfiguration.audioId 传入。可选的 audioVolume 和 videoVolume（0 到 100 的整数）用于设置曲目与视频自身音频的混音方式；省略它们时，Instagram 会应用其默认值 100。你不需要 reels: true 或 isVideo: true —— 视频 URL 会被自动检测为 Reel，并以同样的方式接受音乐。音乐仅限 Reels：Stories、图片和轮播会返回 code: 515。现有的 audioName 保持不变，仍然只为视频中已有的音频设置显示名称；如果两者同时发送，audioConfiguration 生效，audioName 被丢弃，并在 postIds[].warnings[] 上返回非致命的 code: 518 警告，帖子仍会发布。使用前需要先确认一项要求：Meta 的 Audio API 仅面向通过 Facebook Login 连接的 Instagram 账号开放，这需要一个连接到该 Instagram 账号的 Facebook Page。使用 Instagram Login（默认方式）关联的账号在每次音频调用上都会返回 code: 514，任何权限或计划都无法改变这一点。关于如何切换，请参见音乐附加资格，以及错误码 514 到 518。
  • 9 月 11 日 - Facebook 已推广广告：行动号召按钮、流量目标，以及按类别过滤的兴趣搜索。 Boost Post 新增 traffic 目标（针对平台外链接点击进行优化），以及 callToAction 对象，用于请求在推广帖子上显示一个按钮 —— APPLY_NOW、SHOP_NOW、LEARN_MORE 及另外六种 —— 打开您指定的任意 URL。在控制台中，选择 Drive Traffic（引导流量）即可设置目标 URL、按钮类型和可选的标题。按钮在现有帖子上如何呈现由 Meta 决定。callToAction 会在推广响应中返回，之后 已推广广告 端点也会在广告上返回它。兴趣 端点新增 specialAdCategories 查询参数，因此住房、就业、金融或政治类活动可以只搜索 Meta 允许其定位的兴趣，而不必先选好 ID、之后再让广告被拒绝。在这两个端点上，financial_product_services 和 financial_products_services 现在被视为同一类别 —— credit（Meta 对该类别的旧称）同样如此 —— 因此无论是本文档中的拼写，还是您可能从 Meta 复制来的拼写，都可以使用。有三项变更在符合您的情况时需要您采取行动。第一，callToAction 以前在任何目标下都会被接受然后被静默忽略，生成一条没有按钮的广告；现在除非目标为 traffic，否则会返回 code: 101。第二，Boost Post 上无法识别的 specialAdCategories 值以前会被丢弃，活动会以未分类状态创建，使受监管的广告在未声明任何类别的情况下持续投放；现在会返回 code: 101 并列出可接受的取值。第三，当提供了 specialAdCategories 时，兴趣端点现在要求提供 accountId，因为 Meta 只在广告账户上提供按类别过滤的兴趣搜索 —— 不带 specialAdCategories 的兴趣搜索完全不变，仍然无需 accountId。当您确实提供它时，accountId 必须为数字（开头带 act_ 也可以）；其他任何形式现在都会被拒绝并返回 code: 101，而不再原样发送给 Meta。
  • 9 月 8 日 - 一次调用返回每个网络的账户状态。 GET /profiles 接受 include=state，为一个 User Profile 的每个社交网络恰好返回一个规范化的 state——linked、unlinked、suspended、restricted、rateLimited 或 identityVerificationRequired——每个都附带 actionable、message 和 helpUrl。此前你必须自己从 suspension、socialHealth 和 linkingErrors 块中拼出同样的全貌，并判断哪个条件优先。每个网络始终都会出现，因此从未关联过的网络会报告 unlinked 而不是缺失，而 actionable 告诉你是否应该向用户显示一个按钮。需要 refId，因此这是针对单个 profile 的查询。
  • 9 月 7 日 - 月度计划可立即取消，并自动退款。 从 “Account”（账户）页面取消按月订阅现在提供第二种选择：今天就结束计划，退款自动退回原支付方式，并以向你计费时所用的货币退还。若在扣款后 48 小时内取消，我们全额退还该笔付款；超过之后，我们退还计费周期中未使用的部分。无论哪种情况，控制台都会在你确认前显示具体金额。此前唯一的自助选项是在计费周期结束时取消，因此想要退款就得给支持团队发邮件，再等人工核算。使用前有三点需要了解：你的访问权限在确认的那一刻即告终止，而不是持续到周期结束，这也意味着你的帖子、分析数据和已关联社交账户的删除会更早开始；任何尚未开具账单的按量计费用量会单独计费，而不是从退款中扣除；并且这是每个账户仅限一次的选项。年度计划仍在计费周期结束时取消。另外，如果你最近一次付款失败，现在无论哪种计划，取消都会立即结束计划，而不是安排在之后生效；如果该笔付款首次失败距今不到 48 小时，未支付的账单将被作废。参见如何变更或取消订阅。
  • 9 月 7 日 - LinkedIn 较早帖子的分析刷新频率降低，nextUpdate 会告诉你何时刷新。 发布超过约十天的 LinkedIn 帖子的分析数据现在会从缓存中返回，一次最长可持续几天，而不再是每十一分钟重新获取一次。帖子的互动大多集中在发布后的头几天；此后，同样不再变化的数字每天仍会被重新获取约 130 次，而 LinkedIn 对我们的应用在所有账户上每天可以发起的分析请求总数设有上限——这个上限被消耗在了不可能发生变化的数据上。新近的 LinkedIn 帖子不受影响，仍保持同样的十一分钟节奏，其他社交网络也完全没有变化。在所有网络上发生变化的是：nextUpdate 现在会报告实际应用于你当前响应的间隔，而不再是固定的十一分钟——在某些网络上，该间隔此前就已经长于十一分钟，只是没有被准确报告。如果你在轮询，请从每个响应中读取它，而不要使用固定的定时器。没有任何字段被删除或改名，也不会有请求被拒绝，账户分析仍保持自己的间隔。参见数据的新鲜程度。
  • 9 月 7 日 - 在用户连接账户的那一刻得知。 在创建 link session 时传入 origin，在弹窗中打开返回的 url，你自己的页面就会被告知其中发生了什么：账户连接成功时是 connect:success，失败时是带错误码的 connect:error，用户中途退出时是 connect:cancelled。此前唯一的了解方式是轮询，或者使用 redirect 参数让你的页面被导航走并重新加载——这会丢失用户眼前的一切状态。事件通过 postMessage 只发送到那个确切的来源，别处都不会；并且 connect:success 只在账户保存之后到达，因此紧随其后的 GET /user 已经能显示该连接。每次连接恰好到达一个结果事件。没有设置 origin 的链接没有任何变化，redirect 也保持原样继续工作，包括它的 origin=true 查询参数——它与上面新的 origin body 参数无关，也没有被弃用。如果你无法使用弹窗，获取 Link Session 现在还会报告 completedAt、lastCompletedAt 和 completedNetworks——这是不经过浏览器的同一信号，也是 Telegram 唯一的信号，它的关联在带外完成。参见关联完成事件。
  • 9 月 2 日 - Reels 现在接受带查询字符串的视频 URL。 使用带签名的 CDN 或 Firebase Storage 媒体 URL 发布 Facebook 或 Instagram Reel —— 即任何在文件名后带有 ? 查询字符串的 URL —— 此前会在帖子到达社交网络之前就被拒绝并返回 code: 170，错误地报告媒体资源不正确，尽管视频本身是有效的。媒体类型现在会从 URL 的路径中读取，因此像 https://cdn.example.com/reel.mp4?Expires=1756700000 这样的 URL 会被识别为视频并正常发布。你不再需要用 isVideo: true 作为临时解决办法 —— 它仍然有效，而显式的 isVideo: false 仍会强制按图片处理。在不带 isVideo: true 的情况下，URL 路径上没有视频扩展名的 Reel 仍会被拒绝并返回 code: 170 —— 但错误信息现在会指明这一原因，并指向 isVideo，而不是媒体指南。同样的修正也适用于 Facebook、LinkedIn、Pinterest 和 TikTok 上按帖子计算的媒体数量限制——这些平台的视频上限低于图片上限：带查询字符串的视频 URL 现在会计入视频上限，而不是图片上限，因此一条帖子中包含两个这样的视频会被正确拒绝，而此前它们会漏过校验。参见媒体指南。
  • 9 月 2 日 - WhatsApp 现已列入受支持的社交网络。 WhatsApp 现在会出现在文档各处的受支持社交网络列表和数量统计中，因此你无需事先知道要去搜索它就能找到它。在 Ayrshare 上，WhatsApp 是一个消息网络：通过 Messaging API，使用 GET /messages/:platform 检索会话和入站消息，使用 POST /messages/:platform 发送消息；关于可以附加哪些内容，请参见 WhatsApp 媒体要求。本次发布没有改变 WhatsApp 的任何行为 —— 只是改变了它在文档中出现的位置。
  • 9 月 1 日 - Bluesky 视频最长可达 10 分钟、最大 300 MB。 Bluesky 于 8 月 26 日提高了其视频限制，Ayrshare 现已接受新的上限：一条 Bluesky 视频最长可达 10 分钟、最大 300 MB —— 此前为 3 分钟和 100 MB。以前更长或更大的视频会在发布前就被拒绝，并返回视频过长或视频过大的校验错误，尽管 Bluesky 本身是会接受它的。你的发帖方式没有任何变化：像以前一样发送相同的 mediaUrls 即可。完整要求请参见 Bluesky 媒体指南。

​
2026 年 8 月

  • 8月31日 - 无需 Private Key 即可创建社交账号链接 URL，并可将其吊销。 创建 Link Session 仅凭您的 API Key 和一个 Profile-Key 即可创建社交账号链接 URL —— 无需 privateKey，也没有任何需要签名的内容。此前每个链接 URL 都要求您发送我们签发给您的 RSA private key，这意味着要存储它、在每次调用时从磁盘读取它，并在 PEM 中混入多余换行符时调试 code: 189（“no start line”）错误。现在您还可以通过获取 Link Session 查看链接是否已被打开，并通过吊销 Link Session 在链接过期前将其终止 —— 过去发错地址的 URL 会一直保持有效直到超时，没有任何办法收回。生成链接 URL 保持可用：privateKey、base64 和 verify 仍会被接受并且现在会被忽略，domain 保持可选且仍会被校验，您已经发出的链接不受影响。如果您把返回的 url 直接传给用户，那么对您而言没有任何变化。有一种情况确实需要改动：token 现在是以 ayr_ls_ 开头的不透明字符串，而不再是可解码的 JWT，因此解码它以读取 apiKey、profileKey 或 exp 声明的集成将不再工作。请改为从 expiresIn 字段读取过期时间；至于另外两个值，请使用您已经发送的值，因为 token 从来只是把它们原样回显给您。
  • 8月27日 - Instagram 通用内部错误不再要求你重新关联。 当一条 Instagram 帖子因 Meta error_subcode 2207085（“Generic Internal Error”，通用内部错误）而失败时，现在会自动重试发布，最长约 50 秒，然后才返回该错误，并且 code: 258 响应不再设置 relink: true。该标志曾告诉集成方账户已断开连接，导致客户去解除并重新关联那些从未损坏的账户 —— 同一账户在多次失败之间用未变的 token 持续成功发布。请在几分钟后重试发布；仅当错误持续超过 24-48 小时时，才需要重新关联账户，或携带现在会在 details 中返回的 fbtrace_id 联系 Meta 支持。参见错误码。
  • 8月26日 - 消息 Webhook 现在会告诉你社交连接何时已失效。 当我们无法从社交网络解析某条消息的元数据时,Facebook 或 Instagram 消息 webhook 现在会携带 connectionDegraded: true。conversationId 和 senderDetails 是在每条消息到达时查询得到的,只要该查询失败就会设置这个标志 —— 通常是因为该 User Profile 的连接已过期或已失效,不过暂时性的 Graph API 错误也会设置它。此前唯一的发现方式是注意到这些字段缺失,而一个只做监听的集成永远不会注意到;某个 profile 的每条消息上都带有该标志,意味着凭据已失效,而只在一条消息上出现则只是一次抖动。在此期间入站消息会持续到达,因此不会丢失任何内容,但只要该标志处于设置状态,通过 API 回复消息和获取会话历史同样会失败,因为两者需要同一份凭据。请将其视为需要让该 profile 重新关联账户的信号。另外,Facebook 消息现在会在连接降级期间从你已存储的消息历史中恢复其 conversationId,因此进行中的会话仍会保持串联,而不会以未关联的形式到达;Instagram 此前已经如此。健康的连接上没有任何变化 —— 该字段会被省略,而不是以 false 发送。参见新消息事件。
  • 8月25日 - Webhook 投递现在可以挺过 endpoint 故障。 一次失败的 webhook 投递此前只会重试两次 —— 分别在 5 秒和 30 秒之后 —— 因此所有尝试都会在大约 35 秒内结束。endpoint 的停机时间只要超过这个范围,事件就会永久丢失。暂时性失败现在会在大约一小时内获得最多 9 次投递尝试 —— 首次发送加上 8 次重试,之后还会按递减计划再次尝试投递,分别在大约 5 分钟、30 分钟、2 小时和 12 小时之后,因此投递最晚可能在原始事件之后约 16 小时才送达。endpoint 在事故或维护窗口期间不可达、超时或返回 5xx,不再意味着你会丢失通知。请注意,这取决于 endpoint 是如何失败的:一次因路由尚未注册而返回 404 的部署属于拒绝,而不是暂时性失败,仍会在第一次尝试时即视为最终结果。此机制适用于 429、408 和 425 响应、任何 5xx、超时和连接中断。其他任何 4xx —— 400、401、403、404、410 —— 现在都会在第一次尝试时即视为最终结果,因为重复发送一个已被你的 endpoint 直接拒绝的请求无法改变结果;Webhook 历史(Premium)会列出你近期的投递,让你看出哪些失败了 —— 它是只读的,不会重新发送。由于重试现在最晚可能在许多小时之后才送达,你的去重键必须至少保留 24 小时;更早过期的键无法识别延迟抵达的重试,你会重复处理同一个事件。完整契约请参见 Webhooks 概览。
  • 8月24日 - 评论和提及 Webhook 现在会携带 Ayrshare 帖子 ID。 comments 和 mentions webhook 负载现在会包含 postId —— 即事件所在帖子的 Ayrshare id,与你创建帖子时发布帖子返回的 id 相同。此前负载中只携带该帖子在社交网络上自己的 id(Instagram 评论中的 media.id、Instagram 提及中的 media_id、Facebook 上的 post_id),因此要把事件匹配到你创建的帖子,就得自己维护一份原生 id 到 Ayrshare id 的映射表。现在可以扔掉这份映射表了。postId 是尽力而为的,在无法确定时会被省略而不是发送空值:帖子是直接在 Instagram 或 Facebook 应用中创建而非通过 Ayrshare 发布的、发布于此功能上线之前(不会回填),或者属于关联到同一账户的另一个 User Profile。在 mentions 上它通常不存在,因为提及一般发生在他人的帖子上。请把缺失的 postId 理解为“不是我发布的帖子”,而不是错误。参见将评论与你创建的帖子关联起来。
  • 8月24日 - 评论和提及 Webhook 现在会标明来源网络。 comments 和 mentions webhook 负载现在会携带一个 platform 字段,用于标明事件来自的社交网络。这对 comments 影响最大:Instagram 评论到达时带有 id、text 和 media.id,而 Facebook 主页评论则以 feed 变更的形式到达,带有 comment_id、post_id 和 message —— 因此为两者同时注册的 endpoint 过去只能通过恰好出现的字段名来推断来源网络。请改为根据 platform(instagram 或 facebook)分支。在 mentions 上它始终为 instagram,因为目前不投递 Facebook 主页提及。其他字段均未变化,现有的处理逻辑可继续工作。参见 Comments Action 和 Mentions Action。
  • 8月19日 - 通过 API 编辑你的 WhatsApp 商家资料。 更新用户现在在 gbp 之外还接受 whatsapp，因此你无需离开 Ayrshare 就能更改客户在你的 WhatsApp 商家资料上看到的内容：about、description、address、email、最多两个 websites、vertical 中的商家类别，以及通过 profilePictureUrl 设置的资料照片。只发送你想要更改的字段。资料照片必须是正方形的 JPEG 或 PNG——推荐 640×640——Ayrshare 会代你上传到 WhatsApp，因此你只需要一个公开可访问的图片 URL。WhatsApp 商家资料会返回你当前的资料。你的 WhatsApp 显示名称无法在此编辑：它与你的号码绑定，且需要 WhatsApp 自己的审核。
  • 8 月 18 日 - 媒体检测服务故障不再归咎于你的媒体主机。 如果 Ayrshare 在发布前使用的媒体检测服务无法访问或返回无效响应，发布现在会返回可重试的 499，而不是把这次失败转换为 164，并要求你修改本来正常的媒体 URL、CDN 或 user-agent 规则。真正的媒体访问失败仍会返回现有的验证错误。两者的区别请参见媒体抓取 / 爬虫访问错误。
  • 8月18日 - YouTube Engaged Views 现已加入分析数据。 帖子分析和社交分析现在会为 YouTube 返回一个 engagedViews 字段——即在播放初始几秒之后被计入的观看数。2026 年 8 月 24 日起，YouTube 将把其 views 指标改为从视频开始播放的那一刻起计数，不再有最短观看时长要求，并适用于所有视频格式——因此在该日期，views 会出现一次性跃升。如果你的报表依赖于此前的计数方式，请将这些报表切换到 engagedViews，它会继续沿用旧的计数方式。完整细节请参见即将进行的 API 变更。
  • 8月17日 - 你的品牌色现在也会作用到对话框的主按钮上。 连接账户对话框中的 Submit（提交）和 Yes（确定）按钮，即使你的 CSS 文件已经设置了 ，也仍会保留 Ayrshare 的蓝到粉的渐变——而且这个渐变根本无法通过样式表覆盖，因为它是一张叠在你设置的任何颜色之上的背景图，位于一个在 CSS 中与旁边的 Cancel 按钮无法区分的按钮上。它现在会把你的 作为纯色使用，因此对话框中最显眼的控件也能与你的品牌保持一致。按钮上的文字标签以及按钮处理期间显示的加载指示器，都会依据你的强调色自动选取，在黑色与白色之间取更易读的那个；悬停时强调色会朝远离文字颜色的方向偏移，而不是一律加深，因此文字在悬停时同样清晰可读。请根据它同样会绘制的被选中单选按钮来挑选强调色，文字颜色会自动跟随。如果你需要特定的文字颜色，例如你自己调色板中的某种米白色或近黑色，请设置 ，它会覆盖自动选择，并把对比度交由你自己负责。如果你没有设置 ，则没有任何变化。
  • 8月17日 - 定时发布的 Instagram 帖子现在会发布其首条评论。 单独定时发布到 Instagram 的帖子上的 firstComment，此前会被接受，然后在发布时被悄无声息地丢弃：帖子按计划发出，评论从未出现，也没有任何报错返回。立即发布到 Instagram 是正常工作的，这让人误以为问题出在定时发布上，而不是评论本身。定时发布的 Instagram 帖子现在会以与立即发布的帖子相同的方式添加首条评论。同时定时发布到 Instagram 以及另一个支持首条评论的网络（例如 Facebook 或 LinkedIn）的帖子从未受此影响，立即发布的帖子也没有变化。如果你之前的临时处理方式是手动添加评论，或把这些帖子切换为立即发布，现在可以恢复带 firstComment 的定时发布方式。
  • 8月17日 - 新增用于 profile 暂停事件的 Suspended Webhook。 注册新的 suspended webhook action,即可在 User Profile 被暂停或重新激活的那一刻收到通知,而不用通过 403 响应才发现。suspend 事件会携带在可用时记录下来的 reason(例如 Facebook 的身份验证要求)、在由社交网络触发时携带 platform、暂停的 origin,以及时间戳;unsuspend 事件则会告知你 profile 已再次激活,可以恢复发帖。可像注册其他 action 一样通过 注册 Webhook 注册它,负载详情请参见 Suspended Action 参考。
  • 8月16日 - 自定义 CSS 现在可以为关联对话框着色。 白标连接账户页面上的对话框 —— 解绑确认、Facebook 与 LinkedIn 的主页选择器、Bluesky 与 X 的凭据表单，以及 Telegram 激活码输入框 —— 之前无论你的 CSS 文件如何设置，都会以 Ayrshare 的默认浅色主题渲染，因此一个深色的关联页面会弹出一个白色的面板。现在有十个新的 custom property 可以为它们着色：、、、、、、，以及 、 和 。请把它们设置在 :root 上，而不要设置在某张卡片上，因为对话框渲染在页面内容之外。任何你没有设置的属性都会保留当前的颜色，因此已有的样式表在你主动启用之前不受影响。完整列表和一个实际示例请参见 Linking Dialog Colors。
  • 8月15日 - 你的自定义 CSS 加载前不再有默认主题闪现。 使用你自己的 CSS 文件的白标连接账户页面，此前会在你的样式表接管之前，短暂显示 Ayrshare 的默认浅色页面。如果你的样式表是深色的，那看起来就像每次加载都出现一次白色闪现——包括用户每次连接完账户返回时，因为返回的正是同一个页面。现在页面会等你的样式表就绪后再显示任何内容，因此你的用户永远不会看到它下面的默认页面；页面还会记住你的样式表，这样再次访问时会立即应用你的配色，而不是等文件被重新取回之后才生效。如果你的 CSS 文件无法访问，页面仍会正常加载，而不会一直等它。没有 CSS 文件的连接页面保持不变。
  • 8月14日 - 自定义 CSS 深入连接账户卡片内部。 你的 Max Pack 自定义 CSS 现在又有五个 class 名可供白标连接账户页面使用：已连接账户头像上的 social-account-avatar、承载网络 logo 的方块上的 social-account-icon、网络名称上的 social-account-name，以及承载页面的两个容器上的 social-linking-page-column 和 social-linking-header。列有意与 main-content 分开，这样你可以在不缩窄页面背景的前提下让卡片更宽；而用 display: contents 扁平化头部之后，就可以通过 order 重新排列 logo、卡片、Close 按钮和说明区块。“Connected” 和 “Messaging” 徽标还会读取两个 custom property： 和 ，你可以在 social-account-card 上一次性设置；像 “Relink required” 这样的警告徽标仍保留自己的颜色，因此已经无法工作的账户看起来仍然像一个警告。如果你的样式表此前是通过数元素或选中某个 Mui class 名来到达这些元素的，请针对上文列出的名称重写那些规则——它们才是会继续有效的名字。完整清单和实际示例请参见 Customize CSS。
  • 8月14日 - 关联页面上方留出更多呼吸空间。 白标连接账户页面的内容起始位置在页面上更靠下，因此你的 logo 和标题不再紧贴浏览器窗口的顶部。其他部分都没有变化，如果你的样式表已经在 main-content 上设置了 padding-top，它仍会保持自己的值。
  • 8月13日 - YouTube 频道身份信息加入 social webhook。 social webhook 现在包含一个可选的 account 对象，用于标识被关联或取消关联的具体社交账户。YouTube 是首个填充该对象的平台，因此对于 YouTube 关联，你不再需要额外调用 /api/user 来确认事件对应的是哪个频道：account.id 是频道 id，account.title 是频道名称（不同于顶层的 title，后者仍然是你的用户资料标题），此外还有 account.handle 和 account.profileUrl。每个键都是单独可选的（没有自定义 URL 的频道没有 handle），并且 account 会在 link 和 unlink 事件中发送。所有现有字段均保持不变。请参阅 Social action webhook 参考。
  • 8月12日 - AI 披露在图片格式转换中得以保留。 当 Ayrshare 将 WebP、HEIC、HEIF 或 AVIF 图片转换为 JPEG 以适配不接受源格式的平台时，图片的 AI 披露现在会被携带过去，而不是被丢弃。Ayrshare 会写入一个新的、精简的 XMP 数据包，其中包含 Iptc4xmpExt:DigitalSourceType——即 IPTC 的 AI 披露属性；当 C2PA 清单声明了 XMP 中未记录的 AI 来源时，Ayrshare 会合成等价的值。仅凭该属性，Facebook 和 Instagram 就会渲染各自的 AI 标签，无需设置任何平台侧 AI 标记。除此之外没有其他内容会随之传递：该数据包是从零构建的，而非复制得来的，因此你原始图片中的 EXIF、GPS，以及创作者、版权、关键词或位置字段都不会到达平台。无论哪种情况，色彩渲染都会被保留——HEIC 或 HEIF 图片会保留其 ICC 色彩配置文件，而 WebP 或 AVIF 图片会被转换为标准 sRGB，这样即使在会丢弃内嵌配置文件的平台上，色彩也依然正确。C2PA 密码学签名无法在重新编码后保留，也不会被保留——保留的是披露，而不是签名。JPEG 与 PNG 图片仍会原样透传，视频不受影响，媒体上传也会继续原样存储你的字节。请注意，Instagram 的 autoResize 选项会通过一个不携带任何元数据的独立步骤进行缩放，因此如果需要让披露到达 Instagram，请关闭该选项。完整策略与各平台的实际结果请参见 图片元数据与 Content Credentials。
  • 8月12日 - LinkedIn Company Page 选择不再超时。 如果你管理着非常大量的 LinkedIn 公司主页，连接 LinkedIn 时可能会在主页选择列表出现之前就超时，导致没有任何可选项 —— 即便在下面 8月10日的发现改进之后也是如此。构建你的主页列表现在快了许多倍，可以远远在请求限制内完成。此外，之前根据 LinkedIn 返回主页的方式，某些主页可能会被漏掉；这些主页现在都会出现在列表中。
  • 8月11日 - 通过自定义 CSS 控制连接账户卡片布局。 白标连接账户页面现在又多了两个可供你的 Max Pack 自定义 CSS 选择的 class 名：网络卡片所在网格上的 social-accounts-grid，以及每张卡片所在单元格上的 social-account-card-wrapper。它们共同控制卡片之间的间距以及每行放置多少张卡片，而在此之前这两点都没有可用的选择器。如果你的样式表是通过从 main-content 向下逐层数元素来定位卡片区域的（例如 .main-content > div > div > div），那些规则自 dashboard 重构后会匹配到不同的元素，并可能一次性调整所有卡片的大小；请改为针对上面两个 class 名来重写它们。你的规则仍然需要使用 !important 才能覆盖页面生成的样式。可参见 Change the Card Layout 中的完整示例。
  • 8月11日 - 使用自定义 CSS 的关联页面保持浅色。 配置了你自己的 CSS 文件的社交关联页面现在会固定为浅色配色方案，并且不再向你的用户显示浅色/深色切换开关。样式表是针对浅色页面编写的，因此当用户切换到深色时，会保留你的颜色，而其周围的文本颜色发生变化，可能导致卡片上的网络名称难以辨认。现在，仅由你的样式表决定页面的外观。没有 CSS 文件的关联页面保持不变，仍会保留切换开关。
  • 8月11日 - 简化的 Instagram 连接流程。 之前在连接页面上点击 Instagram 时，会先弹出一个对话框，提示仅支持 Instagram Business 或 Instagram Creator 账户，之后才开始登录。现在，Instagram 自己的登录流程会在授权过程中提示将个人账户切换为专业账户，因此这个多余的步骤已被移除。点击 Instagram 会直接进入登录流程：如果你启用了 Instagram 自己的登录，就走 Instagram 登录；如果你已禁用 Instagram Login，则走 Facebook 登录。如果你为连接页面配置了自定义 Instagram 弹窗，你的自定义说明仍会与之前完全一致地显示。
  • 8月10日 - 连接账户页面上的自定义 CSS class 钩子已恢复。 白标连接账户页面现在再次带有你的 Max Pack 自定义 CSS 所选中的稳定 class 名。在页面重构时这些 class 名被去掉了，因此已有的样式表虽然仍会被加载，但会悄无声息地匹配不到任何元素：一条用于隐藏页面标题、重设 Close 按钮样式或调整说明文字颜色的规则就这么失效了，且不会在任何地方报错。已在页面上恢复：main-content、company-logo、heading-social-accounts、additional-info、additional-info__body、additional-info-text、troubleshooting-guide 和 close-button。已在每张网络卡片上恢复：connected-card 和 click-to-link。新增：每张卡片上的 social-account-card、表示尚未连接状态的 unlinked-card，以及承载网络 key 的 data-platform 属性，这样就可以把未连接的卡片重新设计成按钮的样式 —— 此前这是无法做到的，因为在 CSS 中已连接和未连接的卡片是无法区分的。你的规则需要使用 !important 才能覆盖页面生成的样式。完整清单和一个完整示例请参见 CSS Class Hooks。
    • 请检查你的样式表。 基于这些 class 名编写的规则无需你做任何改动即可再次生效。基于页面自身生成的 class 名编写的规则（任何你从浏览器开发者工具复制而来的名字，例如以 chakra- 开头的），无法被恢复，需要针对文档中记录的选择器重新编写。参见 Updating an Older Stylesheet。
    • 一个旧的 class 名不会再回来了。 linked-tag 有意地不再属于我们承诺保持稳定的这套 class 契约的一部分：一张已连接的卡片现在也可能显示 “Relink required” 或 “Identity check”，因此把它隐藏起来的规则会让你的用户看不到需要采取行动的警告。请改为对 connected-card 设置样式。参见 Updating an Older Stylesheet。
  • 8月10日 - 改进的 LinkedIn Company Page 发现。 如果你管理着大量 LinkedIn 公司主页，在连接或刷新 LinkedIn 时，其中一些主页可能会缺失 —— 这些主页无法被选中，也无法发布内容。公司主页发现现在会读取超过之前提前停止的那个位置，因此因这个原因遗漏的主页现在可以被选择并发布到。
  • 8月7日 - Dashboard 3.0。 Ayrshare Dashboard 已完全重构，采用现代化的设计系统、焕然一新的导航，以及在每个页面上都更快、更简洁的工作流程。
    • 深色模式与全新设计 —— 默认启用深色模式，并在侧边栏提供一键切换的浅色/深色主题开关；每个页面都采用了全新的排版、卡片和布局，以提升可读性与信息密度。
    • Billing，现已进驻 dashboard —— 新增的 Billing 板块（取代旧的 Account 页面）让你无需离开 dashboard 即可管理订阅：查看当前套餐、下一次账单日期和付款方式；变更套餐、查看发票并更新账单信息；并可直接启用或管理附加功能（Max Pack、Messaging 和 Facebook Boost Ads）。
    • Publish a Post —— 网络切换器带有实时选中计数、Select all / Deselect all，以及可将帖子仅发布到单个网络的 “Only” 快捷方式；View API Code（原 View JSON）会展示所撰写帖子对应的确切 API 请求；更清爽的 Additional Options 面板则会根据上下文呈现各平台特有的设置（例如 Instagram Post Type）。
    • Post History —— 除已有的状态筛选（Success、Scheduled、Paused、Awaiting Approval、Error）外，还可搜索最近的帖子；每条帖子都带有媒体缩略图，并在每张卡片上显示平台图标、状态标签、可复制的 Post IDs，以及可折叠的 API Request & Response 查看器。
    • User Profiles —— 重新设计的个人资料卡片，配有头像和结构化字段（Created、RefId、Accounts、Messaging）、新的角色徽章（Owner、Team Member 和 Active profile），以及每张卡片上的内联 Messaging 开关。
    • Webhooks —— 新增 Events tab，可与已注册的 webhooks 并排查看 webhook 事件日志。
  • 8月6日 - TikTok 视频可见性修复。 tikTokOptions.visibility 选项现已对视频帖子生效。此前该选项仅对图片帖子起作用 —— 使用 visibility: “private”、“followers” 或 “friends” 发送的视频会被发布为 Public，且不会返回任何错误或警告。视频现在会按请求的可见性发布，visibility 参数文档也已更新，以反映对视频的支持。
  • 8月6日 - Instagram AI 内容标签。 Instagram 帖子现在可以通过在 instagramOptions 中将 isAIGenerated 设为 true，携带 Instagram 的 AI info 标签。该自我披露适用于单张图片、单个视频、Reels、Stories 与轮播 —— 对于轮播，标签会应用于整个轮播而不是单个项目。可接受的取值为 true、“true”、false 和 “false”；其他任何取值（例如 “yes” 或 1）仍会照常发布帖子但不带标签，同时返回一个非致命的 warnings 条目（code: 497、feature: “isAIGenerated”），列出可接受的取值。省略该参数的行为保持不变，会以无标签的方式发布；帖子发布后，标签无法再更改。该参数与已有的 tikTokOptions.isAIGenerated 一致，同一标志名在两个平台上都适用。参见 Instagram AI Content Label。
  • 8月4日 - X “Made with AI” 标签。 X 帖子现在可以通过 twitterOptions.isAIGenerated 披露 AI 生成的媒体，该字段会应用 X 原生的 “Made with AI” 标签。参见 X posting options。
  • 8 月 4 日 - 针对企业主页自然帖子的 LinkedIn 评论回复。 使用社交评论 ID 回复 LinkedIn 评论现已支持企业主页的自然帖子，此前该操作会以 code: 215 失败。在此模式下（searchPlatformId: true），请传入 get-comments 返回的完整 commentUrn，而不是仅使用 commentId —— 例如 urn:li:comment:(urn:li:activity:<postId>,<commentId>)。参见 Reply to a Comment 上新增的 commentUrn 参数。
  • 8月4日 - 自动化私信失败不再归咎于你的访问令牌。 当一条 Instagram 自动化无法把私信投递给某个特定收件人时，活动行会记录 auth_error——即表示账户凭据失效的状态——于是客户重新关联了一个完全健康的账户，而重新关联并没有改变任何东西。针对单个收件人的投递失败现在会记录为 failed，并在 actionResults[].errorDetails 上携带 Meta 自己给出的原因，auth_error 则保留给真正的凭据与权限问题。最常见的原因现在也有了自己的终态：当触发它的评论来自本会发送该私信的同一账户——也就是你在自己的帖子上测试自动化时会发生的情况——该行会被记录为 skipped，附上解释，且不会尝试发送，因为账户无法给自己发消息。活动状态和活动接口参考文档现在会准确地描述每种状态。此次变更之前记录的行不会被追溯更正，因此历史上一条 auth_error 行仍可能属于这些情况之一。

​
2026 年 7 月

  • 7 月 31 日 - WhatsApp Messages 进入 Private Beta。 Messaging API 现已支持 WhatsApp（Private Beta）。通过审核的账号可以借助 Meta 的 embedded signup 流程绑定 WhatsApp Business Account，在 Meta 的 24 小时客服窗口内发送自由文本消息、接收入站消息与媒体，并检索已存储的 WhatsApp 会话。请发送邮件至 lotty@ayrshare.com 申请访问权限。
  • 7 月 31 日 - Instagram Comments 与 Mentions Webhooks 不再依赖 Messaging。 Instagram 的评论及提及 webhooks 现已完全独立于 Messaging 附加组件。使用 action: “comments” 或 action: “mentions” 注册 webhook 时，会基于你已关联的账号自动订阅所需的 Meta 字段——既不需要 Messaging 附加组件，也不需要重新关联账号（评论相关权限已包含于默认授权之中）。此机制适用于每一种 Instagram 账号类型，包括通过 Facebook Page 关联的账号；此外，停用 Messaging 也不再会中断一个正在运行的评论或提及 webhook。此变更仅适用于 Instagram 范围；Facebook 的评论与提及事件尚未包含在内。请参见 Webhooks 概览以注册 webhook。
  • 7 月 31 日 - 批量分析归属问题修复。 在包含多条帖子的帖子分析请求中，某个失败的条目可能会使同一批次内后续的结果被记录到错误的帖子 ID 下。现在，即便批次中的部分条目失败，结果也会始终被正确归属到对应的帖子。
  • 7 月 31 日 - Instagram 分析的帖子 ID 校验。 发送至帖子分析的无效 Instagram 帖子 ID 现在会在本地即被拒绝，然后才会对 Meta 发起任何调用，因此格式错误的 ID 不再会消耗一次 Meta Graph API 调用——与已为 Facebook、Threads 和 X/Twitter 就绪的保护机制保持一致。纯数字的帖子 ID 也会得到妥善处理：完全由数字组成的 id 会正常通过校验，而无法构成有效 ID 的取值会返回一个规范的 code: 186 错误，而不是一次未处理的失败。合法的字符串 ID 的行为则与之前完全相同。
  • 7 月 31 日 - n8n 起始工作流更新。 可下载的 n8n MCP 起始工作流已更新：建议使用的首个提示词现在仅针对 LinkedIn 和 Facebook（此前的提示词包含 Instagram，而 Instagram 需要媒体文件，会导致首次运行时的校验失败）；同时，工作流的聊天模型现已改为 claude-sonnet-5，配套的设置说明也已改为不依赖具体版本。
  • 7 月 29 日 - Instagram 评论自动化现使用私信回复。 评论触发的自动化（comment_keyword）现在通过 Instagram 私信回复（private replies） 投递其私信，锚定于该评论自身的 7 天窗口。这消除了此前必须存在会话的要求，因此自动化现在可以触达从未与你私信过的评论者——之前正是这一点会阻挡冷评论者。评论自身的 7 天窗口仍然适用：对超过该时长的评论进行回复会失败并返回 491。请注意，投递最终仍由收件人的 Instagram Message requests 设置决定：一条私信可能被 Instagram 接受（活动 status: “sent”）后随即被静默丢弃，且任何 API 层面都不会有信号。相应地，sent 表示 Instagram 接受了该消息，绝不意味着收件人收到了它。新的失败原因会出现在 actionResults[].errorDetails，并有专门的错误码 490–495。请参见新的自动化私信已发送但未送达故障排查指南。
  • 7 月 23 日 - 后量子就绪加密（PQC）。 Ayrshare API 现已在 TLS 层支持后量子密码学。我们已在全球 SSL 策略上启用 X25519MLKEM768 混合密钥交换，在 TLS 1.3 握手中于经典 ECDHE 之外增添了一种量子安全（ML-KEM）算法。此举可保护您的 API 流量抵御”先行收割、后期解密”攻击——即攻击者当下记录加密流量，待量子计算机成熟之后再行解密。该变更完全向后兼容：由于采用混合协商机制，连接仅在客户端主动请求时方才升级至 PQC，其余所有客户端将继续通过标准 ECDHE 正常连接。此外，鉴于我们 74% 的 API 流量已运行于 TLS 1.3 之上，大多数集成即刻便可获得后量子保护，无需任何代码变更——只要您的 HTTP/TLS 库支持 X25519MLKEM768 组（OpenSSL 3.5+ 及其他现代 TLS 栈均已支持），即会自动完成协商。
  • 7 月 15 日 - Instagram Reels 宽高比校验修复。 竖长比例的 Instagram Reels 不再在到达 Meta 之前被错误拒绝。Ayrshare 的上传前视频检查曾将 Instagram 图片的宽高比规则（4:5 到 1.91:1，另加一个 9:16 竖屏例外）套用到 Reels，导致合法的竖版 Reel（例如 886 x 1920，即 0.46:1 的宽高比）在本地就被拦截并返回 code: 182，尽管 Instagram 本身会接受该视频。Reel 视频现在按文档中记录的 Reel 范围 0.01:1 到 10:1 进行校验（仍建议使用 9:16 以避免裁剪），与 Meta 官方规范以及 Instagram 媒体指南保持一致。宽高比校验失败时的 code: 182 提示信息也已更正——此前显示为 “Video does not meet duration requirement.”（视频不满足时长要求。）无需任何 API 变更。
  • 7 月 14 日 - 多平台评论与分析读取支持部分成功。 多平台 get-comments 或 post analytics 读取（一个跨越多个平台的 Ayrshare Post ID）不再在某个平台分支失败时，把整个响应折叠成错误。当至少有一个分支成功、至少有一个分支失败时，响应会返回 HTTP 200 并附带 status: “partial”，保留健康平台的数据，并在顶层 errors[] 中列出每个失败的分支。全部成功的响应保持不变。全部失败的响应仍保持 status: “error”，并将代表性的顶层错误码映射到其配置的 HTTP 状态；错误码 485 映射到 HTTP 404。错误码 485 用于标识过期或不可用的 Instagram/Facebook Story 评论以及 Instagram Story 分析——当评论或洞察数据无法被获取时。Facebook Story 分析仍不可用，且不包含在其中。客户端应当检查 errors[] 并匹配数字型的 code，而不是精确的消息文本。
  • 7 月 8 日 - 更快的 API 响应时间。 我们上线了一轮后端性能优化，显著降低了我们最热门的一些端点的延迟。平均响应时间和 95 百分位（p95）响应时间都大幅下降，尤其在高负载下增益最大。改进最明显的是 profiles 和 analytics。无需任何 API 变更；每个请求都会自动变得更快。
  • 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 日 - Webhook 签名密钥轮换。 你现在可以从 Webhooks 控制台 通过 2 次点击安全地轮换你的 webhook 签名密钥，也可以通过新的 POST /hook/webhook/secret 端点并附带 secret body 参数进行轮换。轮换之后，投递会通过新的 X-Authorization-Content-SHA256-V2 header（v1=<current-sig>,v1=<previous-sig>，当前签名在前）在 24 小时的宽限期内同时使用你的旧密钥和新密钥签名，因此你可以在不丢失或拒绝任何一次投递的情况下更新你的接收方。现有的 X-Authorization-Content-SHA256 header 保持不变。签名密钥是按 profile 统一的（每个 User Profile 只有一个，会对该 profile 上的每一个 action 进行签名）。安全的轮换流程和接收方验证示例请参见 轮换签名密钥。
  • 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 上限（Launch & Business 1,000 / Enterprise 5,000）以及基于游标分页的活动日志。Launch、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 账户（授予全部权限）的信息。此行为已被取代：2207085 现在会自动重试，并且不再设置 relink: true。参见错误码。
  • 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 查看更早的更新。