Lấy Lượt Chia Sẻ Bài Viết Trong Nhóm Facebook

Tài Liệu API Cho Nhà Phát Triển

mode latest sắp theo thời gian có sẵn, relevant giữ thứ tự Facebook và all lấy nhiều trang kết quả. Mode all bắt buộc credit_budget; mỗi 25 lượt chia sẻ là một gói 30 credit.

Endpoint chính thức: https://tool.vn/api/facebook/get-group-post-shares. Hãy gửi POST JSON và xác thực bằng Authorization: Bearer ... khi tích hợp từ máy chủ hoặc ứng dụng của bạn.

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","post_id":"1234567890123456","mode":"all","limit":100,"credit_budget":150}'

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,
    "credit_unit_cost": 30,
    "records_per_credit_unit": 25,
    "credits_precharged": 150,
    "credits_charged": 30,
    "credits_refunded": 120,
    "post_id": "1234567890123456",
    "post_verified_in_group": true,
    "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

Schema shares

Nhóm không công khai trả HTTP 422 với PUBLIC_GROUP_REQUIRED; bài không thuộc nhóm trả 404 với POST_NOT_IN_GROUP; đầu vào sai trả 400 với INVALID_REQUEST; thiếu credit trả 402. Khi dịch vụ Facebook tạm thời không sẵn sàng, API 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âu hỏi thường gặp