Chuyển đến nội dung chính
POST
Nhận dữ liệu phân tích và nhân khẩu học về hồ sơ mạng xã hội của người dùng, chẳng hạn như lượt hiển thị, lượt xem và người theo dõi. Hiện có sẵn cho Bluesky, Facebook Pages, Google My Business, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok, X/Twitter, và YouTube.
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 unique impression và video-view (unique) 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ề nhóm pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*, pagePostsServedImpressionsOrganicUnique) hoặc pageVideoViewsUnique. Sử dụng pageMediaView cho reach (một chỉ số kế nhiệm Total Unique Media Views đang được lên kế hoạch). pagePostEngagements, pageVideoViews, và pageVideoViewsPaid không bị ảnh hưởng. Tham khảo: Các Thay đổi API Sắp tới — 15 tháng 6, 2026.
  • Phân tích Facebook Page chỉ có sẵn trên các Trang có 100 lượt thích trở lên, chẳng hạn như nhân khẩu học. Facebook thường cập nhật các chỉ số của họ mỗi 24 giờ một lần.
  • Instagram có thể mất tới 48 giờ để tính toán dữ liệu phân tích. Phân tích số lượng người theo dõi không có sẵn với ít hơn 100 người theo dõi. Các chỉ số nhân khẩu học chỉ trả về 45 người có hiệu suất hàng đầu, chỉ những người xem có dữ liệu nhân khẩu học mới được sử dụng trong tính toán chỉ số nhân khẩu học, và dữ liệu nhân khẩu học không được trả về nếu Người dùng Instagram có ít hơn 100 lượt tương tác trong 30 ngày qua.
  • Khi truy xuất phân tích xã hội của Instagram, thông tin nhân khẩu học có thể không xuất hiện trong phản hồi cho các chỉ số cụ thể. Thông tin nhân khẩu học sẽ xuất hiện khi các chỉ số có hơn 100 người trong mỗi phân tích. Vui lòng xem Cảnh báo Nhân khẩu học Phân tích Instagram để biết thêm thông tin.
  • LinkedIn hỗ trợ cả phân tích Company Page và phân tích hồ sơ cá nhân (thành viên). Đối với hồ sơ cá nhân, đối tượng analytics bao gồm followersCount tổng lượt, tăng trưởng follower hàng ngày trong followersDaily[], và các chỉ số bài đăng tổng hợp (impressionCount, uniqueImpressionsCount, likeCount, commentCount, shareCount). Tổng count của LinkedIn là nhất quán cuối cùng, nhưng không nhất quán ngay lập tức, và có thể mất 24-48 giờ trong một số trường hợp. Tổng shareCount, likeCount, và commentCount cho hồ sơ cá nhân là best-effort và 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.
  • 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.
  • Vui lòng xem endpoint phân tích bài đăng để biết thêm thông tin.

Tham số Header

Tham số Body

platforms
array
bắt buộc
Các nền tảng mạng xã hội để nhận dữ liệu phân tích. Chấp nhận một mảng các chuỗi với các giá trị:
quarters
integer
Chỉ định số quý dữ liệu lịch sử cần trả về. Một quý là:
  • 85 ngày đối với Facebook
  • 90 ngày đối với Instagram, TikTok, và YouTube
  • 90 ngày đối với Snapchat (giới hạn ở 1 quý / tối đa 90 ngày do giới hạn của Snapchat API)
