Facebook Group ToolAPI v1.0.0
Tìm Bài Viết Trong Nhóm Facebook
Tìm bài viết theo từ khóa trong một nhóm Facebook công khai và chỉ giữ kết quả có bằng chứng thuộc đúng group ID.
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ụ
Công cụ tìm bài theo cụm từ Unicode bên trong phạm vi một nhóm công khai. Nó phù hợp khi bạn biết chủ đề, tên sản phẩm, mã đơn, địa điểm hoặc câu chữ cần tìm nhưng không biết post ID.
Facebook có thể hiển thị nhiều loại kết quả khác nhau. Tool.vn chỉ giữ bài viết thuộc đúng nhóm đã nhập để danh sách dễ sử dụng và hạn chế kết quả ngoài phạm vi.
Tính năng và lợi ích chính
- Tìm kiếm theo từ khóa: Hỗ trợ Unicode và chuỗi dài tối đa 200 ký tự.
- Giới hạn đúng nhóm: Chỉ trả bài viết được xác nhận thuộc group ID đã nhập.
- Ba cách sắp xếp: Hỗ trợ phù hợp nhất, bài mới nhất và hoạt động mới nhất.
- Giá thống nhất với bài viết: Mỗi gói tối đa 3 bài tìm thấy có giá 30 credit.
Trường hợp sử dụng phù hợp
- Tìm bài hỗ trợ khách hàng theo mã sản phẩm hoặc vấn đề.
- Phát hiện thảo luận có tên thương hiệu, địa điểm hoặc chiến dịch.
- Tra lại thông báo cũ khi không có post ID.
- Xây dựng ô tìm kiếm nhóm công khai trong ứng dụng nội bộ.
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.
- Phiên bản hiện tại chỉ hỗ trợ trang kết quả tìm kiếm đầu tiên và báo pagination_supported=false.
- Facebook quyết định chỉ mục và ranking nên không bảo đảm tìm thấy mọi bài chứa từ khóa.
- Kết quả không có bằng chứng thuộc nhóm bị loại dù nội dung có vẻ phù hợp.
Từ khóa tìm kiếm tiếng Việt
- tìm bài viết trong nhóm Facebook
- tìm nội dung group Facebook
- tìm bài nhóm theo từ khóa
- API tìm kiếm nhóm Facebook
English search terms
- search Facebook group posts
- find posts in Facebook group
- Facebook group content search
- Facebook group search 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 và từ khóa cụ thể.
- Chọn phù hợp nhất, mới nhất hoặc hoạt động mới nhất.
- Chọn số kết quả; mỗi 3 bài thực trả là một gói 30 credit.
- Dùng post_id/permalink_url từ kết quả để mở bài hoặc gọi công cụ chi tiết.
Cách tính credit
Mỗi gói tối đa 3 bài viết tìm thấy thực trả có giá 30 credit. Chi phí được làm tròn theo gói: từ 1 đến 3 bản ghi là 30 credit; từ 4 đến 6 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
query là bắt buộc; mode nhận relevant, newest hoặc recent_activity. Phiên bản hiện tại trả một trang kết quả đã xác minh thuộc đúng nhóm.
Endpoint chính thức: https://tool.vn/api/facebook/search-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.
| 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. Giá được tính theo mỗi gói tối đa 3 bài viết tìm thấy. |
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","query":"từ khóa cần tìm","mode":"relevant","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,
"query": "từ khóa cần tìm",
"requested_mode": "relevant",
"effective_mode": "relevant",
"requested_limit": 3,
"fetched_count": 1,
"has_more_available_from_fb": 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
| 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. |
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). |
requested_mode, effective_mode, fallback_used | Chế độ client yêu cầu, chế độ thực tế tạo danh sách và cờ cho biết chế độ phù hợp nhất có chuyển sang hoạt động gần đây hay không. |
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 posts
| 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 | Tác giả, cộng tác viên và hồ sơ được gắn thẻ ở dạng identity công khai |
message/title/display_title/subtitle/post_message | Nội dung chính, tiêu đề hiển thị, phụ đề và phần tiêu đề/nội dung có cấu trúc |
message_details.text/message_details.ranges[] | Nội dung text cùng offset, length, cờ địa điểm và entity công khai trong từng vùng đượ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/backdated_time/scheduled_publish_time | Các mốc Unix timestamp của bài viết |
permalink_url/group_context/privacy/place | Liên kết bài, ngữ cảnh nhóm, phạm vi hiển thị và địa điểm công khai kèm ảnh hoặc tọa độ khi có |
topics/hashtags | Chủ đề và hashtag công khai của bài viết |
attachments[].type/url/title/subtitle/description/source/thumbnail/target/subattachments | Ảnh, video, liên kết xem trước và cây nội dung đính kèm tối đa ba cấp |
attachments[].media | ID/loại media, kích thước, alt text, ảnh nhiều cỡ, URL video, caption, thời lượng, lượt phát, trạng thái live/playable và khả năng chia sẻ/tải xuống |
attachment_urls/action_links | Danh sách URL media và liên kết hành động công khai của bài viết |
feedback | feedback_id, legacy_post_id, target_type, tổng reaction/like/comment/share, top_reactions, supported_reactions, chiến lược hiển thị, trạng thái bình luận và capabilities |
feedback.seen_by_count/feedback.seen_by_everyone | Số lượt đã xem và cờ mọi người đã xem khi Facebook công khai hai giá trị này; giữ nguyên cả 0 và false |
reaction_count/comment_count/share_count | Các tổng tương tác ở top-level để tương thích client hiện có |
interaction_capabilities | can_like, can_react, can_comment, can_comment_in_private, can_comment_anonymously, can_comment_with_file/gif/music/photo/stars/sticker/video, can_subscribe, can_append_photos, can_reshare_to_feed/story, can_share_to_broadcast_channel, can_share, comments_enabled, comment_count_visible, inline_comment_composer_hidden và feedback_actions_visible |
can_like/can_react/can_comment/can_share/comments_enabled/comments_disabled | Các cờ tương tác thường dùng ở top-level; giá trị false là dữ liệu hợp lệ và được giữ nguyên |
comment_previews[] | Tối đa ba bình luận công khai gồm comment_id, author, message/message_details, thời gian, privacy, tổng reaction/reply, cờ top/featured/anonymous và attachments |
translation/ai_transparency/music/content_metadata/attached_story | Dữ liệu nội dung bổ sung khi Facebook trả về |
content_metadata.has_text_in_top_region | Cho biết media có text ở vùng phía trên; false là giá trị hợp lệ |
is_pinned/is_group_announcement/is_anonymous | Các cờ trạng thái bài viết |
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 3 bài viết tìm thấy 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.
Chưa. Phiên bản hiện tại trả trang kết quả đầu tiên và API báo pagination_supported=false.
Một số kết quả có thể là hồ sơ, nội dung quảng bá hoặc bài ngoài phạm vi nhóm đã nhập nên không được đưa vào danh sách.