Tìm Nội Dung Trong Nhóm Facebook
Tìm bài viết theo từ khóa bên trong một nhóm Facebook công khai và lọc kết quả đúng group ID.
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ý
Request tìm kiếm giữ nguyên bộ lọc rp_group trong mẫu Facebook v573 và backend kiểm tra lại group ID của từng bài trước khi trả kết quả.
- 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 Tìm bài trong nhóm
Endpoint chính thức: https://tool.vn/api/facebook/search-group-posts. 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. |
query | Có | Từ khóa Unicode, tối đa 200 ký tự. |
mode | Không | relevant, newest, recent_activity. |
limit | Không | Số bản ghi mong muốn, từ 1 đến 100; không phải số request Facebook. |
max_fb_requests | Không | 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/search-group-posts' \
-H 'Authorization: Bearer TOOLVN-V1-YOUR_API_KEY' \
-H 'Content-Type: application/json' \
--data '{"group_id":"123450000000001","max_fb_requests":2,"query":"từ khóa cần tìm","mode":"relevant","limit":20}'
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": 2,
"credit_per_fb_request": 30,
"credits_precharged": 60,
"credits_charged": 60,
"credits_refunded": 0,
"query": "từ khóa cần tìm",
"requested_mode": "relevant",
"effective_mode": "relevant",
"requested_limit": 20,
"fetched_count": 1,
"has_more_available_from_fb": false,
"posts": [
{
"post_id": "1234567890123456",
"group_id": "123450000000001",
"author": {
"id": "100000000000001",
"name": "Tác giả công khai",
"type": "User"
},
"message": "Nội dung bài viết công khai đã được làm sạch.",
"created_time": 1786200000,
"latest_activity_time": 1786200300,
"permalink_url": "https://www.facebook.com/groups/123450000000001/posts/1234567890123456/",
"attachment_urls": [],
"reaction_count": 10,
"comment_count": 2,
"share_count": 1
}
]
}
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 posts
| Trường bản ghi | Mô tả |
|---|---|
post_id/group_id | ID bài viết và nhóm |
author | Tác giả công khai đã chuẩn hóa |
message | Nội dung dạng text |
created_time/latest_activity_time | Các mốc Unix timestamp |
permalink_url | URL chính thức của bài |
attachment_urls | Danh sách URL media đã lọc |
reaction_count/comment_count/share_count | Các tổng tương tác Facebook trả về |
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.