Lấy bài viết mới nhất Facebook

Sử Dụng Giao Diện Web

1. Nhập URL hoặc ID Facebook: Dán liên kết trực tiếp đến Page/Profile hoặc nhập ID dạng số.
   • URL theo tên: https://www.facebook.com/TEN_TRANG.
   • URL theo ID: https://www.facebook.com/profile.php?id=FACEBOOK_ID hoặc https://www.facebook.com/people/TEN/ID.
   • ID số: ví dụ 61565985206441; ID cũ ngắn như 4 cũng được chấp nhận.
   • Liên kết chia sẻ được hỗ trợ khi trỏ đến Page/Profile. Không nhận link bài viết, ảnh, video, Reel hoặc Nhóm.
2. Chọn Số Lượng Bài: Nhập số lượng bài viết mới nhất bạn muốn hiển thị (từ 1 đến 20 bài). Chi phí dự kiến sẽ được cập nhật tương ứng.
3. Nhấn "Lấy Bài Viết": Kết quả sẽ hiển thị bên dưới, kèm dữ liệu JSON. Số bài thực nhận có thể ít hơn số yêu cầu nếu dữ liệu khả dụng ít hơn hoặc lượt xử lý dừng sớm.
4. Xem và Sao Chép: Duyệt qua các bài viết. Sử dụng nút để sao chép ID bài viết hoặc toàn bộ dữ liệu JSON.

Lưu ý quan trọng: Nếu bạn cần lấy tất cả hoặc một số lượng lớn bài viết từ một trang cá nhân hoặc Fanpage để phân tích sâu, vui lòng sử dụng Công cụ Quét Toàn Bộ Bài Viết Facebook của chúng tôi. Công cụ đó được thiết kế để xử lý các tác vụ quy mô lớn hơn.

Chi Phí Sử Dụng (Credit)

Việc sử dụng công cụ này sẽ tiêu tốn credit từ tài khoản Tool.vn của bạn. Chi phí được tính như sau, dựa trên số lượng bài viết bạn muốn lấy:

• Nếu bạn yêu cầu lấy từ 1 đến 3 bài viết (bao gồm cả 1 bài, là số lượng tối thiểu): Chi phí sẽ là 30 Credits.
• Nếu bạn yêu cầu lấy nhiều hơn 3 bài viết: Khoản giữ trước là 30 Credits nhân với toàn bộ số bài yêu cầu, không phải chỉ tính các bài vượt quá 3.
• Ví dụ cụ thể:
  • Lấy 1 bài viết: 30 Credits.
  • Lấy 3 bài: 30 Credits. Lấy 4 bài: 120 Credits.
  • Lấy 11 bài viết: 330 Credits.
  • Lấy 20 bài viết (tối đa): 600 Credits.
• Nếu trả ít bài hơn yêu cầu, phí được tính lại theo số bài thực trả và hoàn phần chênh lệch: tối đa 3 bài tính một mức cơ bản; trên 3 bài tính mức cơ bản cho từng bài.
• Đầu vào sai, chưa xác thực hoặc không đủ số dư bị từ chối trước bước giữ credit thì không mất phí. Với lượt xử lý đã bắt đầu nhưng không lấy được bài, mức phí tối thiểu hiện hành là 30 Credits. Yêu cầu chưa thể bắt đầu và được hủy sẽ được hoàn khoản giữ trước.

Endpoint API

POST https://tool.vn/api/facebook/get-post-facebook

Giữ nguyên tham số id: truyền ID số hoặc URL Page/Profile trong cùng trường này. Không cần gọi công cụ lấy ID trước.

Hoặc sử dụng phương thức GET (ít khuyến khích hơn cho việc truyền API key):

GET https://tool.vn/api/facebook/get-post-facebook?key=YOUR_API_KEY&id=FACEBOOK_ID&limit=NUMBER_OF_POSTS

Nếu truyền URL bằng GET, cần URL-encode giá trị id. Nên dùng POST JSON cho liên kết có tham số.

Xác Thực (Authentication)

API yêu cầu xác thực. Vui lòng tham khảo tài liệu API chung của Tool.vn để biết chi tiết về các phương thức xác thực: Header Authorization: Bearer YOUR_API_KEY (khuyên dùng), tham số URL key=YOUR_API_KEY, hoặc Cookie (nếu gọi từ web đã đăng nhập).

Tham Số Yêu Cầu

Gửi JSON hoặc form; nếu cùng một tham số xuất hiện trong JSON và query/form, query/form được ưu tiên. API key dùng trong header hoặc URL như phần xác thực, không đặt trong JSON body.

Ví dụ JSON đầu vào

{
    "id": "https://www.facebook.com/TEN_TRANG",
    "limit": 3
}

{
    "id": "4",
    "limit": 3
}

Phản Hồi (Responses)

Thành Công (HTTP 200 OK)

API trả về JSON với cấu trúc tương tự như khi quét Fanpage, bao gồm thông tin các bài viết.

{
    "status": "success",
    "message": "Lấy thành công X bài viết.",
    "fanpage_id": "PROFILE_OR_PAGE_ID",
    "requested_limit": 3,
    "fetched_count": 1,
    "has_more_available_from_fb": true,
    "posts": [
        {
            "id": "FACEBOOK_STORY_ID",
            "post_id": "ACTUAL_POST_ID_NUMERIC",
            "creation_time": 1700000000,
            "privacy_public": true,
            "is_published": true,
            "can_like": false,
            "reaction_count": 0,
            "message": { "text": "Nội dung bài viết..." },
            "attachments": [
                { "media": { "image": { "uri": "https://example.com/image.jpg" } } }
            ],
            "feedback": {
                "reaction_count": 0,
                "comment_count": 0
            }
        }
    ]
}

