Profile và Page
ID, tên, username, danh mục, trạng thái xác minh, số người theo dõi và thông tin công khai khác khi có.
Chuyển link Facebook đầy đủ, liên kết thiếu giao thức, link chia sẻ hoặc link rút gọn thành ID chính xác; đồng thời nhận diện loại đối tượng và hiển thị dữ liệu công khai liên quan.
Dán một liên kết Facebook để bắt đầu.
Một kết quả duy nhất, được tổ chức theo ngữ cảnh của từng loại liên kết.
Công cụ không chỉ lấy ID dạng số. Kết quả còn phân biệt Profile, Page, Group, Post, Video, Reel hoặc ảnh; hiển thị link đã chuẩn hóa, trạng thái khả dụng, thông tin nội dung, tương tác và media khi Facebook cung cấp công khai.
ID, trạng thái, nội dung, tương tác và media được tách thành từng khu vực để dễ kiểm tra.
Mỗi loại liên kết có một bộ trường phù hợp, tránh trộn dữ liệu không liên quan.
ID, tên, username, danh mục, trạng thái xác minh, số người theo dõi và thông tin công khai khác khi có.
ID nhóm, tên, quyền riêng tư, khả năng hiển thị, trạng thái khả dụng và số thành viên công khai.
ID bài viết, tác giả, nội dung, thời gian, quyền riêng tư, trạng thái xuất bản và dữ liệu tương tác.
ID video, chủ sở hữu, tiêu đề, mô tả, thumbnail, thời lượng, lượt phát, lượt xem và trạng thái live.
ID ảnh, chú thích, chủ sở hữu, kích thước và liên kết media công khai có thể mở riêng.
Phân biệt link đầu vào, URL đã chuẩn hóa, đích đã phân giải và URL chính thức của đối tượng.
Ba bước ngắn để lấy ID và đọc đúng dữ liệu theo loại liên kết.
Dùng URL đầy đủ, chuỗi thiếu https://, link chia sẻ hoặc link rút gọn. Không cần tự sửa URL trước.
Nhấn nút xử lý một lần. Công cụ chuẩn hóa liên kết, xác định đích và nhận diện loại đối tượng.
Sao chép ID, mở link chính thức hoặc xem Tổng quan, Nội dung, Tương tác, Media và JSON.
API nhận POST, xác thực bằng Bearer API key và hỗ trợ body JSON hoặc form URL-encoded.
https://tool.vn/api/facebook/get-id-from-link
Authorization: Bearer YOUR_API_KEYlink là URL hoặc chuỗi liên kết Facebook cần nhận diện.application/json hoặc application/x-www-form-urlencoded.curl -X POST "https://tool.vn/api/facebook/get-id-from-link" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"link":"https://www.facebook.com/reel/1064490729870764/"}'curl -X POST "https://tool.vn/api/facebook/get-id-from-link" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/x-www-form-urlencoded" \ --data-urlencode "link=https://www.facebook.com/share/v/1Bei6Y8yLQ/"
curl -X POST "https://tool.vn/api/facebook/get-id-from-link" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"link":"https://www.facebook.com/photo/?fbid=1736026351651379"}'const response = await fetch('https://tool.vn/api/facebook/get-id-from-link', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ link: 'https://fb.watch/example' })
});
const result = await response.json();{
"status": "success",
"message": "Lấy ID và thông tin liên kết Facebook thành công.",
"version": "v2.4.0",
"request_id": "FBI-0123456789ABCDEF",
"credits_precharged": 30,
"credits_charged": 30,
"credits_refunded": 0,
"data": {
"__typename": "Story",
"strong_id__": "123456789012345",
"id": "opaque-id",
"primary_id": "123456789012345",
"object_type": "POST",
"details_restricted": false,
"ids": {
"primary_id": "123456789012345",
"post_id": "123456789012345",
"video_id": "234567890123456",
"video_ids": ["234567890123456"],
"photo_id": "345678901234567",
"photo_ids": ["345678901234567", "456789012345678"],
"owner_id": "100012345678901"
},
"input": {
"original": "https://www.facebook.com/share/r/example",
"normalized_url": "https://www.facebook.com/share/r/example",
"link_format": "short_reel",
"resolved_link_format": "post",
"is_short_link": true,
"was_redirect_wrapper": false
},
"resolved_url": "https://www.facebook.com/story.php?story_fbid=123456789012345&id=100012345678901",
"canonical_url": "https://www.facebook.com/story.php?story_fbid=123456789012345&id=100012345678901",
"status": {
"availability": "AVAILABLE",
"privacy": "PUBLIC",
"is_published": true,
"is_deleted": false,
"content_visible": true
},
"capabilities": {
"can_like": true,
"can_comment": false,
"can_comment_with_file": false,
"can_comment_with_stars": true,
"can_comment_with_music": false,
"can_share": true,
"comments_enabled": false
},
"engagement": {
"reaction_count": 125,
"comment_count": 18,
"share_count": 7
},
"summary": {
"title": "Tiêu đề bài viết",
"message": "Nội dung bài viết công khai",
"created_time": 1786435200,
"thumbnail_url": "https://scontent.example/image.jpg"
},
"author": {
"id": "100012345678901",
"name": "Tác giả công khai",
"type": "User",
"profile_url": "https://www.facebook.com/100012345678901"
},
"media_items": [
{
"type": "PHOTO",
"id": "345678901234567",
"url": "https://scontent.example/photo-1.jpg",
"width": 1440,
"height": 1080
},
{
"type": "PHOTO",
"id": "456789012345678",
"url": "https://scontent.example/photo-2.jpg",
"width": 1080,
"height": 1440
},
{
"type": "VIDEO",
"id": "234567890123456",
"url": "https://video.example/video.mp4",
"thumbnail_url": "https://scontent.example/video-poster.jpg",
"width": 1080,
"height": 1920,
"duration_ms": 48000
}
],
"details": {
"story": {
"post_id": "123456789012345",
"message": {"text": "Nội dung bài viết công khai minh họa."},
"attachments": {"count": 3}
},
"video": {
"id": "234567890123456",
"video_container_type": "CONTAINED_POST_ATTACHMENT"
},
"link_target": {
"__typename": "Story",
"strong_id__": "123456789012345"
}
},
"details_complete": true,
"detail_sections": ["story", "video", "link_target"]
}
}
Link Reel trực tiếp giữ chính ID video làm ID chính và trả một media VIDEO tương ứng:
{
"object_type": "REEL",
"primary_id": "1064490729870764",
"ids": {
"primary_id": "1064490729870764",
"video_id": "1064490729870764",
"video_ids": ["1064490729870764"],
"owner_id": "100075931041478"
},
"input": {
"original": "https://www.facebook.com/reel/1064490729870764/",
"normalized_url": "https://www.facebook.com/reel/1064490729870764/",
"link_format": "reel",
"resolved_link_format": "reel",
"is_short_link": false
},
"canonical_url": "https://www.facebook.com/reel/1064490729870764/",
"summary": {
"message": "Nội dung Reel công khai",
"thumbnail_url": "https://scontent.example/reel-poster.jpg",
"duration_ms": 36666
},
"media_items": [
{
"type": "VIDEO",
"id": "1064490729870764",
"url": "https://video.example/reel.mp4",
"thumbnail_url": "https://scontent.example/reel-poster.jpg",
"duration_ms": 36666
}
],
"status": {
"availability": "AVAILABLE",
"is_live": false
},
"capabilities": {
"can_like": true,
"can_comment": true,
"can_share": true,
"can_download_media": false
},
"engagement": {
"reaction_count": 53,
"comment_count": 0,
"play_count": 192
},
"details_complete": true,
"detail_sections": ["video", "video_preview", "video_feed_context", "link_target"]
}
Với https://www.facebook.com/share/v/1Bei6Y8yLQ/, hệ thống giữ link nhập ban đầu nhưng trả đối tượng đích đã xác minh:
{
"object_type": "REEL",
"primary_id": "4356795967916748",
"ids": {
"primary_id": "4356795967916748",
"video_id": "4356795967916748",
"video_ids": ["4356795967916748"]
},
"input": {
"original": "https://www.facebook.com/share/v/1Bei6Y8yLQ/",
"link_format": "short_video",
"resolved_link_format": "reel",
"is_short_link": true
},
"canonical_url": "https://www.facebook.com/reel/4356795967916748/",
"summary": {
"duration_ms": 145542
},
"media_items": [
{
"type": "VIDEO",
"id": "4356795967916748",
"duration_ms": 145542
}
],
"details_complete": true
}
Các URL phát video và ảnh xem trước do Facebook cấp có thể hết hạn; primary_id, ids.video_id và canonical_url là các trường ổn định để lưu hoặc đối chiếu.
Ảnh được nhập vẫn là đối tượng chính. ID bài viết cha và album chỉ là ngữ cảnh đã xác minh; hệ thống không tự suy diễn ID ảnh anh em khi Facebook chưa trả đủ ID và URL.
{
"object_type": "PHOTO",
"primary_id": "1736026351651379",
"ids": {
"primary_id": "1736026351651379",
"photo_id": "1736026351651379",
"photo_ids": ["1736026351651379"],
"post_id": "1736028101651204",
"album_id": "1736028048317876"
},
"input": {
"original": "https://www.facebook.com/photo/?fbid=1736026351651379",
"normalized_url": "https://www.facebook.com/photo/?fbid=1736026351651379",
"link_format": "photo",
"resolved_link_format": "photo",
"is_short_link": false
},
"canonical_url": "https://www.facebook.com/photo.php?fbid=1736026351651379&set=a.1736028048317876&type=3",
"summary": {
"created_time": 1786435200,
"thumbnail_url": "https://scontent.example/photo-original.jpg"
},
"media_items": [
{
"type": "PHOTO",
"id": "1736026351651379",
"url": "https://scontent.example/photo-original.jpg",
"width": 1080,
"height": 1080,
"selected": true,
"variant_count": 4,
"accessibility_caption": "Mô tả công khai của ảnh"
}
],
"media_variants": [
{"variant": "original", "url": "https://scontent.example/photo-original.jpg", "width": 1080, "height": 1080},
{"variant": "medium", "url": "https://scontent.example/photo-medium.jpg", "width": 540, "height": 540}
],
"status": {"availability": "AVAILABLE", "privacy": {"label": "Công khai"}},
"engagement": {"reaction_count": 24174, "like_count": 42, "comment_count": 16, "share_count": 179},
"capabilities": {
"can_like": true,
"can_comment": true,
"can_comment_with_photo": true,
"can_comment_with_video": true,
"can_add_tags": true,
"can_search_photo": false,
"can_share": true,
"can_share_externally": true,
"can_download_media": true
},
"details": {
"photo": {
"id": "1736026351651379",
"album": {"id": "1736028048317876", "album_type": "NORMAL"},
"container_story": {"legacy_api_story_id": "owner_1736028101651204", "attachment_preview_count": 4},
"privacy_scope": {"label": "Công khai"}
}
},
"details_restricted": false,
"details_complete": true,
"detail_sections": ["photo", "link_target"]
}
Các URL CDN có thể hết hạn. ids.photo_id là ảnh từ liên kết; ids.post_id và ids.album_id không thay thế ID chính. media_variants chỉ mô tả các độ phân giải của ảnh đích; media_items chỉ thêm media khác khi Facebook cung cấp đủ ID và URL đã xác minh.
{
"status": "error",
"message": "Không thể xử lý liên kết Facebook lúc này. Vui lòng thử lại sau.",
"version": "v2.4.0",
"request_id": "FBI-0123456789ABCDEF",
"error_code": "FACEBOOK_LINK_REQUEST_FAILED",
"credits_precharged": 30,
"credits_charged": 1,
"credits_refunded": 29
}
| Nhóm trường | Nội dung |
|---|---|
credits_precharged, credits_charged, credits_refunded | Số credit đã giữ, đã tính và đã hoàn thực tế của yêu cầu. Phản hồi thành công tính 30 credit; yêu cầu hợp lệ đã bắt đầu xử lý Facebook nhưng không có kết quả tính 1 credit. Lỗi phương thức, dữ liệu đầu vào, xác thực hoặc số dư trước khi giữ credit có giá 0; nếu hoàn credit chưa được ghi nhận, các trường phản ánh đúng số đã giao dịch. |
ids | ID chính, ID mã hóa và các ID theo loại. Với PHOTO, photo_id luôn là ảnh từ liên kết; post_id và album_id chỉ là ngữ cảnh cha đã được chứng minh. photo_ids không chứa ID ảnh anh em nếu Facebook chưa trả đủ bằng chứng. |
input | Link đầu vào, URL đã chuẩn hóa, định dạng link ban đầu, định dạng đích và trạng thái link rút gọn hoặc chuyển tiếp. |
summary | Tên, tiêu đề, nội dung, thời gian tạo, thời gian cập nhật, thumbnail và thời lượng đã được rút gọn để hiển thị nhanh. |
media_variants | Với kết quả PHOTO, danh sách ảnh gốc, chất lượng cao, vừa, thấp và thumbnail theo thứ tự ưu tiên; mỗi phần tử có variant, url, width và height khi Facebook cung cấp. |
media_items | Danh sách media công khai đã chuẩn hóa. PHOTO luôn có một phần tử đích với selected=true, variant_count và mô tả accessibility khi có; media anh em chỉ xuất hiện khi Facebook trả đủ ID và URL đã xác minh. Video/Reel có thêm thumbnail và thời lượng. |
status | Khả dụng, quyền riêng tư, khả năng hiển thị, trạng thái xuất bản, ẩn, xóa, live, ghim và khả năng xem nội dung. |
capabilities | Khả năng thích, phản hồi, bình luận bằng GIF, ảnh, nhãn dán, video, tệp, Stars hoặc nhạc, chia sẻ, chia sẻ ra ngoài Facebook, đăng ký theo dõi, thêm ảnh, gắn thẻ, tìm kiếm ảnh, gợi ý vị trí ảnh, tải media và các trạng thái giao diện tương tác. |
engagement | Số lượt cảm xúc, thích, bình luận, chia sẻ, phát và xem khi dữ liệu công khai có sẵn. |
author | Thông tin tác giả hoặc chủ sở hữu công khai phù hợp với đối tượng. |
details | Dữ liệu công khai chi tiết theo loại đối tượng, có thể gồm link_target, group, story, photo, video hoặc video_preview. details.photo có thể chứa chú thích, chủ sở hữu, album, quyền riêng tư, thời gian tạo, nội dung thay thế, tiêu điểm, các ảnh với kích thước và dữ liệu tương tác công khai. |
details_restricted | Giá trị true cho biết đối tượng giới hạn thông tin chi tiết; ID và trạng thái cơ bản vẫn là kết quả hợp lệ. |
details_complete, detail_sections | Cho biết dữ liệu chi tiết đã hoàn tất và liệt kê các phần dữ liệu công khai có trong kết quả. |
Lưu ý: Giá trị boolean false là kết quả hợp lệ, thể hiện tính năng hoặc trạng thái đang tắt; không đồng nghĩa trường dữ liệu bị thiếu.
Phân loại link share: object_type và primary_id luôn theo đối tượng gốc sau khi phân giải. Link share/v dẫn tới Reel trả REEL với ID video làm ID chính; ảnh hoặc video nằm trong bài viết vẫn được giữ trong media_items và các danh sách ID bổ sung mà không thay thế loại POST.
| HTTP | Ý nghĩa | Cách xử lý |
|---|---|---|
200 | Thành công | Đọc dữ liệu trong trường data. |
400 | Thiếu hoặc sai tham số | Kiểm tra body và tham số link. |
401 | Xác thực thất bại | Kiểm tra header Bearer và trạng thái API key. |
402 | Không đủ credit | Nạp thêm credit rồi gửi lại yêu cầu. |
422 | Không nhận diện được link | Kiểm tra link Facebook hoặc quyền truy cập công khai của đối tượng. |
429 | Quá nhiều yêu cầu | Giảm tần suất và thử lại sau. |
503 | Dịch vụ tạm thời không sẵn sàng | Chờ một khoảng ngắn rồi thử lại. |
Giải đáp nhanh về link rút gọn, loại đối tượng, dữ liệu tương tác và chi phí.
Lấy bài viết, thành viên, thông tin nhóm, kết quả tìm kiếm, bình luận và lượt chia sẻ công khai. Chi phí được tính theo từng gói kết quả và hiển thị cụ thể tại mỗi công cụ.