Kiểm tra từ ngữ quảng cáo API
Gắn cờ từ ngữ rủi ro trong quảng cáo, tin bán hàng, kịch bản livestream: "tốt nhất", "số 1", chữa bệnh, so sánh, liên hệ ngoài sàn, kèm căn cứ.
Dán tiêu đề, mô tả sản phẩm, nội dung quảng cáo hay kịch bản livestream, API trả về từng cụm từ rủi ro kèm vị trí, nhóm, mức độ, căn cứ pháp lý và gợi ý viết lại. Các nhóm: từ ngữ tuyệt đối hoá bị cấm khi không có tài liệu chứng minh theo Luật Quảng cáo (16/2012/QH13, Điều 8 khoản 11: "nhất", "duy nhất", "tốt nhất", "số một" và mọi "<từ> nhất" khác), so sánh với sản phẩm của người khác khi không có tài liệu hợp pháp (Điều 8 khoản 10 sửa đổi bởi Luật 75/2025/QH15, hiệu lực 01/01/2026), công dụng chữa bệnh, như thuốc cho thực phẩm, thực phẩm bảo vệ sức khoẻ, mỹ phẩm, cam kết kết quả, giá gây hiểu nhầm, sản phẩm cấm quảng cáo (thuốc lá, thuốc lá điện tử, rượu mạnh, sữa thay thế sữa mẹ cho trẻ dưới 24 tháng), dấu hiệu hàng giả (fake 1:1, rep, like auth) và liên hệ, thanh toán ngoài sàn mà các sàn TMĐT cấm.
Chọn product_type (food, supplement, cosmetic, drug, medical_device, medical_service, milk_infant, alcohol…) để điều chỉnh mức độ và liệt kê giấy tờ luật yêu cầu (phiếu công bố mỹ phẩm, giấy xác nhận quảng cáo thực phẩm bảo vệ sức khoẻ và câu khuyến cáo bắt buộc "Thực phẩm này không phải là thuốc…", được kiểm tra trong văn bản). Không cần gõ dấu (tot nhat vẫn khớp). marketplace=false bỏ qua quy định của sàn; allow loại trừ cụm từ bạn có tài liệu chứng minh.
Danh sách do chúng tôi tự biên soạn từ văn bản pháp luật đang có hiệu lực và chính sách công khai của các nền tảng, mỗi kết quả ghi ngày rà soát. API chỉ cảnh báo rủi ro: cụm từ bị gắn cờ vẫn có thể hợp pháp khi có tài liệu chứng minh, và kết quả sạch không phải là xác nhận pháp lý.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
text | body|query | string | có | Nội dung quảng cáo, tin đăng hoặc kịch bản (tối đa 50.000 ký tự). | |
product_type | body|query | string | không | general | general, food, supplement (TPBVSK), cosmetic (mỹ phẩm), drug, medical_device, medical_service, milk_infant, alcohol, finance. |
marketplace | body|query | boolean | không | true | Áp dụng quy định của sàn (liên hệ, thanh toán ngoài sàn). |
allow | body|query | string | không | Các cụm từ bỏ qua, cách nhau dấu phẩy (bạn có tài liệu chứng minh). |
Ví dụ
curl -X POST "https://apibox.io.vn/v1/vn-ad-check" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Viên uống trắng da số 1 Việt Nam, chữa khỏi nám sau 7 ngày, cam kết hiệu quả. Inbox zalo để có giá rẻ nhất!","product_type":"supplement"}'const res = await fetch('https://apibox.io.vn/v1/vn-ad-check', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"text": "Viên uống trắng da số 1 Việt Nam, chữa khỏi nám sau 7 ngày, cam kết hiệu quả. Inbox zalo để có giá rẻ nhất!",
"product_type": "supplement"
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-ad-check",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"text": "Viên uống trắng da số 1 Việt Nam, chữa khỏi nám sau 7 ngày, cam kết hiệu quả. Inbox zalo để có giá rẻ nhất!", "product_type": "supplement"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-ad-check');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"text":"Viên uống trắng da số 1 Việt Nam, chữa khỏi nám sau 7 ngày, cam kết hiệu quả. Inbox zalo để có giá rẻ nhất!","product_type":"supplement"}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"risk": "high",
"score": 100,
"count": 5,
"categories": [
"absolute",
"medical_claim",
"guarantee",
"off_platform",
"misleading_price"
],
"issues": [
{
"text": "số 1",
"start": 19,
"end": 23,
"phrase": "số 1",
"category": "absolute",
"severity": "high",
"legal_ref": "Luật Quảng cáo 16/2012/QH13, Điều 8 khoản 11",
"suggestion": "Chỉ dùng khi có tài liệu hợp pháp chứng minh (kết quả khảo sát, giấy chứng nhận); nếu không, thay bằng mô tả cụ thể: \"được nhiều khách hàng tin dùng\", \"bán hơn 10.000 sản phẩm\""
},
{
"text": "chữa khỏi",
"start": 34,
"end": 43,
"phrase": "chữa khỏi",
"category": "medical_claim",
"severity": "high",
"legal_ref": "Luật An toàn thực phẩm 55/2010/QH12; NĐ 15/2018/NĐ-CP (quảng cáo thực phẩm bảo vệ sức khỏe); Luật Quảng cáo, Điều 19 khoản 1 (sửa đổi bởi Luật 75/2025/QH15)",
"suggestion": "Không gán công dụng phòng, chữa bệnh cho thực phẩm, thực phẩm bảo vệ sức khỏe, mỹ phẩm; với TPBVSK chỉ dùng nội dung đã được cấp giấy xác nhận quảng cáo, ví dụ \"hỗ trợ…\""
},
"…"
],
"requirements": [
{
"requirement": "Câu khuyến cáo \"Thực phẩm này không phải là thuốc, không có tác dụng thay thế thuốc chữa bệnh\" và giấy xác nhận nội dung quảng cáo",
"legal_ref": "Luật An toàn thực phẩm 55/2010/QH12; NĐ 15/2018/NĐ-CP (quảng cáo thực phẩm bảo vệ sức khỏe)",
"present": false
}
],
"product_type": "supplement",
"reviewed": "2026-11-11",
"legal_basis": "Luật Quảng cáo 16/2012/QH13 sửa đổi bởi Luật 75/2025/QH15 (hiệu lực 01/01/2026); Luật An toàn thực phẩm và NĐ 15/2018/NĐ-CP; Luật Dược; chính sách công khai của các sàn",
"disclaimer": "Risk hints from a curated word list, not legal advice: a flagged phrase can be lawful with supporting documents, and unlisted wording can still breach the rules."
}
Ứng dụng
- Kiểm tra tin đăng sản phẩm trước khi đưa lên TikTok Shop, Shopee
- Rà soát quảng cáo thực phẩm chức năng, mỹ phẩm có nói chữa bệnh
- Thêm cảnh báo tuân thủ cho công cụ viết content, AI
- Sàng lọc kịch bản livestream có từ ngữ bị cấm
Hỏi đáp
"Tốt nhất" có luôn bị cấm không?
Không: luật cấm dùng "nhất", "tốt nhất", "số một" và từ tương tự khi không có tài liệu hợp pháp chứng minh. API gắn cờ để bạn bỏ đi hoặc chuẩn bị tài liệu.
Quy tắc lấy từ đâu?
Từ Luật Quảng cáo sửa đổi bởi Luật 75/2025/QH15, quy định về an toàn thực phẩm, dược, và chính sách nội dung công khai của các sàn lớn; cách diễn đạt và phân nhóm do chúng tôi biên soạn, rà soát mỗi 90 ngày.
Văn bản không dấu có kiểm tra được không?
Được, cụm từ khớp cả khi có dấu lẫn không dấu (riêng các từ rất ngắn dễ nhầm chỉ khớp khi có dấu).
API liên quan
So sánh văn bản
So sánh hai đoạn văn bản theo dòng, từ, ký tự, câu hoặc JSON; nhận danh sách thay đổi, tỉ lệ giống nhau và bản diff dạng unified.
a-bTạo slug
Chuyển tiêu đề thành slug URL gọn gàng: bỏ dấu tiếng Việt (cả chữ đ), tuỳ chọn ký tự phân cách, giữ chữ hoa và giới hạn độ dài.
123Thống kê văn bản
Đếm số từ, ký tự, câu, đoạn và dòng; ước tính thời gian đọc và thời gian nói; liệt kê các từ xuất hiện nhiều nhất trong văn bản.