Lấy Tất Cả Bài Viết Trong Nhóm Facebook

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

target_limit là trần số bài; credit_budget là trần credit theo bội số 30. API hoàn phần giữ trước chưa dùng và trả partial/has_more_available_from_fb để client quyết định có chạy phiên mới hay không.

Endpoint chính thức: https://tool.vn/api/facebook/scan-all-group-posts. 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/scan-all-group-posts' \
  -H 'Authorization: Bearer TOOLVN-V1-YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"group_id":"123450000000001","mode":"newest","target_limit":30,"credit_budget":300}'

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": 3,
    "credits_precharged": 300,
    "credits_charged": 30,
    "credits_refunded": 270,
    "requested_mode": "newest",
    "effective_mode": "newest",
    "fallback_used": false,
    "requested_limit": 30,
    "fetched_count": 1,
    "has_more_available_from_fb": false,
    "partial": false,
    "posts": [
        {
            "post_id": "1234567890123456",
            "legacy_post_id": "123450000000001_1234567890123456",
            "group_id": "123450000000001",
            "facebook_type": "Story",
            "author": {
                "id": "100000000000001",
                "name": "Tác giả công khai",
                "type": "User",
                "profile_url": "https://www.facebook.com/100000000000001",
                "profile_picture_url": "https://cdn.example.com/public-author.jpg"
            },
            "message": "Nội dung bài viết công khai minh họa.",
            "message_details": {
                "text": "Nội dung bài viết công khai minh họa.",
                "ranges": []
            },
            "created_time": 1786200000,
            "latest_activity_time": 1786200300,
            "permalink_url": "https://www.facebook.com/groups/123450000000001/posts/1234567890123456/",
            "group_context": {
                "id": "123450000000001",
                "name": "Tên nhóm công khai",
                "type": "Group",
                "visibility": "PUBLIC",
                "url": "https://www.facebook.com/groups/123450000000001"
            },
            "privacy": {
                "label": "Công khai",
                "type": "PUBLIC"
            },
            "attachments": [
                {
                    "type": "Photo",
                    "url": "https://www.facebook.com/photo/example",
                    "media": {
                        "type": "Photo",
                        "image": {
                            "url": "https://cdn.example.com/public-post.jpg",
                            "width": 1200,
                            "height": 900
                        }
                    }
                }
            ],
            "attachment_urls": [
                "https://cdn.example.com/public-post.jpg"
            ],
            "feedback": {
                "feedback_id": "ZmVlZGJhY2s6MTIzNDU2Nzg5MDEyMzQ1Ng==",
                "reaction_count": 10,
                "comment_count": 2,
                "share_count": 1,
                "top_reactions": [
                    {
                        "type": "LIKE",
                        "name": "Thích",
                        "count": 8
                    }
                ]
            },
            "reaction_count": 10,
            "comment_count": 2,
            "share_count": 1,
            "is_pinned": false
        }
    ]
}

Các trường response chung

Schema posts

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