Skip to main content
GET
Lấy các bình luận cho một bài đăng bằng cách sử dụng Ayrshare post ID, Social Post ID, Ayrshare Comment ID, hoặc Social Comment ID với Comment API. Vui lòng xem Tổng quan về Comments để biết thêm thông tin về các loại ID khác nhau.
Nếu sử dụng Ayrshare Post ID thì không yêu cầu tham số query nào.

Chi tiết Bình luận Bổ sung

  • Dữ liệu bình luận được cập nhật mỗi 10 phút cho tất cả các nền tảng, ngoại trừ X. Do các hạn chế do X API áp đặt, dữ liệu bình luận cho X được làm mới bằng chiến lược exponential backoff, có nghĩa là khoảng thời gian giữa các lần cập nhật dần tăng lên theo thời gian.
  • Trên X, yêu cầu bình luận cho một bài đăng mà bản thân nó là một câu trả lời sẽ trả về các câu trả lời cho bài đăng đó. Một bài đăng X bắt đầu cuộc trò chuyện của riêng nó không thay đổi và vẫn trả về các câu trả lời từ khắp cuộc trò chuyện đó.
  • Trong phản hồi Facebook, các câu trả lời bình luận cho các câu trả lời luôn có cùng parent.id.
  • Truy xuất các câu trả lời LinkedIn cho các bình luận bằng cách đặt các tham số query "commentId": true và "searchPlatformId": true và cung cấp Social Comment ID trong tham số path.
  • Facebook và Instagram trả về tối đa 1.000 bình luận gần đây nhất trên một bài đăng. Vui lòng liên hệ với chúng tôi về các giới hạn cao hơn trên gói Enterprise.
  • Đối với một bài đăng TikTok vẫn đang được xử lý (id của nó là "pending"), get-comments trả về một lỗi “still processing” rõ ràng (code: 288, HTTP 400) thay vì một lỗi chung chung. Thử lại sau khi tikTokPublished webhook kích hoạt hoặc /history hiển thị video id đã được phân giải.

Đọc Đa nền tảng & Thành công Một phần

Khi bạn yêu cầu bình luận bằng Ayrshare Post ID, bài đăng có thể trải rộng trên nhiều nền tảng. Ayrshare phân tán một yêu cầu (“leg”) cho mỗi nền tảng và trả về thành công một phần nếu một số nhánh thành công và một số khác thất bại — dữ liệu bình luận của các nền tảng hoạt động tốt luôn được trả về, và mỗi nhánh thất bại được liệt kê trong mảng errors[] ở cấp cao nhất.
  • Một số nền tảng thành công, một số thất bại: phản hồi là HTTP 200 với status: “partial”. Các khối theo từng nền tảng hoạt động tốt được trả về như thường lệ, và mảng errors[] ở cấp cao nhất liệt kê mọi nhánh thất bại kèm platform, status, code, message và id của nó.
  • Mọi nền tảng đều thất bại: phản hồi có status: “error” và mảng errors[] đầy đủ. Trạng thái HTTP được ánh xạ từ mã lỗi đại diện ở cấp cao nhất. Code 485 ánh xạ sang HTTP 404; các mã đại diện khác sử dụng ánh xạ riêng của chúng.
  • Tất cả nền tảng đều thành công: phản hồi không thay đổi — HTTP 200, status: “success” và không có khoá errors[].
Thay đổi hành vi — hãy kiểm tra errors[], đừng phân nhánh dựa trên trạng thái HTTP. Vì lệnh đọc đa nền tảng với một nhánh thất bại giờ trả về HTTP 200 thay vì thu gọn toàn bộ phản hồi thành lỗi, các integrator nên luôn kiểm tra sự hiện diện của mảng errors[] ở cấp cao nhất để phát hiện thất bại theo từng nền tảng thay vì chỉ dựa vào mã trạng thái HTTP.

Bình luận Instagram / Facebook Story Đã hết hạn hoặc Không khả dụng

