Dùng thay akng như thế nào

getdata giữ nguyên hình dạng trả về của akng, nên nơi đang dùng chỉ cần đổi địa chỉ:

Cũ:  https://api.akng.io.vn/graph/v19.0
Mới: https://getdata.cungvedich.vn/graph/v19.0

Chìa khoá giữ nguyên — getdata nhận luôn chìa khoá cũ của akng đến hết 31/10/2026.

Các đường gọi

GET /graph/{phiên bản}/{mã reel}

Đường chính, thay thẳng cho akng. Cần access_token.

Tham số	Bắt buộc	Nghĩa là gì
access_token	Có	Chìa khoá. Truyền qua địa chỉ, y như akng
fields	Không	Xin những trường nào. Bỏ trống là lấy tất cả. Có xin views hay không rất đáng lưu ý: xin thì phải hỏi Facebook hai lần (chậm gấp đôi), không xin thì chỉ một lần
owner_id	Không	Riêng của getdata. Biết trước mã chủ thì hai lượt hỏi Facebook chạy song song, nhanh hơn hẳn
allow_missing_views	Không	Riêng của getdata, chỉ dành cho việc quét bù. Đặt 1 để chấp nhận reel không lấy được lượt xem, các trường khác vẫn giữ nguyên yêu cầu

curl "https://getdata.cungvedich.vn/graph/v19.0/924175540009026?fields=id,views,from,privacy&access_token=CHÌA_KHOÁ"

Trả về:

{
  "success": true,
  "message": "Request successful.",
  "data": {
    "id": "924175540009026",
    "created_time": "2026-08-01T11:49:37+0000",
    "from": { "id": "100091330290184", "name": "Linda Trần" },
    "views": 257,
    "length": 15,
    "privacy":   { "value": "EVERYONE" },
    "likes":     { "data": [], "summary": { "total_count": 5 } },
    "reactions": { "data": [], "summary": { "total_count": 5 } },
    "comments":  { "data": [], "summary": { "total_count": 9 } }
  }
}

GET /api/thu?url=…

Thử nhanh: nhận link reel đủ kiểu (kể cả link chia sẻ /share/r/…) hoặc chỉ mã số, trả kết quả đã dọn sẵn cho người đọc. Đây là đường mà tab "Thử dữ liệu" dùng.

GET /health

Kiểm tra dịch vụ còn sống. Không cần chìa khoá — để máy giám sát gọi được.

GET /stats

Số liệu vận hành. Cần chìa khoá quản trị, hoặc đã đăng nhập vào trang này.

Khi có chuyện thì trả về gì

Nguyên tắc gốc: thà báo lỗi ầm ĩ còn hơn trả về số 0 im lặng. Số 0 là kẻ nói dối nguy hiểm nhất — nó trông giống dữ liệu thật, nó ghi đè được lên số thật, và không có gì báo động. Nên khi thiếu dữ liệu, getdata không bao giờ nói "thành công".

Mã lỗi	Mã HTTP	Nghĩa là gì	Nên làm gì
parse_incomplete	200	Đọc được trang nhưng thiếu trường bắt buộc	Nếu xảy ra hàng loạt thì Facebook vừa đổi cấu trúc trang — báo người kỹ thuật
views_unavailable	200	Không lấy được lượt xem (reel đã rơi khỏi tab video của chủ)	Reel cũ thì bình thường. Quét bù thì thêm allow_missing_views=1
views_wrong_kind	200	Lượt xem không phải loại tổng	Từ chối là đúng — hai loại chênh tới 2,8 lần, lẫn là hỏng hết số liệu lịch sử
fb_unavailable	200	Reel không tồn tại, đã xoá, hoặc không công khai	Thử lại cũng vậy. Đừng thử lại
fb_blocked	429	Facebook đang hãm nhịp đọc	Lùi lại vài phút rồi thử lại
bad_token	401	Chìa khoá sai hoặc hết hạn	Kiểm tra lại chìa khoá

Những điều dễ hiểu nhầm

Chuyện	Thực tế
Hai loại lượt xem	views luôn là loại tổng. Có một loại khác gọi là "lượt xem trên bài", chênh tới 2,8 lần. getdata thà từ chối trả còn hơn trả nhầm loại
Số bình luận	getdata trả tổng thật. akng chỉ đếm được tối đa 5 vì nó lấy 5 bình luận rồi đếm mảng
Lượt thích và cảm xúc	Trang công khai của Facebook không tách hai loại, nên hai con số này bằng nhau
Lượt chia sẻ	Không lấy được. akng cũng không có
Đường dẫn ảnh bìa và video	Facebook cho hết hạn sau vài giờ đến vài tháng. Cần giữ lâu thì phải tải về máy mình

Thử một reel

Dán link reel Facebook (kể cả link chia sẻ dạng /share/r/…) hoặc mã số reel.

Gọi thẳng đường API

Dành cho lúc cần xem đúng thứ mà hệ thống Yody nhận được — trả JSON thô, không dọn dẹp.