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 và tự xác định mức giữ trước theo công thức ceil(target_limit / 3) × 30 credit. Client tạo job một lần, kiểm tra trạng thái bằng job_id và tải file JSON/CSV khi hoàn tất; phần giữ trước chưa dùng được hoàn tự động.

Endpoint tạo phiên chính thức: https://tool.vn/api/facebook/start-all-group-posts-job. 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.

Tạo và theo dõi phiên quét nền

curl -X POST 'https://tool.vn/api/facebook/start-all-group-posts-job' \
  -H 'Authorization: Bearer TOOLVN-V1-YOUR_API_KEY' \
  -H 'Idempotency-Key: group-export-20260809-001' \
  -H 'Content-Type: application/json' \
  --data '{"group_id":"123450000000001","mode":"newest","target_limit":30}'

curl -X POST 'https://tool.vn/api/facebook/get-all-group-posts-job-status' \
  -H 'Authorization: Bearer TOOLVN-V1-YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{"job_id":"fbgj_0123456789abcdef0123456789abcdef01234567"}'

Mỗi response status có thể kèm retry_after_seconds; chờ khoảng thời gian đó trước lần kiểm tra tiếp theo. Khi result_formats có json hoặc csv, gửi POST tới /api/facebook/download-all-group-posts-job với job_id và format. Response trả download_url ngắn hạn; tải trực tiếp URL đó với cùng tài khoản. Có thể dừng phiên bằng /api/facebook/cancel-all-group-posts-job.

API đồng bộ tương thích

Endpoint cũ /api/facebook/scan-all-group-posts vẫn yêu cầu credit_budget theo bội số 30 và chỉ nên dùng cho yêu cầu nhỏ. Đây là hợp đồng tương thích riêng; workflow job mới tự tính mức giữ trước từ target_limit và không nhận trường này.

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": "Phiên quét đã được tiếp nhận. Dùng job_id để theo dõi tiến độ.",
    "version": "v1.2.0",
    "job_id": "fbgj_0123456789abcdef0123456789abcdef01234567",
    "job_status": "queued",
    "stage": "queued",
    "group_id": "123450000000001",
    "public_group_only": true,
    "requested_mode": "newest",
    "effective_mode": "newest",
    "fallback_used": false,
    "target_limit": 30,
    "effective_record_cap": 30,
    "fetched_count": 0,
    "progress_percent": 0,
    "has_more_available_from_fb": true,
    "partial": false,
    "credit_unit_cost": 30,
    "records_per_credit_unit": 3,
    "credits_precharged": 300,
    "credits_charged": 0,
    "credits_refunded": 0,
    "result_formats": [],
    "preview_posts": [],
    "retry_after_seconds": 10
}

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