跳转到主要内容
以下 API 變更會於指定日期生效。 請仔細檢閱是否有潛在的破壞性變更。 所有新功能請見更新公告。
​
June 15, 2026
  • Facebook：Meta 已停用 unique-impression（reach）與 3 秒影片觀看的 Insights 指標。 Meta 已在所有 Graph API 版本中移除這些指標，因此受影響的欄位不再回傳。詳情請見 Meta Graph API v25 changelog。
    • GET analytics/post 不再回傳下列 Facebook 欄位：
      • impressionsUnique → 改用 mediaView
      • impressionsFanUnique → 改用 mediaView
      • impressionsOrganicUnique → 改用 mediaView
      • impressionsPaidUnique → 改用 mediaViewIsFromAds
      • videoViewsUnique → 使用 videoViews 取得非 unique 的 3 秒觀看數
      • totalVideoViews*Unique 與 totalVideoImpressions* 系列欄位（例如 totalVideoViewsOrganicUnique、totalVideoViewsPaidUnique、totalVideoViewsUnique）
    • GET analytics/social 不再回傳下列 Facebook 欄位：
      • pagePostsImpressions* 系列欄位（pagePostsImpressions、pagePostsImpressionsPaid、pagePostsImpressionsUnique、pagePostsImpressionsOrganicUnique、pagePostsImpressionsViral*、pagePostsImpressionsNonviral*）→ 改用 pageMediaView
      • pagePostsServedImpressionsOrganicUnique → 改用 pageMediaView
      • pageVideoViewsUnique → 使用 pageVideoViews 取得非 unique 的 3 秒觀看數
    • reach 請改用 mediaView / pageMediaView。已規劃的 Total Unique Media Views 後續替代指標即將推出。仍受支援的欄位如 reactionsByType、videoViews、mediaView、pagePostEngagements、pageVideoViews 與 pageVideoViewsPaid 不受影響。
​
May 11, 2026
  • YouTube 暫時性失敗現在回傳 HTTP 503/504 而非 500： 部分先前以 HTTP 500（code: 176）呈現的 YouTube 上傳失敗，現在改為回傳 HTTP 503（code: 454）或 HTTP 504（code: 453）。兩種回應皆包含 retryAvailable: true。若客戶整合是以 HTTP 500 過濾以重試 YouTube 上傳，應改為根據回應主體中的 retryAvailable 欄位過濾。詳情請見錯誤碼。
​
April 9, 2026
  • 空的 Analytics 回傳 Error 187： 當 Social Analytics 或 Post Analytics 請求沒有任何平台回傳資料時，現在會回傳 { "status": "error", "code": 187 }，而非 { "status": "success" }。請更新任何依賴先前「空的 success」行為的客戶端程式碼。
​
March 31, 2026
  • X/Twitter BYO Key 要求： 所有透過 Ayrshare 進行的 X/Twitter 操作都將需要你自己的 API 憑證。以 OAuth 連結 X 帳號後，於每次 X/Twitter 請求中包含 2 個標頭：X-Twitter-OAuth1-Api-Key 與 X-Twitter-OAuth1-Api-Secret。未提供有效憑證的請求會被拒絕。設定說明請見 X BYO Key 設定指南。
  • RSS-to-X 停用： 2026 年 3 月 31 日之後，RSS 自動發文至 X/Twitter 不再受支援。RSS feed 是按排程執行而不會逐次請求帶入憑證，這與 BYO key 模型不相容。RSS 自動發文至所有其他平台不受影響。
  • X 帳號活動 Webhook 停用： 2026 年 3 月 31 日之後，X 帳號活動 webhook 動作（accountActivity）將不再提供。這包含所有已連結 X 帳號的即時事件通知（貼文、提及、私訊、按讚、追蹤、封鎖等）。
