跳转到主要内容
在 X 上追蹤我們、收聽 Social Media API Podcast，或訂閱電子報以取得最新更新。

​
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 完成頻道電話驗證（未驗證頻道是最主要原因），OAuth 重新連結為次要步驟。新的發布前驗證也會攔截非 PNG/JPG、超過 2MB 或無法存取的縮圖並跳過，影片仍會發布並在 warnings 中回報原因（縮圖問題永遠不會讓貼文失敗）。詳情請見 YouTube Post API 與新的 YouTube Thumbnail Not Applied (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）驅動 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 與 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</code>（Premium維持每月定額<code>0.09</code>（Premium 維持每月定額 <code>49 加購方案），每個計費週期最多可達 1,000 個活躍對話。詳情請見 Messaging 計價。
  • 5 月 20 日 - Instagram Analytics 不再因權限錯誤取消連結。 當 Instagram analytics 遇到缺少權限的錯誤（Meta errCode 10）時，帳號不會再自動取消連結。先前 scope/權限問題被當成 token 被撤銷處理，即使發布仍可正常運作也會靜默解除帳號連結。Ayrshare 現在會保留帳號連結，改為呈現權限 scope 錯誤。
  • 5 月 19 日 - 每個 profile 的 hideLogo。 Create Profile 與 Update Profile 新增 hideLogo 布林值，用於在個別 User Profile 的社群連結頁面上抑制帳號層級的 logo。適用於為個別合作夥伴 profile 做 white-label。
  • 5 月 19 日 - Facebook Boost Ad Set 預算共享。 Boost 端點 現在接受新的可選 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 旗標，你的整合可用於 自動重試。詳情請見錯誤碼。
  • 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 與錯誤碼。

​
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）。詳情請見錯誤碼。
  • 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」回應。詳情請見錯誤碼與 Instagram Post API。
  • 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 要求開始強制執行，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 與 Reply to a Comment 端點的 comment 文字字串中新增 @mention 支援文件。包含 LinkedIn 伺服器端解析細節與各平台 mention 語法的連結。
  • X/Twitter 分頁訊息。 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。
  • X/Twitter Messages 支援 BYO Key。 Get 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 方式讓你對帳號有更多控制、更好的資料可攜性以及全新的 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 的影片現在支援設定 videoTitle 與 videoDescription（於 X Post API 的 twitterOptions 物件送出），適用於上傳至 X Media Studio 的媒體。此支援搭配現有的 thumbNail，提供更豐富的影片中繼資料。
  • 批次 Analytics。 新增社群貼文 ID 的批次分析支援，可透過新的 postIds 參數在一次 analytics 呼叫中處理最多 100 則貼文。詳情請見我們的 Analytics on a Post by Social ID 端點。
  • 歷史分頁。 為 Threads 與 X/Twitter 的平台貼文歷史 API 加入分頁支援。不再有 500 則貼文的上限——你現在可以使用分頁抓取更長的歷史，並將呼叫拆成較小批次以獲得更快、更有效率的回應。
  • 免費試用增強。 免費試用使用者現在可以測試 Messaging API 與 Max Pack——在免費試用期結束前不會收費。
  • 更好的錯誤訊息。 為 X/Twitter 與 LinkedIn 錯誤訊息新增額外細節，讓你更容易診斷 API 呼叫的問題。
  • Instagram 留言修正。 修正 Get Comments 端點無法正確回傳有巢狀回覆的最上層 Instagram 留言的問題。
  • Python SDK。 已更新我們的 Python SDK，包含最新功能與改進。
  • X/Twitter Webhook URL。 Direct Message Event webhook payload 中現在會包含新的 ayrshareUrl 欄位，提供未經驗證的網址供方便使用。
  • 狀態頁面 Slack 整合。 你可以自動將我們狀態頁面的更新連結到 Slack。只需點擊右上方的「Get Updates」並選擇 Slack 選項。

​
2026 年 1 月

  • 1 月 21 日 - Link Analytics 自訂網域修正。 Link Analytics 端點（GET /links/:id）現在會使用你設定的自訂網域回傳短連結，而非預設的 Ayrshare 網域。若你使用自訂短連結網域（Business/Enterprise），analytics 網址現在會與你的實際連結一致。
  • 1 月 15 日 - Instagram 外送訊息刪除同步。 當 Instagram 外送（已傳送）訊息在原生 Instagram app 中被刪除時，現在會正確標示為在 Ayrshare 的 Messages 資料中已刪除——與內送訊息原有行為一致。對話歷史現在雙向都能保持準確。
  • MCP Server。 應廣大要求——我們重新推出了 MCP Server！將你的 AI 工具直接連上 Ayrshare API。
  • 自助註冊。 新增 Business Plan 與 Launch Plan 的自助註冊。新客戶現在可以取得 Launch Plan 的 14 天免費試用來測試 Ayrshare 平台。
  • X/Twitter 影片縮圖。 X/Twitter 影片貼文 現在支援包含縮圖預覽圖（以網址形式）。這會在上傳影片時作為中繼資料的一部分送出。
  • Instagram Hashtag 上限。 已將 Instagram 貼文 的 hashtag 上限變更為 5，以符合 Instagram 發布的新規範。
  • Bluesky 影片時長。 Bluesky 影片媒體時長上限已調整為三分鐘，以符合 Bluesky API 需求。

​
2025 年 12 月

我們以透明與可靠性作為今年的收尾，並規劃了 2026 年第一季推出大量新功能。
  • 12 月 23 日 - X/Twitter 回應中的 URL Entities。 X/Twitter 貼文與歷史 回應現在包含推文本文中連結的 URL entity 資料：最上層 urls 陣列會帶入 X 的原始欄位（display_url、expanded_url），加上一個 camelCase 的 entities 物件，其中相同連結會以 entities.urls[].displayUrl / expandedUrl 出現——讓你在整合中更容易呈現連結預覽與偵測外連。
  • X/Twitter Entities。 X/Twitter 的貼文分析 與平台歷史 端點現在會從推文文字中回傳解析後的 entities，包含 URL、mention、hashtag 與 cashtag 及其位置與顯示網址。
  • Facebook 貼文分析。 Facebook 貼文分析 新增 mediaView、mediaViewIsFromAds 與 mediaViewIsFromFollowers 等指標，以取代停用的曝光指標。
  • Bluesky 留言。 改進了對 Bluesky 留言取得 的支援，能正確處理 AT Protocol 風格的貼文與留言 ID。
  • Threads 連結。 強化了 Threads 帳號連結，可處理帳號上沒有 name 或 username 欄位的情況。
  • 24/7 監控。 引進專屬 DevOps 團隊全天候監控平台以提升可靠性。
  • 每月收據。 現在會自動將每月收據以 email 寄給主要帳號持有人，讓計費與付款更透明。

​
2025 年 11 月

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

​
2025 年 10 月

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

​
2025 年 9 月

  • TikTok 草稿。 將貼文送到 TikTok 草稿 現在同時支援圖片與影片。
  • Facebook Ads。 作為歐盟數位服務法（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 將在接下來幾週內預設啟用。若你需要包含 hashtag 搜尋、協作、地點標記或品牌資料等進階功能，必須手動停用此選項改用 Facebook 粉絲專頁驗證。我們建議大多數客戶使用新的直接 Instagram Login，因為工作流程更簡單且不需要 Facebook 粉絲專頁。
  • 推出 Snapchat。 Ayrshare 現在支援 Snapchat。Snapchat API 支援將內容直接發布至 Stories 與 Spotlight，並取得分析與歷史。Stories 是 24 小時後會消失的臨時貼文，而 Spotlight 貼文為永久性，可幫助創作者與企業觸及更廣泛的受眾。
  • MCP Server。 將 Ayrshare API Docs MCP server 連上你的 AI 代理。將 Ayrshare API 文件 MCP server 連上 Cursor 或 Claude Desktop 等 AI 開發工具，就能讓你的 AI 代理直接存取 Ayrshare 的文件。
  • 複製貼文。 將既有的貼文複製到另一個平台。新的端點讓你可以將成功的貼文重複用在不同平台或使用不同設定。
  • 開發者儀表板。 開發者儀表板 的發文流程有兩項新改進。除了上傳媒體檔案外，你現在也可以使用網址發布媒體。你還可以檢視用於發布貼文的 JSON，這有助於驗證你的 JSON 是否正確。
  • 使用者管理。 User 端點 現在會回傳所連結社群網路的即時狀態，並在使用者連結或斷開其社群媒體帳號時自動更新。
  • YouTube。 於 YouTube 發布影片現在允許透過設定 containsSyntheticMedia 參數揭露具真實感的 Altered 或 Synthetic（A/S）內容。查看文件。
  • Facebook。 取得 Facebook 留言 現在會回傳特定留言的直接網址。

​
2025 年 5 月

​
2025 年 4 月

​
2025 年 3 月

​
2025 年 2 月

​
2025 年 1 月

​
2024 年 12 月

  • 儀表板。網頁儀表板中的 User Profiles 頁面效能已優化。無論帳號中有多少 User Profile，你都能獲得順暢的滾動與載入體驗。
  • 儀表板。網頁儀表板的 Posts 頁面現在允許你將已刪除貼文納入歷史時間軸。這讓你能以與成功貼文相同的方式存取、篩選與搜尋已刪除貼文。
  • 已刪除貼文。若你或你的使用者已在社群網路上手動刪除貼文，你可以在 Ayrshare 中將其標示為手動刪除。這會避免 Ayrshare 未來嘗試刪除該貼文，並讓你取得更準確的貼文歷史。
  • Webhook。你現在可以在一次呼叫中取得所有 User Profile 已註冊的所有 webhook。
  • Analytics。Instagram 貼文分析 現在包含 share、followers gained、profile visits 與 profile activity 計數。
  • 留言。TikTok 留言 現在會回傳留言者的姓名。
  • 留言。X 留言 現在會回傳被留言回覆的 Tweet ID。

​
2024 年 11 月

​
2024 年 10 月

Ayrshare Dashboard API Calls

​
2024 年 9 月

  • Facebook Analytics。History Get All Posts 與Analytics 端點現在會回傳為 Facebook 貼文按讚的使用者。你可以取得每位使用者的姓名與 user ID。
  • 內容審核。新的 Moderation 端點會檢查內容是否有害或不當。此端點同時支援文字與圖片。
  • LinkedIn 連結。連結 LinkedIn 公司頁面先前需要使用者是該頁面的 Super Admin。現在管理 LinkedIn 公司頁面的 Content Admin 也能連結，可發文、取得分析與管理留言。
  • 使用者管理。User 端點 現在會為 Facebook 與 Instagram 同時回傳 Page ID 與 User ID。
  • 儀表板。網頁儀表板 Post 頁面現在會顯示圖示，指出貼文是否由 RSS feed 發布。
  • Facebook 評論。Facebook 評論 現在會回傳留下評論者的個人檔案照片。
  • Google 評論。Google Business Profile 評論 現在會回傳你所有的評論，即使有數千則。

​
2024 年 8 月

  • LinkedIn 歷史。現在你可以取得 LinkedIn 個人頁面的貼文歷史。先前只有 LinkedIn 公司頁面會回傳歷史。需要重新連結 LinkedIn 至 Ayrshare。
  • LinkedIn Analytics。LinkedIn 個人與公司頁面 有新的資料點可用，包含 likedBy 與 comment 細節。
  • LinkedIn 查詢。brand 端點 現在允許你查詢個人或公司。可用於查看誰對你的貼文按讚的細節。
  • Facebook 歷史。你可以將 Facebook 粉絲專頁歷史 的結果限制為只顯示由該專頁本身發布的貼文。這會過濾掉所有非由該專頁發布的內容。
  • User Profile。user 端點 現在會回傳一個新欄位，帶有該 User Profile 最後一次呼叫 API 的時間戳記。
  • X 長貼文。你可以將長貼文發布至 Premium X 帳號。長貼文最多可達 25,000 個字元。你現在也可以在呼叫分析或歷史時取得完整長貼文資料，包含長貼文主體中的完整內文與網址。
  • 網頁儀表板。已改進 post 頁面設計，並新增多種內容類型。你現在可以從儀表板直接發布 Facebook 與 Instagram Reels 或 Stories，或 YouTube Shorts。
Updated API Dashboard
  • 團隊管理。當你邀請團隊成員 時，你現在可以在儀表板 User Profiles 頁面中看到他們是否已接受邀請，或重新寄送邀請。
  • AI 影片標題。影片轉錄 現在包含建議標題。這對於需要為每部上傳影片提供標題的 YouTube 發布很有用。（需要 Max Pack）
  • 暫停貼文。你可以透過 post 端點暫停與恢復排程貼文。
  • 情緒分析。generate 端點 現在可以對貼文或留言產生情緒分析，判斷是負面、正面還是中性。結果也包含如何改善的建議。
  • Instagram Analytics。Instagram analytics 已強化以回傳關於已互動受眾的額外人口統計資料。
  • TikTok 照片。你現在可以以照片發布至 TikTok。先前僅接受影片。

​
2024 年 7 月

​
2024 年 6 月

  • Ayrshare Messaging API。Ayrshare Messaging Add-On 是一個可選付費加購方案，讓你的平台可為使用者管理私訊，包含 Facebook Messenger、Instagram Messaging 與 X/Twitter Messaging。
  • YouTube 留言。你現在可以透過 YouTube comment ID 刪除 YouTube 留言。
  • 自動 Hashtag。推出全新重建的自動 hashtag 系統，具備更相關的 hashtag 且無貼文長度限制。單一貼文可帶的 hashtag 數量也已提升為最多 10 個。
  • 網頁儀表板。儀表板 UI 已更新，能透過單一點擊移除 post 頁面上所有目標社群網路，且 API Key 頁面新增了程式範例區段。
  • User Profile 管理。Profiles 端點已強化 以允許你將結果篩選為擁有有效社群帳號或包含特定平台的 profile。

​
2024 年 5 月

  • Google Business。你現在可以更新你 Google Business Profile 地點資料，包含電話號碼、網站網址、地圖位置等。
  • 歷史搜尋。透過 History 端點，你現在可以跨所有 User Profile 搜尋貼文 ID。若你有一個 post ID 但不知道是哪個 User Profile 發布的，這會非常實用。
  • User Profile 標籤。為 User Profile 加上你自己的標籤，以更有條理地組織與管理 profile。網頁儀表板也允許你查看已指派的標籤並在 User Profiles 頁面搜尋標籤。
  • YouTube 字幕。使用 SRT 或 SVB 檔為 YouTube 影片加上自訂字幕。
  • NPM 套件。已發布更新後的 Node.js NPM 套件，包含新的端點與更詳細的文件。套件也已改名為 social-media-api。
  • Facebook 留言。你現在可以將圖片作為留言的一部分 在 Facebook 上發表。
  • LinkedIn 留言。LinkedIn 留言現在會回傳該特定留言的按讚數。
  • LinkedIn Brands。LinkedIn 資料的 Brands 端點 已強化，包含帳號的本地化名稱、公司專長與公司描述。
  • 停用留言。你可以停用貼文的留言，適用於 Instagram、LinkedIn 與 TikTok。這對新貼文或已發布的貼文都有效。
  • 歷史貼文。從 TikTok 取得歷史貼文資料，即使該貼文並非透過 Ayrshare 發布。
  • Instagram Analytics。Instagram Stories 新增可用的資料點，包含回覆、分享與退出次數。
  • AI Generate。以 AI 依一張或多張圖片產生社群媒體貼文 文字。也可以用來撰寫圖片說明。
  • 網頁儀表板。在儀表板列出的每個 User Profile 中，你都能看到已連結的社群網路。可將滑鼠移到每個社群網路圖示上以查看該社群網路上的名稱。
  • 社群連結。網頁儀表板與社群連結頁面上，現在會在頁面或公司名稱旁顯示個人檔案圖片。

​
2024 年 4 月

​
2024 年 3 月

​
2024 年 2 月

  • 評論。使用新的 /reviews 端點取得、回覆與刪除 Google Business Profile 與 Facebook 專頁上的評論。
  • LinkedIn 留言。依 comment ID 取得 LinkedIn 留言，可用於在 Ayrshare 外進行的留言。
  • LinkedIn Mentions。LinkedIn mentions 在留言與留言回覆中現在會解析為被 mention 的組織帳號。
  • 公開個人檔案資料。你現在可以在 brand 端點 中搜尋 Facebook 專頁與 LinkedIn 名稱。查詢使用者或公司的社群媒體公開資訊，例如粉絲、個人檔案圖片與網站。這些使用者與公司不必是已連結的 Ayrshare 使用者。
  • Facebook 留言。Facebook 留言 的留言端點 API 現在會直接在回應主體中回傳回覆。
  • Instagram 禁用 hashtag。使用新的 API 端點 或新的網頁工具 檢查被禁用的 hashtag。有助於避免你的帳號被停用或影子封鎖。
  • Facebook Groups。Facebook 已宣布將移除 Facebook Groups 的 API 存取權。了解更多。

​
2024 年 1 月

  • 更長的 Instagram 影片。Instagram 影片貼文 現在支援最長 15 分鐘與 1 GB。較先前的 60 秒與 100 MB 提升。
  • 翻譯貼文文字。可從超過 100 種不同語言中選擇翻譯你的貼文文字。例如將英文翻譯為法文或西班牙文翻譯為德文。來源語言會自動偵測。
  • 錯誤翻譯。錯誤訊息可以自動翻譯 為你選擇的語言。若你想直接以使用者偏好的語言顯示錯誤，這會非常實用。
  • Pinterest Analytics。Pinterest 額外資料點 現在可用於 get all history，包含貼文標題、備註與 board id。
  • Check Post Length。Check Post Length 端點 現在包含 Facebook、Google Business Profile、LinkedIn、Pinterest 與 YouTube 的驗證。
  • 新的 User Batch 端點。當你需要大量資料集時，batch 端點是個很好的選項。你可以使用 batch 端點取得所有 User Profile 的 json 檔案，並使用 webhook 在檔案準備就緒時通知你。
  • LinkedIn 歷史貼文。取得在 Ayrshare 外發布的 LinkedIn 貼文歷史資料。
  • LinkedIn 貼文 Reactions。Get All Post 端點 對 LinkedIn 現在會回傳貼文的 reactions，例如 Likes、Praise、Maybe 與 Appreciation。
  • 最後一次 API 呼叫時間。在網頁儀表板的 API Key 區段存取你最後一次使用 API 金鑰的時間。
  • Ayrshare 儀表板歷史。網頁儀表板現在允許你透過新的「Load more」按鈕載入所有歷史貼文或 webhook 日誌。
  • Webhook 錯誤。查看你 webhook 的錯誤率 以查看成功與錯誤回應的百分比。

​
較舊的更新

請前往更新封存 查看較舊的更新。