跳转到主要内容
POST
使用 Ayrshare Post ID,取得透過 Ayrshare 發送之貼文的即時分析,例如按讚、曝光、觀看與表情回應。 若要取得非透過 Ayrshare 發送的貼文分析,請參閱 依 Social Post ID 取得分析
Facebook:Meta 已於 2026 年 6 月 15 日淘汰部分觸及與影片指標。 Meta 移除了所有 Graph API 版本的 unique-impression 與 3 秒影片觀看的 Insights 指標,因此 Facebook 的 analytics 物件不再回傳 impressionsUniqueimpressionsFanUniqueimpressionsOrganicUniqueimpressionsPaidUniquevideoViewsUnique。請改用 mediaView 作為觸及指標(Total Unique Media Views 的後續替代方案已在規劃中)。其他常用欄位如 reactionsByTypevideoViews 不受影響。參考:即將發生的 API 變更 — 2026 年 6 月 15 日

其他資訊

  • 目前支援下列平台:Bluesky、Facebook Pages、Instagram、X/Twitter、LinkedIn、Pinterest、Reddit、Snapchat、Threads、TikTok 與 YouTube。
  • API 顯示的 Facebook 與 Instagram 留言數,可能與社群應用程式中顯示的數字不同,原因有二:- 部分使用者的隱私設定會對非朋友或沒有共同好友的使用者隱藏其留言,這些私人留言仍會計入留言總數。- Meta 回報的資料可能存在不一致。
  • API 顯示的 Instagram igReelsAggregatedAllPlaysCount 與 playsCount 可能與社群應用程式中顯示的數字不同,可能原因如下:
    • 該貼文被推廣過。API 回應僅包含自然(organic)播放次數。
    • Meta 回報的資料可能存在不一致。
  • X/Twitter Threads 會以物件陣列的形式回傳,每個物件對應 Thread 中的一則 Tweet。
  • 對於影片觀看次數或頻道訂閱數較少的 YouTube 影片,處理分析可能需要 24-48 小時。
  • TikTok 分析:
    • TikTok 可能需要 24-48 小時才會更新其分析資料,例如影片觀看次數、人口統計、按讚、分享與留言。
    • 若要存取 TikTok 分析,帳號擁有者必須:1. 至少發布過一部影片。2. 在其行動版 TikTok 應用程式的分析頁面中點擊「Turn On」按鈕。3. 擁有 100 位以上粉絲,才能取得更多關於觀眾與內容互動的洞察。
    • 若媒體包含受版權保護的內容,或被標記為侵犯版權,TikTok 不會回傳貼文分析。受版權保護的內容範例包括 reels 上的音訊(TikTok 會將這些影片靜音)。你可以在 TikTok 應用程式的「Activity -> System Notifications」中查看。
    • 若影片超過 7 天未有互動,部分 TikTok 分析欄位可能無法取得。若要取回這些資料,請對該影片產生新的互動(觀看、按讚、留言或分享),並在 24-48 小時後重試。若影片在回應中未出現,通常是因為影片因違規(例如音樂版權違規)而被過濾。這些欄位包括:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • LinkedIn 個人(member)檔案現在會回傳擴充的貼文分析指標。可用的 member 指標包括:
    • impressionCount — 貼文的曝光次數
    • uniqueImpressionsCount — 觸及的獨立會員數(LinkedIn MEMBERS_REACHED
    • likeCount — 表情回應數
    • commentCount — 留言數
    • shareCount — 貼文轉發次數
    • engagement — 自然點擊、按讚、留言與分享除以曝光數
    • reactions — 各類型表情回應的分佈(當有表情回應時)
    • 影片貼文:videoViewsvideoViewersvideoWatchTimeMs
    影片指標僅會針對影片貼文回傳,且貼文建立超過一年後即無法取得。
  • 無論限時動態是否被封存或加入精選,Instagram Story 的洞察僅於 24 小時內可用。注意:
    • 值小於 5 的 Story 媒體指標會回傳 0
    • 對於位於歐洲與日本的使用者所建立的 Stories,replies 指標會回傳 0
  • Facebook Story 分析目前無法使用。
  • Pinterest 分析資料(曝光、使用者粉絲、點擊)會在 24-72 小時後才可取得。
  • 對於 YouTube Shorts,觀看次數會回傳 Short 開始播放或重播的次數,沒有最低觀看時長要求。

標頭參數

主體參數

id
string
必填
/post 端點回傳的 Ayrshare Post ID。這是回傳的最外層 Ayrshare id,而不是 postIds 中的社群平台貼文 ID。
platforms
array
要取得分析的平台字串陣列。接受下列字串值的陣列:
若未提供 platforms,則會回傳該貼文所發送至之全部社群網路的分析。
當累積指標(例如按讚、留言、觀看數)暫時無法從社群網路取得時,API 會自動以已儲存的資料回填。每個平台的 analytics 物件可能會出現兩個選填欄位:
  • backfilledFrom(string,ISO 8601)— 當有一個以上的累積指標是以儲存資料替代時出現。時間戳表示儲存資料的最後更新時間。
  • recoveredFrom(string,ISO 8601)— 當整個分析回應因為 API 完全失敗而從儲存資料還原時出現。時間戳表示儲存資料的最後更新時間。
超過 4 天的儲存資料會視為過期,不會用於回填或還原。
LinkedIn 個人(member)分析 — 需重新連結。 在 member 貼文分析上線前就已連結的 LinkedIn 個人檔案,並未取得所需的分析權限範圍(scopes)。針對這些檔案的分析請求會回傳 錯誤代碼 475(「re-link your LinkedIn profile to enable analytics」)。帳號擁有者必須在 Social Accounts 頁面重新連結其 LinkedIn 個人檔案,以授予新的權限範圍。重新連結後,請預留數分鐘讓錯誤代碼 475 消失(Ayrshare 與 LinkedIn 都會短暫快取權限狀態,通常約 5-10 分鐘)。發文功能不受影響。LinkedIn member 貼文的計數為最佳估算:彙總的 shareCount(RESHARE)、likeCount(REACTION)與 commentCount(COMMENT)總數,可能會與 LinkedIn 介面顯示的數字略有差異。