​
November 14, 2025
  • 自 2025 年 11 月 14 日起，Facebook 將停用下列 GET analytics/social 欄位：
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → 改用 pageMediaView
    • pageImpressionsPaidUnique → 改用 pageMediaViewIsFromAds
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → 改用 pageMediaViewIsFromAds
  • 自 2025 年 11 月 14 日起，Facebook 將停用下列 GET analytics/post 欄位：
    • impressions 與 impressionsFanPaidUnique → 改用 mediaView。細部拆分可透過 mediaViewIsFromAds（廣告歸因的觀看）與 mediaViewIsFromFollowers（追蹤者歸因的觀看）取得。
    • postImpressionsUnique（Reels）→ 使用 blueReelsPlayCount 取得 reel 播放次數，或使用 postVideoViewTime 取得總觀看時長。
​
September 1, 2025
  • 自 2025 年 9 月 1 日起，Instagram 的 get comments 端點在回覆物件中將不再包含 text 欄位。請改用 comment 欄位 存取回覆內容。
​
June 1, 2025
  • X (Twitter) get comments 端點將把使用者的公開 指標移到新的 publicMetrics 物件。下列欄位將由最上層 移至 publicMetrics 物件：
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • Facebook 將停用下列 GET analytics/social 欄位：
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
May 7, 2025
  • YouTube 已停用設定允許與封鎖區域的功能。你仍可以在 post 端點 中加入允許與封鎖區域，但會被忽略。
​
April 20, 2025
  • 下列 Instagram 貼文分析 指標將停用：REELS：
    • playsCount
    • clipsReplaysCount
    • igReelsAggregatedAllPlaysCount
    FEED/STORY：
    • impressionsCount
  • 若 limit 大於預設值 25，history 端點 將強制套用 1 分鐘的快取。
​
March 1, 2025
TikTok 的 get comments 端點將標準化欄位名稱 以與其他社群網路一致。
  • 欄位 replyList 將重新命名為 replies，profileImage 將重新命名為 profileImageUrl。
  • 兩個新欄位名稱皆已可用，可在整合中使用。
  • TikTok 有下列更新：
    • social analytics 端點：即將有下列變更： • durationAverage 欄位將被停用並移除。• 由於 TikTok API 的限制，shareCountTotal、viewCountTotal 與 commentCountTotal 將只回傳過去 60 天的總計，而非全時期總計。• 若要即刻開始使用 60 天總計，請在 API 請求主體中加入 period60Days: true。註： 使用此參數將顯著改善回應時間。
    • history platform 與 post analytics 端點：未文件化的欄位 caption、comments、 shares、likes、shareUrl 與 itemsId 將被移除——請改用 post、 commentsCount、sharesCount、likesCount、postUrl 與 id。
​
February 1, 2025
/user 端點將改變 API 使用量的回報方式：
  • monthlyApiCalls 欄位將擴充為計算所有 API 呼叫（貼文、留言、 分析等）。
  • 如需針對貼文的計數，請使用新的 monthlyPostCount 欄位。
  • monthlyApiCallsQuota 欄位將停用，並由新的 monthlyPostQuota 欄位 取代。
​
January 5, 2025
  • Meta 將停用 Instagram 貼文分析 端點上的 videoViews 欄位。
  • 此外，emailContactsCount、getDirectionClicks、profileViewsCount、 textMessageClicks、websiteClicksCount 與 phoneCallClicksCount 欄位將自 Instagram social analytics 端點移除。
  • 這些欄位將於 2025 年 1 月 5 日移除。
​
December 15, 2024
  • 為加強安全性，我們將防止 Profile Key 被當作 API Key 使用。如果你 嘗試以 Profile Key 代替 API Key，系統會回傳錯誤。關於如何正確使用 Profile Key，請見 此處。
​
November 15, 2024
  • 我們已更新 TikTok 排程 webhook 錯誤的回報方式。這些錯誤現在 會出現在 errors 陣列中，與其他排程 webhook 類型的錯誤處理一致。 註：目前的最上層錯誤仍會回傳，但我們鼓勵使用 errors 陣列。
  • history 端點現在會預設將回應以物件形式回傳。objResponse 參數會自動設為 true。
  • Get All History LinkedIn 會將 mediaUrls 物件回傳為陣列。先前若只有一個媒體 項目會回傳物件，多個媒體項目才回傳陣列。現在即使只有單一媒體 項目也一律回傳陣列。若你需要先前的行為，可以使用 objResponse: false 查詢參數。
