Ad Wording Checker (Vietnam) API

Flag risky wording in Vietnamese ads, listings and livestream scripts: "tốt nhất", "số 1", cure claims, comparisons, off-platform contact, with legal refs.

GETPOSThttps://apibox.io.vn/v1/vn-ad-check

Paste a product title, description, ad copy or livestream script and get every risky phrase with its position, category, severity, the legal reference and a suggested rewording. Categories: absolute claims banned without legal proof by the Advertising Law (Luật Quảng cáo 16/2012/QH13, Article 8.11: "nhất", "duy nhất", "tốt nhất", "số một", plus any other "<word> nhất"), comparisons with competitors without proof (Article 8.10 as amended by Law 75/2025/QH15, in force 1 January 2026), disease-cure and drug-like claims for food, health supplements and cosmetics, guaranteed results, misleading prices, products banned from advertising (tobacco, e-cigarettes, strong alcohol, breast-milk substitutes for under 24 months), counterfeit cues (fake 1:1, rep, like auth) and off-platform contact or payment that marketplaces forbid.

Set product_type (food, supplement, cosmetic, drug, medical_device, medical_service, milk_infant, alcohol…) to adjust severities and list the documents the law requires (cosmetic notification receipt, supplement advertising approval and the mandatory notice "Thực phẩm này không phải là thuốc…", checked in the text). Accents are optional (tot nhat matches). marketplace=false skips the platform rules; allow whitelists phrases you can prove.

The list is compiled by hand from the laws in force and public platform policies, with a review date in every answer. It flags risks: a flagged phrase can be lawful with supporting documents, and clean output is not legal clearance.

Parameters

NameInTypeRequiredDefault
textbody|querystringyesAd copy, listing or script (max 50,000 characters).
product_typebody|querystringnogeneralgeneral, food, supplement, cosmetic, drug, medical_device, medical_service, milk_infant, alcohol, finance.
marketplacebody|querybooleannotrueApply marketplace rules (off-platform contact / payment).
allowbody|querystringnoComma-separated phrases to ignore (you hold the proof).

Example

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"}'

Response

{
  "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."
}

Use cases

  • Check product listings before publishing on TikTok Shop or Shopee
  • Review supplement and cosmetic ads for cure claims
  • Add a compliance hint to a copywriting or AI content tool
  • Screen livestream scripts for banned wording

FAQ

Is "tốt nhất" always forbidden?

No: the law bans "nhất", "tốt nhất", "số một" and similar words without legal documents proving them. The API flags them so you can remove them or keep the proof.

Where do the rules come from?

The Advertising Law as amended by Law 75/2025/QH15, food-safety and drug rules, and the public content policies of the main marketplaces; the wording and categories are ours, reviewed every 90 days.

Does it work without accents?

Yes, phrases match with or without Vietnamese accents (very short ambiguous words only with accents).

Related APIs

Start with 1,000 free requests every month. Get free API key →