Lấy Lượt Chia Sẻ Bài Viết Trong Nhóm Facebook
Lấy danh sách lượt chia sẻ mà Facebook công khai cho một bài viết trong nhóm công khai, có phân trang và tổng lượt.
Chỉ hỗ trợ nhóm Facebook công khai
Tool.vn không hỗ trợ nhóm riêng tư, nhóm ẩn hoặc nội dung yêu cầu quyền thành viên/quản trị viên và không cố gắng vượt qua cài đặt quyền riêng tư của Facebook.
Thực hiện quét
Cách công cụ xử lý
Facebook không công khai mọi lượt chia sẻ và capture không có ranking riêng cho share; “phù hợp” giữ nguyên thứ tự Facebook, “mới nhất” chỉ sắp theo timestamp nếu response có trường này.
- Xác thực tài khoản Tool.vn và kiểm tra đầu vào.
- Giữ trước ngân sách
max_fb_requests × 30. - Xác minh nhóm công khai, gửi request v573 đầy đủ và phân trang trong ngân sách.
- Loại danh tính tài khoản quét, chuẩn hóa dữ liệu rồi hoàn credit chưa dùng.
Không trả raw GraphQL, token, viewer state, device/session hoặc cursor Facebook.
Kết quả
Xem JSON API đã làm sạch
Hướng dẫn API Lượt chia sẻ bài viết nhóm
Endpoint chính thức: https://tool.vn/api/facebook/get-group-post-shares. Khuyến nghị gửi POST JSON với Authorization: Bearer .... GET chỉ dành cho API key truyền rõ ràng; không cho phép GET trừ credit bằng cookie. Cookie đăng nhập chỉ được dùng bởi form cùng nguồn Tool.vn với kiểm tra chống CSRF.
| Tham số | Bắt buộc | Mô tả |
|---|---|---|
group_id | Có | ID số của nhóm Facebook công khai. |
post_id / post_url | Có | ID số, ID ghép hoặc URL bài viết thuộc nhóm. |
mode | Không | latest, relevant, all. |
limit | Không | Số bản ghi mong muốn, từ 1 đến 5000; không phải số request Facebook. |
max_fb_requests | Có khi quét tất cả | Ngân sách request Facebook tối đa, từ 1 đến 100. |
Ví dụ cURL JSON
curl -X POST 'https://tool.vn/api/facebook/get-group-post-shares' \
-H 'Authorization: Bearer TOOLVN-V1-YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{"group_id":"123450000000001","max_fb_requests":5,"post_id":"1234567890123456","mode":"all","limit":100}'
Cấu trúc response
{
"status": "success",
"message": "Lấy dữ liệu nhóm Facebook công khai thành công.",
"version": "v1.0.0",
"request_id": "FBG-EXAMPLE",
"group_id": "123450000000001",
"group_visibility": "PUBLIC",
"public_group_only": true,
"fb_requests_used": 2,
"max_fb_requests": 5,
"credit_per_fb_request": 30,
"credits_precharged": 150,
"credits_charged": 60,
"credits_refunded": 90,
"post_id": "1234567890123456",
"requested_mode": "all",
"effective_mode": "all",
"requested_limit": 100,
"fetched_count": 1,
"total_share_count": 1,
"has_more_available_from_fb": false,
"partial": false,
"shares": [
{
"share_id": "3234567890123456",
"group_id": "123450000000001",
"post_id": "1234567890123456",
"actor": {
"id": "100000000000004",
"name": "Người chia sẻ"
},
"message": "Nội dung chia sẻ công khai.",
"created_time": 1786200000
}
]
}
Các trường response chung
| Trường | Ý nghĩa |
|---|---|
status, message, request_id, version | Trạng thái Tool.vn, thông báo, mã truy vết và phiên bản endpoint. |
group_id, group_visibility, public_group_only | Nhóm đã xác minh; response thành công chỉ có nhóm PUBLIC. |
fb_requests_used, max_fb_requests | Số request đã thực gửi Facebook và ngân sách tối đa người dùng cho phép. |
credits_precharged, credits_charged, credits_refunded | Số credit giữ trước, chi phí thực tế và phần hoàn; mỗi request đã gửi là 30 credit. |
requested_limit, fetched_count | Số bản ghi mong muốn và số bản ghi sạch thực trả về (không áp dụng cho endpoint chỉ lấy thông tin nhóm). |
has_more_available_from_fb, partial | Facebook còn trang kế tiếp hay không và việc quét có dừng vì hết ngân sách hay không. |
Schema shares
| Trường bản ghi | Mô tả |
|---|---|
share_id/post_id/group_id | ID lượt chia sẻ, bài và nhóm |
actor | Người/Page chia sẻ công khai |
message/created_time | Nội dung và Unix timestamp nếu có |
permalink_url | URL chia sẻ công khai nếu có |
Lỗi nhóm không công khai trả HTTP 422 với error_code=PUBLIC_GROUP_REQUIRED. Lỗi đầu vào trả 400; thiếu credit trả 402; lỗi upstream Facebook trả 502/503. Dữ liệu nghiệp vụ nằm ở top-level để tương thích API Tool.vn hiện tại.
Các công cụ Facebook Group liên quan
Xem thêm toàn bộ công cụ Facebook, hướng dẫn API chung, bài viết mới Profile/Fanpage và lấy ID từ liên kết Facebook.