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.
  • 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"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, messageid 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

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 commentIdtrue.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"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