> ## 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/)，或訂閱[電子報](https://dashboard.mailerlite.com/forms/42719/54642298519029076/share)以取得最新更新。 ## 2026 年 7 月

7 月 8 日 - 更快的 API 回應時間。 我們發布了一輪後端效能改進，顯著降低了多個熱門端點的延遲。平均與 95 百分位（p95）回應時間都大幅下降，重載時提升最為明顯。最大幅度的改善出現在 profiles 與 analytics。無需修改 API 呼叫；每個請求現在都會自動變得更快。 | 端點 | 平均加速 | 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 body 參數，可為單次連結工作階段覆寫你帳號層級的 Instagram Login 設定。傳送 "instagram" 以啟動直接 Instagram Login（無需 Facebook 粉絲專頁），或傳送 "facebook" 讓使用者在社群連結頁面點擊 Instagram 按鈕時透過已連結的 Facebook 粉絲專頁完成連結。此覆寫僅對由回傳的 JWT URL 開啟的連結頁面生效——會在授權跳轉後仍然保留，但永遠不會變更你帳號層級的設定；不提供該參數則維持既有行為。無效值會回傳 400 並列出有效選項。詳情請見新的 Instagram Link Method 一節，包含兩種流程之間的功能差異。

## 2026 年 6 月

6 月 24 日 - n8n 整合。 透過 n8n 內建的 MCP Client Tool 節點連線至 Ayrshare MCP Server，無需自訂程式碼，也無需安裝社群節點。可查看新的 n8n 整合頁面取得概觀，或前往完整 n8n 指南了解設定、三個範例、多租戶 profile、X BYO，並下載入門工作流（Chat Trigger → AI Agent → Ayrshare MCP 節點）。另請參閱 Connect & Setup 與 Tool Catalog。
6 月 17 日 - Facebook Analytics：Meta 停用 Reach 與 3 秒影片指標。 Meta 已在所有 Graph API 版本中移除 unique-impression 與 3 秒影片觀看的 Insights 指標（於 2026 年 6 月 15 日生效）。Facebook post analytics 不再回傳 impressionsUnique、impressionsFanUnique、impressionsOrganicUnique、impressionsPaidUnique 或 videoViewsUnique，而 social analytics 不再回傳 pagePostsImpressions\* 系列（包含 pagePostsServedImpressionsOrganicUnique）。仍受支援的欄位（reactionsByType、videoViews、mediaView、pagePostEngagements、pageVideoViews）不受影響。reach 請改用 mediaView / pageMediaView；Total Unique Media Views 的後續替代指標已規劃中。參考：Meta Graph API v25 changelog。
6 月 15 日 - Facebook 帳號限制錯誤碼 476。 因 Meta 對帳號設下限制（Meta subcode 2424009 與 1404078，或錯誤未帶 subcode 時 Meta 的限制措辭）而失敗的 Facebook 貼文，現在會回傳專屬且不可重試的 code: 476（HTTP 400），而非通用且可重試的 code: 108。帳號仍保持連結——請透過 Meta 的 Account Status 頁面（Facebook → 個人檔案照片 → Help → Account Status）處理限制，該頁面會顯示具體原因與 API 無法回傳的申訴流程。詳情請見 Facebook 帳號限制。
6 月 10 日 - LinkedIn 個人檔案分析。 LinkedIn 個人（member）檔案現在會回傳擴充的分析矩陣。Post analytics 包含 impressionCount、uniqueImpressionsCount（觸及的成員數）、likeCount、commentCount、shareCount、engagement、reactions，以及對於影片貼文的 videoViews、videoViewers 與 videoWatchTimeMs。Social analytics 新增 lifetime followersCount、每日 followersDaily 成長與彙總的貼文指標。彙總的 reshare/reaction/comment 計數為盡力提供，可能與 LinkedIn UI 略有不同。既有已連結的帳號需在 Social Accounts 頁面重新連結其 LinkedIn 檔案以授與新的分析 scope——在完成前，分析會回傳 code: 475（「re-link your LinkedIn profile to enable analytics」）。發布不受影響。
6 月 10 日 - TikTok 第一則留言現在改為事件驅動。 TikTok 貼文的第一則留言不再透過固定的定時等待嘗試。由於 TikTok 是非同步處理影片，/post 回應中的 TikTok 第一則留言現在會以 status: "pending" 回傳，並在 TikTok 處理完成、且 tikTokPublished webhook 解析出實際 video 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 Analytics 於點數耗盡時改回傳 Code 416。 當 X/Twitter BYOK 帳號註冊的 X Developer 帳號沒有 API 點數時，analytics 與 user-lookup 路徑現在會回傳 code: 416（HTTP 402，X CreditsDepleted），並在 detail 中帶入註冊帳號 id——先前這些被遮蔽為 code: 294（HTTP 400，「Unable to get X User」）。修正方式是到 X Developer Portal 儲值點數。此變更讓 analytics/lookup 表面與發布路徑（原本已回傳 416）一致。若你的整合是以 analytics 的 294 判斷 handle 錯誤，請加上對 416 的處理。
6 月 4 日 - MCP Server 與 Claude Code 外掛。 AI 代理現在可以透過新的 MCP Server（[https://api.ayrshare.com/mcp](https://api.ayrshare.com/mcp)）驅動 Ayrshare API，包含 Claude Code 外掛。請參閱 Connect & Setup 與 Tool Catalog。既有的 docs-search MCP 現在稱為 Documentation MCP。

## 2026 年 5 月

5 月 22 日 - Bulk Post Profile-Key 路由修正。 POST /post/bulk 現在會遵循 Profile-Key 標頭，因此 CSV 列會發布到解析後的 User Profile，而非 Primary Profile。先前帶 Profile-Key 的大量上傳會被靜默轉送到 Primary Profile 的社群帳號。詳情請見 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 現在支援搭配 videoId 使用 hide=true 對公開觀眾隱藏 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 標頭——這對 X/Twitter 操作是必需的，因為 Ayrshare 的 BYO 要求已強制執行（自 2026 年 3 月 31 日起）。透過 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 Analytics 不再因權限錯誤取消連結。 當 Instagram analytics 遇到缺少權限的錯誤（Meta errCode 10）時，帳號不會再自動取消連結。先前 scope/權限問題被當成 token 被撤銷處理，即使發布仍可正常運作也會靜默解除帳號連結。Ayrshare 現在會保留帳號連結，改為呈現權限 scope 錯誤。
5 月 19 日 - 每個 profile 的 hideLogo。 [Create Profile](/apis/profiles/create-profile) 與 [Update Profile](/apis/profiles/update-profile) 新增 hideLogo 布林值，用於在個別 User Profile 的社群連結頁面上抑制帳號層級的 logo。適用於為個別合作夥伴 profile 做 white-label。
5 月 19 日 - Facebook Boost Ad Set 預算共享。 [Boost 端點](/apis/ads/facebook/boost-post) 現在接受新的可選 adSetBudgetSharingEnabled 布林值（預設 false）。Meta 現在要求所有未使用 campaign-level 預算建立的 campaign 都必須在有線欄位中提供此值，Ayrshare 會在每個請求中送出——預設 false 可保留先前行為，呼叫端不需修改。將其設為 true 可啟用 Meta 的跨 ad set 最佳化，可將某個 ad set 的預算最多轉移約 20% 到同一 campaign 中的其他 ad set，以獲得更好的整體效能。
5 月 19 日 - Reddit 被禁 subreddit 錯誤。 發文至你被禁止發文的 subreddit 現在會回傳明確的不可重試錯誤，而非一般可重試的 code 121。這可避免排程器對永久被拒絕的貼文陷入重試迴圈。詳情請見 Ayrshare 錯誤碼。
5 月 19 日 - Bluesky 影片大小限制。 Bluesky 影片上傳大小上限現為 100 MB（先前宣稱 1 GB），以符合 Bluesky 的平台上限。超過 100 MB 的檔案現在會在前端就被拒絕，而不會在上傳後期才失敗。請參閱 Bluesky 媒體規範。
5 月 19 日 - 儀表板 X/Twitter Messaging 支援 BYO Keys。 Ayrshare 儀表板 Messaging 頁面現在支援 Bring-Your-Own-Keys（BYO）帳號的 X/Twitter 私訊。你的 X consumer key 與 secret 會在瀏覽器內於工作階段中收集，並隨 send、refresh 與 image-fetch 動作一起傳遞——不會儲存任何金鑰。由於 Ayrshare 上的 X/Twitter 現已為 BYO 專屬，因此為必需項目。
5 月 19 日 - Facebook Ads Cities 定位修正。 Facebook Ads Cities 端點（GET /ads/facebook/cities）現在能正確解析城市及其相關地區資料。每筆結果會包含 region、regionId 與 supportsRegion，可在城市有對應地區時用於定位。可使用 search 查詢參數以部分或完整城市名稱查詢。
5 月 18 日 - YouTube Status 欄位控制。 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 不支援貼文留言，因此現在 GMB 會略過 firstComment，並正常回傳成功的貼文結果。
5 月 14 日 - 防止帳號取消連結。 社群網路正悄悄推出更嚴格的反機器人控制，導致異常多的使用者帳號被取消連結。我們推出了多項後端改進以減少取消連結並釐清錯誤訊息，並更新帳號連結頁面讓 UI 更清楚——包含 Meta 網路（Facebook、Instagram、FB Groups、Threads、Messenger）在遭遇身份驗證懸置時新增的「Action required」狀態，附帶「Resolve with Meta」連結與「Check again」偵測，讓使用者無需取消連結再重新連結就能解決問題。
5 月 12 日 - Instagram 互動自動化（Beta）。 新的Automations API讓你的使用者可對 Instagram 互動自動反應——當終端使用者對貼文留言、回覆限時動態、傳送私訊或對私訊做出反應時，觸發 DM、webhook 或 email。四種觸發類型（comment\_keyword、story\_reply、dm\_reaction、dm\_keyword）與三種動作類型（send\_dm、fire\_webhook、send\_email）——每條規則各類最多 50 個。包含每個動作 7 天去重（可透過 dedupWindowMinutes 逐個動作設定）、每日 DM 上限（Business 1,000／Enterprise 5,000），以及游標分頁的活動日誌。適用於 Business 與 Enterprise 方案。新錯誤碼 462–472 涵蓋驗證、方案分級、活躍自動化上限、缺少已連結帳號，以及功能旗標的加入。Beta——我們正在積極收集回饋；請將錯誤回報與功能需求傳送至支援。
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 匯入逾時）與 454（HTTP 503，服務不可用），並帶有 retryAvailable: true 旗標，你的整合可用於自動重試。詳情請見[錯誤碼](/errors/errors-ayrshare)。
5 月 11 日 - X/Twitter Analytics 與 Lookups 對所有 BYO 使用者開放。 舊版的 X 加購方案限制已從 /analytics/social 與 /lookups/x 中移除。任何 X/Twitter Bring-Your-Own-Keys 客戶現在都可以查詢任意 handle 的分析並使用 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 標頭——這對 X/Twitter 操作是必需的，因為 Ayrshare 的 BYO 要求已強制執行（自 2026 年 3 月 31 日起）。透過 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 欄位中隨 Ayrshare 錯誤碼一起呈現 Meta 底層的錯誤文字，讓呼叫端能區分原因（例如 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 標頭——不再需要退出 Explorer 改用 curl 或 Postman 才能測試 BYOK。值透過 sessionStorage 只保留於目前瀏覽器分頁，預設會被遮蔽並可切換顯示，也可一鍵清除。取得憑證的方式請見 X BYO Key 設定指南。
4 月 28 日 - Social Analytics 增強（陸續推出）。 Social Analytics 端點將加入 Instagram shareCount（90 天滾動視窗中的總分享數）與 YouTube lifetimeLikes（透過 youtube: \{ lifetime: true } 開啟）；新欄位會在部署到達你的帳號時出現在回應中。本次更新包含文件更正：Instagram viewsCount 是 90 天滾動視窗（非 180 天），mediaCount 一律為 lifetime，YouTube likes 的範圍是依 quarters，而 TikTok profile 層級指標上限為 60 天，使用 quarters 時每個貼文則帶有 lifetime 語意。
4 月 28 日 - Instagram Trial Reels。 /post 端點現在支援發布 Instagram Trial Reels——首次發布時僅對非追蹤者可見的 Reels。將 instagramOptions.trialParams.graduationStrategy 設為 "MANUAL"（從 Instagram app 內畢業）或 "SS\_PERFORMANCE"（Meta 依早期表現自動畢業）。三個新的驗證錯誤碼——447、448、449——會在 Ayrshare 邊界拒絕無效的 trial-reel 請求。
4 月 24 日 - Instagram 發布可靠性。 擴充了尖峰時段的 Instagram 自動重試處理，並全面改善錯誤訊息。你現在不會收到一般錯誤，而是針對速率限制（code: 435）與媒體處理逾時（code: 436）收到具體的錯誤碼——讓你在整合中更容易診斷問題並建立更聰明的重試邏輯。
4 月 23 日 - Facebook Analytics 速率限制錯誤碼 444。 Facebook 粉絲專頁 per-Page 的分析節流（Meta error 80001）現在會在 post 與 social analytics 回應中回傳 code: 444（HTTP 429）。先前這些節流被誤分類為 code: 161（「relink your account」）。若你的整合是以 161 觸發重新連結流程，請更新為辨識 444 並以退避重試。詳情請見 Facebook Analytics 速率限制。
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 媒體爬蟲被封鎖。
4 月 21 日 - 內容審核輸入錯誤現在回傳 400。 POST /validate/moderation 現在對呼叫端輸入問題（例如以不支援的檔案作為 imageUrl，或網址無法存取／格式錯誤）回傳新的 code 438（HTTP 400），而非誤導的 500 與重試指引。真正的處理失敗仍會回傳 code 331（HTTP 500）。詳情請見[錯誤碼](/errors/errors-ayrshare)。
4 月 20 日 - 內文優化錯誤碼 441。 Post 端點在諸如 shortenLinks 的內文優化失敗時現在會回傳 code: 441（HTTP 502）。當失敗僅影響部分平台時，成功的平台仍會發布並出現在 postIds 中，同時最上層 status: "error" 且 errors\[] 會包含各平台條目。詳情請見內文優化錯誤。
4 月 15 日 - Instagram 失效 token 偵測。 因無效／過期 OAuth token 或 page-role/權限錯誤（Meta subcode 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 Analytics 全時期資料與日期篩選。 social analytics 端點在未指定 daily 或 quarters 時，現在會回傳 Instagram 與 TikTok 的全時期資料。使用 quarters（1–4，其中 1 = 90 天）或 daily=true 按日期範圍篩選——現在也支援 TikTok。啟用時，TikTok 的留言、分享與觀看的期間標籤與總數會反映篩選後的日期範圍。
4 月 9 日 - Analytics 可靠性與復原。 Social Analytics 與 Post Analytics 端點現在會在社群網路暫時回傳 0 時，自動從儲存的資料回補累計指標（followers、likes、views）。兩個新的可選回應欄位 backfilledFrom 與 recoveredFrom 會指出何時使用了儲存資料。此外，當沒有任何平台回傳資料時，請求分析現在會回傳 400 錯誤（code: 187），而非空的成功回應。
4 月 1 日 - generateJWT 標頭式 X 憑證。 Generate JWT 端點現在接受 X-Twitter-OAuth1-Api-Key 與 X-Twitter-OAuth1-Api-Secret 標頭來傳遞你的 X consumer key——與其他所有 X/Twitter 端點一致。為了向後相容，仍支援 body 參數。

## 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 修正。 修正 Instagram Social Analytics 在設定 daily=true 時遺漏每日 reach 資料的問題。回應現在在 daily 模式下會回傳巢狀的 reach 物件（包含 period 與 values 時間序列）；純量 reachCount 在非 daily 模式下仍會回傳，並在 daily 資料暫時不可用時作為後備保留。
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 app 權限未設為 Read/Write/DM）。訊息與解決方式請見錯誤碼。
3 月 23 日 - X 上的關鍵字搜尋。 BYOK 客戶適用的新關鍵字搜尋端點。在 X/Twitter 上搜尋符合關鍵字、hashtag 與進階搜尋運算子的推文。支援分頁、依語言與地點篩選，並回傳標準化的推文資料。
3 月 23 日 - 監聽區段。 新增Listening 區段，擴充自 Brand 端點並加入關鍵字搜尋等新功能。
3 月 19 日 - 留言中的 @Mentions。 在 [Post a Comment](/apis/comments/post-comment) 與 [Reply to a Comment](/apis/comments/reply-to-comment) 端點的 comment 文字字串中新增 @mention 支援文件。包含 LinkedIn 伺服器端解析細節與各平台 mention 語法的連結。
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 long video（1 GB → 16 GB），並為 Facebook（Reels 2 GB、Stories 4 GB、Feed 10 GB）與 Pinterest（2 GB）新增更大且依內容類型區分的上限。完整資訊請見 [Media Guidelines](/media-guidelines/overview)。
X/Twitter Messages 支援 BYO Key。 [Get Messages](/apis/messages/get-messages) 與 [Send Message](/apis/messages/send-message) 端點現在支援 BYO（Bring Your Own）X/Twitter API 憑證。透過 webhook 的即時 DM 通知對 BYO 使用者不可用；請改用 GET Messages 端點輪詢。
X 上的 Bring Your Own Keys。 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 的影片現在支援設定 videoTitle 與 videoDescription（於 X Post API 的 twitterOptions 物件送出），適用於上傳至 X Media Studio 的媒體。此支援搭配現有的 thumbNail，提供更豐富的影片中繼資料。
批次 Analytics。 新增社群貼文 ID 的批次分析支援，可透過新的 postIds 參數在一次 analytics 呼叫中處理最多 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 留言修正。 修正 [Get Comments](/apis/comments/get-comments) 端點無法正確回傳有巢狀回覆的最上層 Instagram 留言的問題。
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) payload 中現在會包含新的 ayrshareUrl 欄位，提供未經驗證的網址供方便使用。
狀態頁面 Slack 整合。 你可以自動將我們[狀態頁面](https://status.ayrshare.com)的更新連結到 Slack。只需點擊右上方的「Get Updates」並選擇 Slack 選項。

## 2026 年 1 月

1 月 21 日 - Link Analytics 自訂網域修正。 [Link Analytics](/apis/links/link-analytics) 端點（GET /links/:id）現在會使用你設定的自訂網域回傳短連結，而非預設的 Ayrshare 網域。若你使用自訂短連結網域（Business/Enterprise），analytics 網址現在會與你的實際連結一致。
1 月 15 日 - Instagram 外送訊息刪除同步。 當 Instagram 外送（已傳送）訊息在原生 Instagram app 中被刪除時，現在會正確標示為在 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) 現在支援包含縮圖預覽圖（以網址形式）。這會在上傳影片時作為中繼資料的一部分送出。
Instagram Hashtag 上限。 已將 [Instagram 貼文](/apis/post/social-networks/instagram) 的 hashtag 上限變更為 5，以符合 Instagram 發布的新規範。
Bluesky 影片時長。 Bluesky 影片媒體時長上限已調整為[三分鐘](/media-guidelines/bluesky#video)，以符合 Bluesky API 需求。

## 2025 年 12 月我們以透明與可靠性作為今年的收尾，並規劃了 2026 年第一季推出大量新功能。

12 月 23 日 - X/Twitter 回應中的 URL Entities。 X/Twitter 貼文與[歷史](/apis/history/history-platform) 回應現在包含推文本文中連結的 URL entity 資料：最上層 urls 陣列會帶入 X 的原始欄位（display\_url、expanded\_url），加上一個 camelCase 的 entities 物件，其中相同連結會以 entities.urls\[].displayUrl / expandedUrl 出現——讓你在整合中更容易呈現連結預覽與偵測外連。
X/Twitter Entities。 X/Twitter 的[貼文分析](/apis/analytics/post) 與[平台歷史](/apis/history/history-platform) 端點現在會從推文文字中回傳解析後的 entities，包含 URL、mention、hashtag 與 cashtag 及其位置與顯示網址。
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 團隊全天候監控平台以提升可靠性。
每月收據。 現在會自動將每月收據以 email 寄給主要帳號持有人，讓計費與付款更透明。

## 2025 年 11 月

Instagram Token 更新。 為使用直接 IG 登入（不透過 Facebook 粉絲專頁）連結 Instagram 的使用者新增了長效 Instagram token 的自動更新。
Facebook Analytics 更新。 [Facebook 貼文分析](/apis/analytics/post) 現在回傳強化的曝光指標，包含 post\_impressions\_paid\_unique、post\_impressions\_fan\_unique、post\_impressions\_organic\_unique 與 post\_impressions\_unique。
Facebook Page Insights。 新增 [Facebook social analytics](/apis/analytics/social) 欄位：pageFollows、pageMediaView、pageMediaViewIsFromAds 與 pageMediaViewIsFromFollowers，同時支援彙總與每日細分。
Instagram Analytics。 [Instagram social analytics](/apis/analytics/social) 的 viewsCount 與 reachCount 指標現在同時支援直接 Instagram Login 與 Facebook 連結的帳號。
LinkedIn Mentions。 修正了 [LinkedIn mentions](/apis/post/social-networks/linkedin#linkedin-mentions) 的處理，以正確區分 mention 組織與個人。
儀表板改進。 [Ayrshare 網頁儀表板](https://app.ayrshare.com) 的 API 頁面經過重構，效能改進並將 messaging 用量卡片組織得更好。
團隊擴編。 擴增開發團隊以加速支援與功能開發。

## 2025 年 10 月

Ayrshare 被 Saas.group 收購。 Ayrshare 已被 Saas.group 收購。團隊正在擴大，以提供更快的功能開發與更好的客戶支援。
Webhook 歷史。 新的端點可依動作[取得過去 6 個月的 webhook 歷史](/apis/webhooks/history)。
Facebook Ads 地點定位。 除了國家定位外，你現在可以在推廣 Facebook 貼文時[指定地區或城市](/apis/ads/facebook/boost-post#param-locations)。
LinkedIn 影片縮圖。 [LinkedIn history 端點](/apis/history/history-platform) 現在會為影片貼文回傳 thumbnailUrl，讓你更容易在應用程式中顯示影片預覽。
Reddit 貼文分析。 [Reddit 貼文分析](/apis/analytics/post) 的可靠性已改進，強化驗證處理以避免速率限制問題。
Instagram 歷史。 已改進 [Instagram 貼文歷史](/apis/history/history-platform) 對貼文數量眾多的帳號中大型結果集的處理。
Facebook Ads。 [Facebook ads 歷史端點](/apis/ads/facebook/get-ad-history) 現在包含依 campaign 結構回傳哪些廣告的說明。
Instagram 協作。 新增文件說明由於 Instagram API 的限制，[已接受的協作貼文](/apis/history/history-platform) 可能不會從平台 history 端點回傳。

## 2025 年 9 月