​
October 7, 2024
  • media 端點將不再回傳 url_1080。若確實需要縮放圖片，請 參閱 resize 端點。
​
September 16, 2024
​
June 3, 2024
  • 新的縮網址系統將取代 Google 已停用的 舊縮網址端點。新的縮網址服務需要加購 Max Pack。
  • 連結縮短預設為關閉（false）。若要自動縮短連結，請在 post 端點 呼叫中使用 shortenLinks: true，其會使用新的連結 端點。
​
April 22, 2024
  • Meta 將停用其 Facebook Groups API。請參閱 公告。
​
April 16, 2024
  • Instagram 已釐清 online followers 資料集的時間範圍。詳情請參閱 此處。
​
April 1, 2024
  • 依 comment ID 回覆留言 的預設回應會 是文件所列的物件，而非陣列。若你希望保留陣列回應，可將 objResponse 參數 設為布林值 false。
​
January 25, 2024
​
December 8, 2023
  • /history/instagram 端點的 caption、message、createdTime 與 timestamp 欄位已於 2023 年 4 月 1 日停用，即將移除。請改用 post 與 created 欄位。
  • /history/linkedin 端點的 mediaUrls 欄位將以陣列（而非物件）回傳， 以支援多張圖片。你現在可以在 LinkedIn 查詢參數中加入 ?multiMedia=true 強制回傳陣列。 請注意，在 2023 年 12 月 1 日之前，必須使用 multiMedia 查詢參數才能取得 多張圖片的媒體。2023 年 12 月 1 日之後，多張圖片將預設回傳。
  • Scheduled Action TikTok webhook 將停用字串型別的 platform。請改用 platforms 陣列欄位，與其他 Scheduled Action webhook 一致。
  • 刪除留言的文件已更正以符合正確回傳格式。
  • TikTok 的 commentId 欄位將由 id 欄位取代，以與標準的 留言刪除格式一致。
  • Twitter 的刪除留言回傳將不再包含 posts 陣列，使回傳 與標準的留言刪除格式一致。新的回傳格式如下：
​
October 18, 2023
​
May 30, 2023
  • 我們已升級至 Twitter 新的 API version 2。Twitter 在 Version 2 中已停用一些欄位，這會影響 /analytics/social 與 getAllHistory 端點。下列 欄位在 2023 年 9 月 1 日之前仍會回傳，但值會是 0 或空字串。
​
May 8, 2023
  • 我們很興奮地推出 TikTok 直接發布、留言 管理與進階分析。使用者不再需要開啟 TikTok 手機 App 就能發布並輸入內文。透過 Ayrshare 發送後，TikTok 影片與 內文將直接發布。
  • 我們也推出新增、取得與刪除 TikTok 留言 + 人口統計分析 資料。
  • 使用者需取消連結並重新連結其 TikTok 帳號以啟用直接發布。 現有連線會繼續使用間接方式，需要 TikTok 手機 App 才能發布。
​
February 17, 2023
  • Google Business Profile 已變更可用的 social analytics 資料。新的 可用欄位如下。舊欄位仍會存在但值為 0，並於 2023 年 3 月 17 日完全移除。
​
October 1, 2022
  • Get All Posts 的 descriptions、text、message 欄位標準化為 post 欄位。
​
September 12, 2022
  • TikTok 欄位停用：shareUrl。請改用 postUrl。
​
June 17, 2022
  • 所有 history 端點的 createdAt、createdTime 與 timestamp 欄位 將被 created 欄位取代，其會以 UTC 格式回傳建立時間。
  • scheduleDate 欄位將不再回傳物件，而以字串回傳 UTC 格式的 排程時間。
  • /history 上未文件化的 created_date 欄位將被移除。請改用 created。
​
April 22, 2022
  • Facebook 貼文的 Analytics 會以下列 格式將 reactions 回傳為物件。
​
April 1, 2022
  • History 預設會回傳最近 20 則貼文。最多可透過 lastRecords 參數 回傳 500 則。