Lấy Bài Viết Mới Trong Nhóm Facebook

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

Dùng endpoint này để lấy số lượng bài giới hạn. Trường mode nhận newest, recent_activity hoặc relevant; limit là số bài mong muốn.

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

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": 30,
    "credits_charged": 30,
    "credits_refunded": 0,
    "requested_mode": "newest",
    "effective_mode": "newest",
    "fallback_used": false,
    "requested_limit": 3,
    "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": [
                    {
                        "offset": 0,
                        "length": 8,
                        "entity": {
                            "id": "100000000000005",
                            "name": "Trang được nhắc đến",
                            "type": "Page",
                            "url": "https://www.facebook.com/100000000000005"
                        }
                    }
                ]
            },
            "message_richtext": {
                "text": "Nội dung có định dạng.",
                "blocks": [
                    {
                        "block_type": "PARAGRAPH",
                        "text": "Nội dung có định dạng.",
                        "depth": 0,
                        "inline_styles": [
                            {
                                "offset": 0,
                                "length": 8,
                                "type": "BOLD"
                            }
                        ],
                        "entity_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",
                    "title": "Ảnh trong bài viết",
                    "description": "Mô tả media công khai.",
                    "media": {
                        "id": "4234567890123456",
                        "type": "Photo",
                        "alt_text": "Ảnh minh họa công khai",
                        "width": 1200,
                        "height": 900,
                        "is_playable": false,
                        "image": {
                            "url": "https://cdn.example.com/public-post.jpg",
                            "width": 1200,
                            "height": 900
                        },
                        "images": {
                            "high": {
                                "url": "https://cdn.example.com/public-post-high.jpg",
                                "width": 1600,
                                "height": 1200
                            }
                        },
                        "can_share": true,
                        "can_download": false
                    }
                }
            ],
            "attachment_urls": [
                "https://cdn.example.com/public-post.jpg"
            ],
            "feedback": {
                "feedback_id": "ZmVlZGJhY2s6MTIzNDU2Nzg5MDEyMzQ1Ng==",
                "legacy_post_id": "123450000000001_1234567890123456",
                "target_type": "POST",
                "reaction_count": 10,
                "like_count": 8,
                "comment_count": 2,
                "top_level_comment_count": 2,
                "share_count": 1,
                "seen_by_count": 0,
                "seen_by_everyone": false,
                "top_reactions": [
                    {
                        "reaction_id": "LIKE",
                        "type": "LIKE",
                        "name": "Thích",
                        "count": 8,
                        "visible_in_bling_bar": true
                    }
                ],
                "supported_reactions": [
                    {
                        "id": "LIKE",
                        "type": "LIKE",
                        "name": "Thích",
                        "emoji": "👍"
                    }
                ],
                "reaction_display_strategy": "REACTION_COUNT",
                "reaction_summary": "10 lượt bày tỏ cảm xúc",
                "comments_disabled": false,
                "comment_count_hidden": false,
                "capabilities": {
                    "can_like": true,
                    "can_react": true,
                    "can_comment": true,
                    "can_comment_in_private": false,
                    "can_comment_anonymously": false,
                    "can_comment_with_file": false,
                    "can_comment_with_gif": false,
                    "can_comment_with_music": true,
                    "can_comment_with_photo": true,
                    "can_comment_with_stars": false,
                    "can_comment_with_sticker": false,
                    "can_comment_with_video": true,
                    "can_subscribe": true,
                    "can_append_photos": true,
                    "can_reshare_to_feed": true,
                    "can_reshare_to_story": false,
                    "can_share_to_broadcast_channel": false,
                    "can_share": true,
                    "comments_enabled": true,
                    "comment_count_visible": true,
                    "inline_comment_composer_hidden": false,
                    "feedback_actions_visible": true
                }
            },
            "reaction_count": 10,
            "comment_count": 2,
            "share_count": 1,
            "interaction_capabilities": {
                "can_like": true,
                "can_react": true,
                "can_comment": true,
                "can_share": true,
                "can_comment_in_private": false,
                "can_comment_anonymously": false,
                "can_comment_with_file": false,
                "can_comment_with_gif": false,
                "can_comment_with_music": true,
                "can_comment_with_photo": true,
                "can_comment_with_stars": false,
                "can_comment_with_sticker": false,
                "can_comment_with_video": true,
                "can_subscribe": true,
                "can_append_photos": true,
                "can_reshare_to_feed": true,
                "can_reshare_to_story": false,
                "can_share_to_broadcast_channel": false,
                "comments_enabled": true,
                "comment_count_visible": true,
                "inline_comment_composer_hidden": false,
                "feedback_actions_visible": true
            },
            "can_like": true,
            "can_react": true,
            "can_comment": true,
            "can_share": true,
            "comments_enabled": true,
            "comments_disabled": false,
            "comment_previews": [
                {
                    "comment_id": "2234567890123456",
                    "message": "Bình luận công khai gần đây.",
                    "message_details": {
                        "text": "Bình luận công khai gần đây."
                    },
                    "created_time": 1786200100,
                    "author": {
                        "id": "100000000000003",
                        "name": "Người bình luận",
                        "type": "User",
                        "profile_url": "https://www.facebook.com/100000000000003",
                        "profile_picture_url": "https://cdn.example.com/public-comment-author.jpg"
                    },
                    "privacy": "Public",
                    "reaction_count": 2,
                    "reply_count": 1,
                    "is_top_comment": true,
                    "is_featured": false,
                    "is_anonymous": false,
                    "attachments": []
                }
            ],
            "content_metadata": {
                "has_text_in_top_region": false
            },
            "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