Facebook Group ToolAPI v1.0.0
Xem Chi Tiết Bài Viết Trong Nhóm Facebook
Lấy nội dung, tác giả, thời gian, media và chỉ số tương tác của một bài thuộc đúng nhóm Facebook công khai.
Nhập thông tin
Nhóm công khaiBạn sẽ nhận được
- Dữ liệu có cấu trúc, hiển thị trực quan và có thể sao chép dưới dạng JSON.
- Kết quả theo đúng chế độ sắp xếp và số lượng bạn chọn.
- ID, nội dung, thời gian, tương tác và liên kết nguồn khi Facebook cung cấp.
Chi phí được tính từ số bài tối đa và hiển thị trước khi thực hiện. Phần credit giữ trước chưa dùng được hoàn khi phiên kết thúc.
Xem hướng dẫn và tài liệu APIKết quả từ nhóm
Xem dữ liệu JSON
Tổng Quan Về Công Cụ
Trang chi tiết dùng khi bạn đã có post ID hoặc URL và muốn lấy một object bài viết đầy đủ hơn: nội dung text, tác giả công khai, thời gian, permalink, URL media và số phản ứng/bình luận/chia sẻ Facebook cung cấp.
Hai điều kiện được kiểm tra trước khi trả dữ liệu: nhóm phải công khai và bài phải được chứng minh thuộc đúng nhóm đã khai báo. Nếu không đủ bằng chứng, endpoint trả POST_NOT_IN_GROUP thay vì trả một bài có ID gần giống từ nơi khác.
Tính năng và lợi ích chính
- Nhận nhiều dạng ID: Hỗ trợ post ID, groupID_postID hoặc URL bài viết.
- Xác minh sở hữu: Success luôn có post_verified_in_group=true.
- Media rõ ràng: Trả các URL media công khai liên quan trực tiếp đến bài viết khi Facebook cung cấp.
- Object dễ dùng: Schema post nhất quán với công cụ feed và tìm kiếm.
Trường hợp sử dụng phù hợp
- Lấy nội dung đầy đủ sau khi tìm thấy post ID.
- Hiển thị preview bài nhóm trong CRM hoặc dashboard.
- Lấy permalink và media công khai để phục vụ kiểm duyệt.
- Làm bước xác minh trước workflow bình luận hoặc lượt chia sẻ.
Phạm vi dữ liệu và quyền riêng tư
Công cụ chỉ hỗ trợ dữ liệu công khai mà Facebook cho phép truy cập. Kết quả được trả theo đúng các trường mô tả trong tài liệu API.
- Bài riêng tư, bài đã xóa hoặc bài không còn hiện trong feed công khai không được trả.
- Các chỉ số tương tác có thể null hoặc khác giao diện do thời điểm cập nhật Facebook.
- Kết quả chỉ gồm các trường được mô tả trong schema API.
Từ khóa tìm kiếm tiếng Việt
- lấy chi tiết bài viết nhóm Facebook
- xem nội dung bài group Facebook
- tra cứu post ID nhóm Facebook
- API chi tiết bài viết nhóm
English search terms
- get Facebook group post details
- Facebook group post ID lookup
- view Facebook group post
- Facebook group post details API
Hướng Dẫn Sử Dụng & Tài Liệu API
Bạn có thể sử dụng trực tiếp trên giao diện Tool.vn hoặc gọi API từ website, ứng dụng, CRM và quy trình tự động hóa. Cả hai cách đều chỉ hỗ trợ nhóm công khai và dùng cùng một cấu trúc kết quả.
Các bước sử dụng giao diện web
- Nhập group ID công khai.
- Nhập post ID, ID ghép hoặc URL bài trong nhóm.
- Bấm thực hiện; một lần lấy chi tiết thành công có giá 30 credit.
- Kiểm tra post_verified_in_group trước khi dùng object post trong tích hợp.
Cách tính credit
Mỗi gói tối đa 1 bài viết chi tiết thực trả có giá 30 credit. Chi phí được làm tròn theo gói: từ 1 đến 1 bản ghi là 30 credit; từ 2 đến 2 bản ghi là 60 credit.
Một yêu cầu hợp lệ nhưng không lấy được kết quả sẽ giữ 1 credit phí xử lý chống spam. Lỗi tham số được phát hiện trước khi xử lý hoặc không đủ số dư để giữ trước không bị tính phí.
Tài Liệu API Cho Nhà Phát Triển
group_id và post_id/post_url là bắt buộc. Success trả object post top-level cùng post_verified_in_group=true; không có danh sách phân trang.
Endpoint chính thức: https://tool.vn/api/facebook/get-group-post. 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.
| 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. |
Ví dụ cURL JSON
curl -X POST 'https://tool.vn/api/facebook/get-group-post' \
-H 'Authorization: Bearer TOOLVN-V1-YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{"group_id":"123450000000001","post_id":"1234567890123456"}'
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": 1,
"credits_precharged": 600,
"credits_charged": 30,
"credits_refunded": 570,
"post_id": "1234567890123456",
"post_verified_in_group": true,
"fetched_count": 1,
"post": {
"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
| 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. |
post_verified_in_group | Luôn true khi thành công, xác nhận bài viết thuộc đúng group ID đã gửi. |
credit_unit_cost, records_per_credit_unit | Giá một gói và số bản ghi tối đa trong một gói. |
credits_precharged, credits_charged, credits_refunded | Số credit giữ trước, chi phí thực tế theo số bản ghi sạch và phần hoàn. |
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 | Còn dữ liệu công khai có thể lấy tiếp hay không và phiên quét có dừng trước target vì giới hạn/credit hay không. |
Schema post
| Trường bản ghi | Mô tả |
|---|---|
post_id/legacy_post_id/group_id/facebook_type | Định danh bài viết, nhóm và loại object Facebook |
author/collaborators/tagged_profiles | Các identity công khai liên quan đến bài viết |
message/title/display_title/subtitle/post_message | Nội dung chính và các phần tiêu đề có cấu trúc |
message_details.text/message_details.ranges[] | Text cùng offset, length và entity công khai được nhắc đến |
message_richtext.text/message_richtext.blocks[] | Rich text gồm block_type, text, depth, inline_styles và entity_ranges |
created_time/updated_time/latest_activity_time | Các mốc Unix timestamp |
permalink_url/group_context/privacy/place | Liên kết và ngữ cảnh công khai của bài |
attachments[].media/target/subattachments/attachment_urls/action_links | Media chi tiết, ảnh nhiều cỡ, URL video/caption, trạng thái phát, link preview, cây đính kèm và liên kết hành động |
feedback | Định danh feedback, tổng tương tác, top/supported reactions, cấu hình hiển thị và trạng thái bình luận |
feedback.seen_by_count/feedback.seen_by_everyone | Số lượt đã xem và cờ mọi người đã xem khi có, giữ nguyên cả 0 và false |
reaction_count/comment_count/share_count | Các tổng tương tác ở top-level |
interaction_capabilities | Toàn bộ cờ like/react/comment/share, bình luận riêng tư, ẩn danh hoặc kèm file/GIF/nhạc/ảnh/stars/sticker/video, subscribe, append photos, reshare lên feed/story/kênh phát, trạng thái số bình luận, composer và feedback actions |
can_like/can_react/can_comment/can_share/comments_enabled/comments_disabled | Các cờ thường dùng ở top-level, giữ nguyên cả true và false |
comment_previews[] | Bình luận công khai tiêu biểu gồm tác giả, nội dung, thời gian, privacy, reaction/reply, cờ trạng thái và attachments |
translation/ai_transparency/music/content_metadata/attached_story | Dữ liệu nội dung bổ sung khi có |
content_metadata.has_text_in_top_region | Cờ media có text ở vùng phía trên, giữ nguyên giá trị false |
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á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.
Câu hỏi thường gặp
Không. Tool.vn chỉ hỗ trợ nhóm công khai và từ chối 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.
Mỗi gói tối đa 1 bài viết chi tiết có giá 30 credit. Công cụ quét tất cả dùng ngân sách credit do bạn đặt và hoàn phần giữ trước chưa sử dụng.
API chỉ trả các trường kết quả được mô tả trong phần schema của từng công cụ và không cung cấp dữ liệu riêng tư của nhóm.
Facebook có thể giới hạn dữ liệu công khai, feed có thể kết thúc hoặc phiên quét đã chạm ngân sách credit. Response ghi fetched_count, partial và has_more_available_from_fb khi phù hợp.
Không. group_id là ràng buộc bắt buộc để chứng minh bài thuộc đúng nhóm công khai trước khi trả dữ liệu.
Không nhất thiết. Nó nghĩa là phiên truy vấn không chứng minh được bài thuộc đúng nhóm công khai đã khai báo.