Skip to main content
GET
Endpoint này truy xuất thông tin chi tiết về người dùng đã xác thực hoặc user profile, bao gồm:
  • Danh sách đầy đủ tất cả các social media account đã liên kết
  • Tên người dùng mạng xã hội và thông tin profile
  • Trạng thái tài khoản và các chỉ số sử dụng
Dữ liệu trả về phản ánh trạng thái của các mạng xã hội đã kết nối tính đến lần làm mới gần nhất và được cập nhật bất cứ khi nào người dùng kết nối hoặc ngắt kết nối các social media account của họ.
Bộ nhớ đệm phản hồi. Các phản hồi được lưu trong bộ nhớ đệm trong tối đa 60 giây. Các trường lastUpdated và nextUpdate mô tả khoảng thời gian của bộ nhớ đệm đó: lastUpdated là thời điểm ảnh chụp được tạo, còn nextUpdate là thời điểm nó hết hạn.nextUpdate là một dấu mốc hết hạn bộ nhớ đệm, không phải tín hiệu sẵn sàng. Nó được đóng dấu trên mọi phản hồi, kể cả phản hồi mà displayNames chưa liệt kê một tài khoản bạn vừa được thông báo, nên nó không thể cho bạn biết khi nào một tài khoản vừa được liên kết đã hoàn tất lan truyền.Nếu bạn đang đối soát một webhook social cho một liên kết hoàn toàn mới, hãy polling cho đến khi tài khoản bạn mong đợi thực sự xuất hiện trong displayNames — đừng coi một phản hồi đơn lẻ, hay sự xuất hiện của nextUpdate, là xác nhận rằng liên kết đã vắng mặt hoặc đã hoàn tất.
username và displayName của Threads. Trong một mục Threads của displayNames, username là handle của tài khoản (ví dụ ayrshare). displayName là tên hiển thị trên hồ sơ (ví dụ Ayrshare). Hai giá trị này có thể khác nhau, vì vậy hãy dùng username hoặc profileUrl để tìm tài khoản Threads.
Nếu không có social account nào được liên kết, activeSocialAccounts sẽ không được trả về. Lấy dữ liệu cho một User Profile cụ thể bằng cách thêm Profile-Key trong header.
  • Nếu doanh nghiệp của bạn cần thu thập tất cả dữ liệu user profile cùng một lúc, vui lòng sử dụng endpoint /user/batch.
  • Nếu bạn cần thông báo khi người dùng liên kết và hủy liên kết một social account, vui lòng xem endpoint /webhooks.

Tham số Header

Tham số Query

boolean
mặc định:false
Trả về các chi tiết Instagram bổ sung như loại tài khoản (business hoặc creator) và hạn mức đã sử dụng. Không khuyến nghị trừ khi bạn cần dữ liệu bổ sung vì nó sẽ làm chậm thời gian phản hồi.

Hạn mức bài đăng hàng tháng

Phản hồi cho biết profile đã dùng bao nhiêu hạn mức bài đăng hàng tháng:
  • monthlyPostCount: số bài đăng đã được tính vào hạn mức trong tháng này.
  • monthlyPostQuota: giới hạn hàng tháng. Trường này không được trả về khi hạn mức từ 10.000 trở lên, ví dụ với các gói Business. Giới hạn vẫn được áp dụng.
Bộ đếm được đặt lại vào ngày 1 mỗi tháng lúc 00:07 UTC, không phải vào ngày thanh toán của bạn. Các lần đăng bài thất bại cũng được tính. monthlyApiCalls là một bộ đếm khác và không phải hạn mức bài đăng. Xem Tôi có thể đăng và gọi API bao nhiêu lần? để biết những gì được tính và điều gì xảy ra khi hết hạn mức.