Có sẵn cho các nền tảng Facebook, Instagram, Snapchat, TikTok, và YouTube. Giá trị hợp lệ: 1–4. Chỉ các giá trị lớn hơn 0 mới kích hoạt bộ lọc ngày.Bộ lọc ngày (Instagram & TikTok): Bộ lọc ngày được kích hoạt khi daily=true HOẶC quarters > 0. Nếu không cung cấp cả dailyquarters, dữ liệu toàn thời gian sẽ được trả về mà không áp dụng bộ lọc ngày.Lưu ý: quarters: 0 hiện được coi là không có khoảng ngày (dữ liệu toàn thời gian). Trước đây, quarters: 0 được xử lý như quarters: 1.
daily
boolean
mặc định:false
Khi được đặt thành true, trả về dữ liệu phân tích dưới dạng giá trị chuỗi thời gian hàng ngày thay vì tổng gộp. Tùy chọn này chỉ có sẵn cho các nền tảng Facebook, Instagram, Snapchat, TikTok, và YouTube. Do kích thước dữ liệu lớn hơn, nên sử dụng nén.Đối với Instagram và TikTok, đặt daily=true cũng kích hoạt bộ lọc ngày sử dụng một cửa sổ quý ngắn hơn mặc định.Instagram reach: Với daily=true, phản hồi Instagram trả về một đối tượng reach lồng nhau (chứa period và một chuỗi thời gian values) thay vì trường vô hướng reachCount được trả về ở chế độ không hàng ngày.
period60Days
boolean
mặc định:false
Đối với phân tích TikTok, khi được đặt thành true, tùy chọn này chỉ trả về tổng gộp 60 ngày cho bình luận, lượt chia sẻ và lượt xem (commentCountTotal, shareCountTotal, viewCountTotal). Điều này cung cấp thời gian phản hồi nhanh hơn so với việc truy xuất toàn bộ lịch sử phân tích. Lưu ý: Không sử dụng tham số này cùng với daily=true vì chúng không tương thích với nhau.Quan trọng: Kể từ ngày 1 tháng 3, 2025, TikTok đã chuyển sang tổng 60 ngày. Kể từ tháng 4 năm 2026, TikTok sử dụng bộ lọc ngày dựa trên quý — hãy sử dụng tham số quarters để kiểm soát cửa sổ ngày (ví dụ: quarters: 1 = 90 ngày, quarters: 2 = 180 ngày). Xem các thay đổi sắp tới để biết chi tiết.
youtube
object
Các tùy chọn dành riêng cho nền tảng đối với phân tích YouTube.lifetime (boolean, mặc định: false): Khi được đặt thành true, bao gồm lifetimeLikes trong phản hồi - tổng lượt thích trên tất cả các video công khai trên kênh. Điều này được tính bằng cách lấy tất cả các video và cộng tổng số lượt thích của chúng, do đó có thể mất nhiều thời gian hơn đối với các kênh có nhiều video.Ngưỡng: Các kênh có hơn 1.000 video sẽ trả về lifetimeLikes: null và một cảnh báo trong mảng warnings cấp cao nhất. Điều này ngăn chặn việc sử dụng API quá mức.Bộ nhớ đệm: Theo từng kênh, với TTL ngắn hơn cho các kết quả không thành công để các lần thử lại nhận được thay đổi trạng thái kịp thời:
  • Giá trị lifetimeLikes thành công: 24 giờ.
  • Bỏ qua do 1.000 video (cảnh báo code: 445): 1 giờ — đủ ngắn để một kênh xóa video xuống dưới ngưỡng không phải chờ cả ngày để nhận được giá trị thực.
  • Lỗi tạm thời của YouTube Data API (cảnh báo code: 446): không được lưu trong bộ đệm — yêu cầu tiếp theo sẽ thử lại.
Lưu ý: Video đã xóa hoặc video riêng tư bị loại khỏi tổng, do đó tổng có thể khác so với lượt thích “thực” trong suốt thời gian tồn tại đối với các kênh đã xóa video.Ví dụ yêu cầu:
userId
string
Chỉ dành cho X/Twitter. Tham số này cho phép bạn truy xuất bài đăng từ một người dùng X/Twitter cụ thể theo ID số của họ, thay vì từ tài khoản đã liên kết của bạn.Ví dụ, để nhận tất cả các bài đăng từ handle @Google, bạn sẽ sử dụng userId số của họ 20536157.Bạn có thể tìm userId số của bất kỳ người dùng X/Twitter nào bằng cách sử dụng endpoint Brands Get User.Lưu ý: Chỉ sử dụng API KEY trong header để thực hiện yêu cầu này. Không bao gồm Profile Key.
userName
string
Chỉ dành cho X/Twitter. Tham số này cho phép bạn truy xuất bài đăng từ một người dùng X/Twitter cụ thể theo handle của họ, thay vì từ tài khoản đã liên kết của bạn.Ví dụ, để nhận tất cả các bài đăng từ handle @Google.Lưu ý: Chỉ sử dụng API KEY trong header để thực hiện yêu cầu này. Không bao gồm Profile Key.
Khi các chỉ số tích lũy (ví dụ: người theo dõi, lượt thích) tạm thời không có sẵn từ mạng xã hội, API sẽ tự động điền bổ sung 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 đã 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 đã 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.LinkedIn reactions: Chỉ số reactions tích lũy ở cấp bài đăng (một đối tượng chứa số lượng phản ứng theo từng loại) tuân theo cơ chế backfill chỉ khi rỗng. Khi LinkedIn giới hạn tốc độ tìm nạp reactions, giá trị được chuyển tiếp từ snapshot thành công cuối cùng — và backfilledFrom được đặt thành timestamp của snapshot đó — thay vì quay lại giá trị rỗng.
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 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 xã hội 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.
warnings (mảng các đối tượng, trường cấp cao nhất tùy chọn) — Chỉ xuất hiện khi Ayrshare cần thông báo cho người gọi về một tình huống không nghiêm trọng (ví dụ: một tính toán opt-in đã bị bỏ qua). Vắng mặt khỏi phản hồi khi không có gì để cảnh báo.Mỗi mục là một đối tượng có cấu trúc, không phải chuỗi tự do:
TrườngKiểuMô tả
actionstringNgữ cảnh thao tác đã tạo ra cảnh báo (ví dụ: "analytics").
statusstringLuôn là "warning" cho các mục trong mảng warnings.
codenumberMã cảnh báo Ayrshare ổn định. An toàn để đối chiếu trong mã máy khách.
messagestringMô tả có thể đọc được bởi con người.
detailsstringNgữ cảnh bổ sung tùy chọn dành riêng cho phiên bản cảnh báo này.
Các mã cảnh báo đã biết:
  • 445lifetimeLikes đã bị bỏ qua vì kênh YouTube vượt quá ngưỡng 1.000 video.
  • 446lifetimeLikes không có sẵn vì YouTube Data API đã trả về lỗi cho playlist uploads hoặc mọi batch videos.list.