Dán URL sản phẩm TikTok (link vt.tiktok.com hoặc link SP) → nhận product_id, giá, shop và hoa hồng affiliate. Có cache database 24 giờ, tự lưu lịch sử giá & hoa hồng theo ngày — cùng format như Sàn Cam / Sàn Xanh Product Data API.
Biết ngay SP có affiliate không, hoa hồng ước tính (VNĐ) và tỷ lệ % — parse thẳng từ TikTok.
⚡
Cache DB 24 giờ
Trả từ database khi còn hạn (dataSource: "db") — nhanh và đỡ gọi TikTok, tránh acc bị khoá.
📈
Lịch sử theo ngày
Tự lưu giá & hoa hồng (1 dòng/SP/ngày) để phân tích biến động về sau.
🔗
Nhiều link 1 lần
Gửi tối đa 20 URL qua urls= — trả về products[] theo đúng thứ tự.
Thử ngay trên trình duyệt
Dán 1 URL sản phẩm TikTok (hỗ trợ CORS nên gọi thẳng từ trang này). Chỉ SP có hoa hồng affiliate mới trả về đầy đủ thông tin.
Mở SP trên app TikTok → nút Chia sẻ → Copy link (dạng vt.tiktok.com/...), hoặc copy URL SP trên web (kể cả shop.tiktok.com/vn/pdp/<id>). Dán mỗi product_id (vd 1731526420256557022) cũng được — tự dựng thành link SP. Thêm ?clear_cache=1 để bỏ cache.
Tuyên bố pháp lý: Tài liệu và API ở trang này chỉ dành cho học tập, nghiên cứu kỹ thuật và vận hành nội bộ phi thương mại. Nguồn là API không chính thống (gọi bằng cookie creator TikTok) nên dữ liệu có thể sai số / chậm cập nhật / thay đổi bất kỳ lúc nào. Người dùng tự đánh giá rủi ro và tự chịu trách nhiệm.
Tham số
Tham số
Bắt buộc
Mô tả
url
Một trong 3
1 URL sản phẩm TikTok / link vt.tiktok.com / link shop.tiktok.com/vn/pdp/<id>. Có thể truyền thẳng product_id dạng số. Link có chứa id (kể cả dạng /pdp/) được server tự chuẩn hoá về tiktok.com/view/product/<id> rồi mới gọi API.
urls
Một trong 3
Nhiều URL (hoặc product_id), phân tách bằng dấu phẩy hoặc xuống dòng (tối đa 20) → trả products[].
product_id
Một trong 3
Chỉ tra cache DB, không gọi API. Muốn gọi API cho id chưa có trong cache thì đưa id đó vào url=.
clear_cache
Tùy chọn
clear_cache=1 → bỏ qua cache DB, luôn gọi TikTok API.
cacheTtlHours
Tùy chọn
Thời hạn cache DB (giờ). Mặc định 24.
Ví dụ request
GET https://data.addlivetag.com/tiktok/product.php?url=https://vt.tiktok.com/XXXXXXXX/
# Chỉ có product_id — đưa thẳng vào url= (server tự dựng link SP rồi gọi API)
GET https://data.addlivetag.com/tiktok/product.php?url=1731526420256557022
# Nhiều sản phẩm
GET https://data.addlivetag.com/tiktok/product.php?urls=https://vt.tiktok.com/AAA/,https://vt.tiktok.com/BBB/
# Bỏ cache, gọi API mới
GET https://data.addlivetag.com/tiktok/product.php?url=https://vt.tiktok.com/XXXXXXXX/&clear_cache=1
Ví dụ response (SP có hoa hồng)
Truyền 1 URL → trả productInfo (object đơn, giống Sàn Cam); truyền nhiều URL → trả products[] theo thứ tự.
Nếu SP không thuộc chương trình affiliate (hoặc URL không tìm thấy SP), URL đó được liệt kê trong notFoundUrls:
{
"status": "success",
"count": 0,
"productInfo": null,
"notFoundUrls": ["https://vt.tiktok.com/XXXXXXXX/"],
"warning": "Một số URL không có sản phẩm affiliate hoặc không tìm thấy."
}
Giải thích trường productInfo
Trường
Kiểu
Mô tả
itemId / productId
string
product_id TikTok (chuỗi số).
productName
string
Tên sản phẩm (title).
shopName / storeName
string
Tên shop (store_name).
price
number
Giá parse từ formatPrice (VNĐ).
formatPrice
string
Giá dạng chuỗi gốc, vd 11.850.000₫.
productLink
string
URL đã check (hoặc shop.tiktok.com/view/product/<id>).
stockStatus / addStatus
number
Trạng thái kho / trạng thái đã thêm showcase.
hasCommission
boolean
Có hoa hồng affiliate hay không.
commission
number
Hoa hồng ước tính (VNĐ) — parse từ est_commission_expense.
commissionWithCurrency
string
Hoa hồng dạng chuỗi, vd 118.500₫.
commissionRateRaw
number
Rate raw từ TikTok.
commissionRatePercent
number
commissionRateRaw / 100 = % (vd 100 → 1%).
lastUpdate
string
Thời điểm cập nhật (Asia/Ho_Chi_Minh).
dataSource
string
Nguồn: "api" (mới từ TikTok) / "db" (cache).
Cache & lưu dữ liệu
SP đã có trong cache DB (còn hạn cacheTtlHours) → trả từ cache (dataSource: "db"), không gọi TikTok.