Chuyển đến nội dung chính
POST
Nhận dữ liệu phân tích theo thời gian thực như lượt thích, lượt hiển thị, lượt xem và phản ứng cho một bài đăng đã được gửi qua Ayrshare bằng cách sử dụng Ayrshare Post ID. Đối với phân tích các bài đăng có nguồn gốc bên ngoài Ayrshare, hãy xem Phân tích theo Social Post ID.
Facebook: một số chỉ số reach và video đã bị Meta ngừng hỗ trợ (15 tháng 6, 2026). Meta đã loại bỏ các chỉ số Insights về unique-impression và video-view 3 giây trên tất cả các phiên bản Graph API, vì vậy đối tượng analytics của Facebook không còn trả về impressionsUnique, impressionsFanUnique, impressionsOrganicUnique, impressionsPaidUnique, hoặc videoViewsUnique. Sử dụng mediaView cho reach (một chỉ số kế nhiệm Total Unique Media Views đang được lên kế hoạch). Các trường thường được sử dụng khác như reactionsByTypevideoViews không bị ảnh hưởng. Tham khảo: Các Thay đổi API Sắp tới — 15 tháng 6, 2026.

Thông tin Bổ sung

  • Các nền tảng sau hiện được hỗ trợ: Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, và YouTube.
  • Số lượng bình luận trên Facebook và Instagram hiển thị trong API có thể khác với số lượng hiển thị trong ứng dụng mạng xã hội. Điều này xảy ra vì hai lý do: - Một số người dùng có cài đặt quyền riêng tư ẩn bình luận của họ với những người không phải bạn bè hoặc không có kết nối chung. Những bình luận riêng tư này vẫn được tính vào tổng số bình luận. - Có thể có sự không nhất quán trong dữ liệu được Meta báo cáo.
  • Các chỉ số igReelsAggregatedAllPlaysCount và playsCount của Instagram hiển thị trong API có thể khác với số lượng hiển thị trong ứng dụng mạng xã hội. Điều này có thể xảy ra vì một số lý do:
    • Bài đăng đã được quảng bá. Chỉ các lượt phát tự nhiên được bao gồm trong phản hồi API.
    • Có thể có sự không nhất quán trong dữ liệu được Meta báo cáo.
  • Các Thread của X/Twitter trả về dưới dạng một Mảng các đối tượng, với mỗi đối tượng tương ứng với một Tweet trong Thread.
  • YouTube có thể mất 24-48 giờ để xử lý phân tích cho các video có ít lượt xem video hoặc ít người theo dõi kênh.
  • Phân tích TikTok:
    • TikTok có thể mất 24-48 giờ để cập nhật dữ liệu phân tích của họ, chẳng hạn như lượt xem video, nhân khẩu học, lượt thích, lượt chia sẻ và bình luận.
    • Để truy cập phân tích TikTok, chủ tài khoản phải: 1. Đăng ít nhất một video. 2. Nhấn nút “Turn On” trên trang Analytics của ứng dụng TikTok di động của họ. 3. Có 100 người theo dõi để nhận thông tin chi tiết bổ sung về người xem và mức độ tương tác nội dung.
    • TikTok không trả về phân tích bài đăng nếu media chứa tài liệu có bản quyền hoặc đã bị gắn cờ vi phạm bản quyền. Ví dụ về tài liệu có bản quyền có thể bao gồm âm thanh trên reels (TikTok sẽ tắt tiếng các video này). Bạn có thể kiểm tra trong ứng dụng TikTok ở phần Activity -> System Notifications.
    • Một số trường phân tích TikTok có thể không có sẵn nếu video đã không hoạt động trong hơn 7 ngày. Để truy xuất dữ liệu này, hãy tạo hoạt động mới trên video (xem, thích, bình luận hoặc chia sẻ) và thử lại sau 24-48 giờ. Nếu một video không được trả về trong phản hồi, lý do có thể là video đã bị lọc ra do vi phạm, chẳng hạn như vi phạm bản quyền âm nhạc. Các trường này bao gồm:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • Hồ sơ LinkedIn cá nhân (thành viên) hiện trả về một ma trận phân tích bài đăng mở rộng. Các chỉ số thành viên có sẵn là:
    • impressionCount — Lượt hiển thị trên bài đăng
    • uniqueImpressionsCount — Số thành viên duy nhất tiếp cận được (LinkedIn MEMBERS_REACHED)
    • likeCount — Số lượng phản ứng
    • commentCount — Số lượng bình luận
    • shareCount — Số lần chia sẻ lại bài đăng
    • engagement — Lượt nhấp, thích, bình luận và chia sẻ tự nhiên trên lượt hiển thị
    • reactions — Phân tích phản ứng theo từng loại (khi có phản ứng)
    • Đối với bài đăng video: videoViews, videoViewers, và videoWatchTimeMs
    Các chỉ số video chỉ được trả về cho các bài đăng video và không có sẵn sau hơn một năm kể từ khi bài đăng được tạo.
  • Thông tin chi tiết về Instagram Story chỉ có sẵn trong 24 giờ, bất kể các story có được lưu trữ hoặc đặt làm nổi bật hay không. Lưu ý:
    • Các chỉ số media của story có giá trị nhỏ hơn 5 sẽ trả về là 0.
    • Đối với các Story được tạo bởi người dùng ở Châu Âu và Nhật Bản, chỉ số replies trả về giá trị 0.
  • Phân tích Facebook Story không có sẵn.
  • Dữ liệu phân tích Pinterest (lượt hiển thị, người theo dõi và lượt nhấp) trở nên khả dụng sau 24-72 giờ.
  • Đối với YouTube Shorts, lượt xem sẽ trả về số lần một Short bắt đầu phát hoặc phát lại, không có yêu cầu về thời gian xem tối thiểu.