Một nhánh bình luận Instagram hoặc Facebook Story đã hết hạn hoặc không khả dụng — do đó không thể truy xuất bình luận của nó — sẽ xuất hiện trong errors[] với code 485. Một thông báo Instagram đại diện là “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” Nếu một nền tảng khác thành công, bình luận của nó vẫn được trả về và phản hồi tổng thể là HTTP 200. Đối với phản hồi toàn thất bại, code đại diện 485 ánh xạ sang HTTP 404; các mã đại diện khác sử dụng ánh xạ riêng của chúng. So khớp trên code (485), không phải văn bản thông báo chính xác.

Ví dụ: Phản hồi Thành công Một phần

200: Thành công Một phần

Lỗi Thanh toán và Rate Limit của X

Một lệnh đọc bình luận cho X có thể thất bại trên chính tài khoản X Developer của bạn, thường gặp nhất là do tài khoản không còn credit API, hoặc do bạn đã chạm đến rate limit của X. Những thất bại này trả về một lỗi có kiểu thay vì một danh sách bình luận rỗng, nên sự cố tài khoản không bao giờ bị nhầm với một bài đăng không có bình luận nào.
  • X trả về HTTP 402 (không có credit API): Ayrshare trả về code: 416 với HTTP 402.
  • X trả về HTTP 429 (rate limit): Ayrshare trả về code: 364 với HTTP 429. Khi 429 của X cho biết tài khoản đã hết credit, Ayrshare sẽ trả về code: 416 thay thế, vì việc chờ đợi sẽ không khắc phục được lỗi này.
  • Thất bại uỷ quyền trả về code: 272, và mọi thất bại X khác trả về code: 219, cả hai đều với HTTP 400.
Trong một lệnh đọc đa nền tảng, phản hồi có status: “partial” ở cấp cao nhất và nhánh X thất bại xuất hiện trong errors[] với status: “error”, đúng như mô tả ở trên; lệnh đọc một nền tảng trả về lỗi ở cấp cao nhất. Khi X từ chối thẳng yêu cầu, thất bại này không được lưu vào bộ nhớ đệm, nên lệnh đọc sẽ được thử lại ngay khi bạn yêu cầu bình luận lần nữa. Một bài đăng X đã bị xoá, hoặc mà thông tin xác thực X của bạn không thể xem, vẫn trả về một mảng rỗng mà không có lỗi.

Tham số Header

Tham số Path

Tham số Query

boolean
mặc định:false
Nếu lấy bình luận trên một bài đăng được xuất bản qua Ayrshare và sử dụng Ayrshare Post ID, không bao gồm trường này - nó mặc định là false. Nếu lấy bình luận sử dụng Social Post ID hoặc Social Comment ID, là ID được tạo bởi các mạng xã hội, đặt thành true.
boolean
mặc định:false
Nếu lấy bình luận sử dụng Social Comment ID, là ID bình luận được tạo bởi các mạng xã hội, đặt thành true.Nếu lấy bình luận sử dụng Ayrshare Post ID hoặc Social Post ID, không bao gồm trường này - nó mặc định là false.
Nếu sử dụng tham số query commentId, bạn cũng phải đặt searchPlatformId thành true.
string
Bắt buộc nếu searchPlatformId hoặc commentId là true.Khi nào sử dụng:
  • Nếu sử dụng Social Post ID và trường "searchPlatformId": true. Các nền tảng được hỗ trợ: bluesky, facebook, instagram, linkedin, threads, tiktok, twitter, youtube.
  • Nếu sử dụng Social Comment ID và các trường "searchPlatformId": true và "commentId": true. Các nền tảng được hỗ trợ: facebook, instagram, linkedin.
  • Nếu sử dụng Ayrshare Post ID, không bao gồm trường này - các bình luận sẽ được trả về từ tất cả các nền tảng nơi bài đăng gốc đã được xuất bản.

Ví dụ Yêu cầu GET Bình luận