Lưu ý: Để giữ tương thích với các kết nối hiện có, các trường posts, fetched_count và thông tin phân trang nằm ở cấp cao nhất của response.

fanpage_id luôn là ID số Page/Profile đã xác minh, kể cả khi đầu vào là URL. requested_limit là số bài yêu cầu; fetched_count là số phần tử thực trả trong posts.

Lượt xử lý có thể kết thúc trước khi đủ limit và vẫn trả phần kết quả đã lấy được. has_more_available_from_fb phản ánh thông tin về trang bài tiếp theo trong dữ liệu Facebook cuối cùng trả về; không phải cam kết đã quét toàn bộ tài khoản. Khi cần nhiều bài hoặc toàn bộ danh sách, dùng công cụ quét tất cả bài viết.

Các trường privacy_public, is_published, can_like, can_comment, comments_enabled và reaction_count được trả khi có dữ liệu tương ứng. Giá trị false và 0 được giữ nguyên; trường chưa có dữ liệu không được tự suy diễn. Ảnh/video trong attachments có thể có trạng thái và tương tác riêng. Để phân tích trực tiếp URL bài viết, ảnh hoặc video, dùng Tool Get ID FB.

Các Trường Hợp Lỗi

API sử dụng các mã trạng thái HTTP tiêu chuẩn:

• 400 Bad Request: Tham số id thiếu/sai, limit không hợp lệ.
• 401 Unauthorized: API Key không hợp lệ/thiếu.
• 402 Payment Required: Không đủ credit.
• 422 Unprocessable Entity: Chưa xác minh được Page/Profile phù hợp hoặc đối tượng không được hỗ trợ.
• 404 Not Found: Không tìm thấy bài viết nào cho ID này (có thể do ID sai, không có bài viết công khai, hoặc lỗi từ Facebook).
• 429 Too Many Requests: Đọc message để phân biệt giới hạn yêu cầu và trường hợp Facebook tạm giới hạn phía máy chủ.
• 504 Gateway Timeout: Lượt xử lý hết thời gian cho phép; có thể thử lại sau hoặc yêu cầu ít bài hơn.
• 500 Internal Server Error / 502 Bad Gateway / 503 Service Unavailable: Lỗi từ phía máy chủ Tool.vn hoặc Facebook.

{
    "status": "error",
    "message": "Mô tả lỗi cụ thể...",
    "fetched_count": 0,
    "data": []
}

Ví Dụ Code Tích Hợp API Đa Ngôn Ngữ

Thay YOUR_API_KEY và URL mẫu bằng dữ liệu của bạn. Trường id có thể nhận URL Page/Profile hoặc chuỗi ID số như 4; các ví dụ yêu cầu 3 bài.

• PHP (cURL)
• Node.js (axios)
• Python (requests)

<?php

$apiKey = 'YOUR_API_KEY';
$facebookId = 'https://www.facebook.com/TEN_TRANG'; // Hoặc ID dạng chuỗi: '4'
$limit = 3;

$apiUrl = 'https://tool.vn/api/facebook/get-post-facebook';

$postData = json_encode([
    'id' => $facebookId,
    'limit' => $limit
]);

$ch = curl_init($apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "HTTP Status Code: " . $httpCode . "\n";
$responseData = json_decode($response, true);

if ($httpCode === 200 && isset($responseData['status']) && $responseData['status'] === 'success') {
    echo "Message: " . ($responseData['message'] ?? 'Success') . "\n";
    if(isset($responseData['posts'])) {
        echo "Posts Retrieved: " . count($responseData['posts']) . "\n";
        // print_r($responseData['posts']); // In ra toàn bộ dữ liệu bài viết
    }
} else {
    echo "Error: " . ($responseData['message'] ?? 'Unknown error') . "\n";
}
?>

const axios = require('axios');

const apiKey = 'YOUR_API_KEY';
const facebookId = 'https://www.facebook.com/TEN_TRANG'; // Hoặc '4'
const limit = 3;
const apiUrl = 'https://tool.vn/api/facebook/get-post-facebook';

const data = { id: facebookId, limit: limit };
const config = { headers: { 
    'Authorization': `Bearer ${apiKey}`, 
    'Content-Type': 'application/json' 
}};

axios.post(apiUrl, data, config)
    .then(response => {
        console.log('Status:', response.status);
        console.log('Data:', JSON.stringify(response.data, null, 2));
    })
    .catch(error => {
        if (error.response) {
            console.error('Error Status:', error.response.status);
            console.error('Error Data:', error.response.data);
        } else { console.error('Error:', error.message); }
    });

import requests
import json

api_key = "YOUR_API_KEY"
facebook_id = "https://www.facebook.com/TEN_TRANG"  # Hoặc "4"
limit = 3
api_url = "https://tool.vn/api/facebook/get-post-facebook"

headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {"id": facebook_id, "limit": limit}

try:
    response = requests.post(api_url, headers=headers, json=payload)
    response.raise_for_status() # Lỗi nếu status code là 4xx/5xx
    print(f"Status Code: {response.status_code}")
    print(json.dumps(response.json(), indent=4, ensure_ascii=False))
except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error: {http_err}")
    print(f"Content: {response.text}")
except Exception as err:
    print(f"Other error: {err}")