Tham số Header

Tham số Body

id
string
bắt buộc
Ayrshare Post ID được trả về từ endpoint /post. Đây là id Ayrshare cấp cao nhất được trả về và không phải là các social post id trong postIds.
platforms
array
Mảng chuỗi các nền tảng để truy xuất phân tích. Chấp nhận một mảng các chuỗi với các giá trị:
Nếu platforms không được bao gồm, dữ liệu phân tích sẽ được trả về cho tất cả các mạng xã hội mà bài đăng đã được gửi đến.
Khi các chỉ số tích lũy (ví dụ: lượt thích, bình luận, lượt xem) tạm thời không có sẵn từ mạng xã hội, API sẽ tự động điền chúng từ dữ liệu đã lưu trữ. Hai trường tùy chọn có thể xuất hiện trong đối tượng analytics theo từng nền tảng:
  • backfilledFrom (string, ISO 8601) — Xuất hiện khi một hoặc nhiều chỉ số tích lũy được thay thế từ dữ liệu đã lưu trữ. Timestamp cho biết khi nào dữ liệu được lưu trữ được cập nhật lần cuối.
  • recoveredFrom (string, ISO 8601) — Xuất hiện khi toàn bộ phản hồi phân tích được khôi phục từ dữ liệu đã lưu trữ do lỗi API hoàn toàn. Timestamp cho biết khi nào dữ liệu được lưu trữ được cập nhật lần cuối.
Dữ liệu đã lưu trữ cũ hơn 4 ngày được coi là lỗi thời và sẽ không được sử dụng để điền bổ sung hoặc khôi phục.
Phân tích LinkedIn cá nhân (thành viên) — yêu cầu liên kết lại. Các hồ sơ LinkedIn cá nhân được liên kết trước khi phân tích bài đăng thành viên được triển khai không có các scope phân tích cần thiết. Các yêu cầu phân tích cho các hồ sơ đó trả về mã lỗi 475 (“re-link your LinkedIn profile to enable analytics”). Chủ tài khoản phải liên kết lại hồ sơ LinkedIn của họ trên trang Social Accounts để cấp các scope mới. Hãy đợi vài phút sau khi liên kết lại để mã 475 được xóa (Ayrshare và LinkedIn đều tạm thời cache trạng thái quyền, thường là ~5-10 phút). Việc đăng bài không bị ảnh hưởng.Số lượng bài đăng thành viên LinkedIn là best-effort: tổng shareCount (RESHARE), likeCount (REACTION), và commentCount (COMMENT) có thể khác một chút so với các số hiển thị trong giao diện người dùng LinkedIn.