Cosmetic product lookup (Open Beauty Facts) API

Looks up a cosmetic / personal-care product by barcode on Open Beauty Facts and returns a normalized record: a PARSED INCI ingredient list (parentheticals stripped, deduped, bounded), ingredient count, period-after-opening, labels, and the ingredient-analysis flags (vegan / vegetarian / palm-oil-free). The MORE: a clean, parsed INCI list + structured analysis flags instead of one raw comma string. Distinct from the food endpoints (cosmetics database). Answers 'ingredients in this cosmetic barcode', 'is this shampoo vegan', 'INCI list for this product', 'is this beauty product palm-oil-free'.

Price$0.01per request

MethodPOST

Route/v1/data/beauty-product-by-barcode

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

databeautycosmeticsbarcodeinciingredientsopenbeautyfactsvegan

API URLhttps://x402.hexl.dev/v1/data/beauty-product-by-barcode

Integration docs

Example request

{
  "barcode": "8001090662231"
}

Example response

{
  "barcode": "8001090662231",
  "name": "Coconut Milk",
  "brand": "Herbal Essences",
  "quantity": "400 ml",
  "categories": [],
  "inciIngredients": [
    "Aqua",
    "Sodium Laureth Sulfate",
    "Cocamidopropyl Betaine",
    "Sodium Lauryl Sulfate",
    "Sodium Citrate",
    "Sodium Chloride",
    "Sodium Xylenesulfonate",
    "Stearyl Alcohol",
    "Parfum",
    "Cetyl Alcohol",
    "Glycerin",
    "Glycol Distearate",
    "Dimethiconol",
    "Citric Acid",
    "Sodium Benzoate",
    "Dimethicone",
    "Guar Hydroxypropyltrimonium Chloride",
    "Hexyl Cinnamal",
    "Tetrasodium EDTA",
    "Sodium Hydroxide",
    "TEA-Dodecylbenzenesulfonate",
    "Polyquaternium-6",
    "Trihydroxystearin",
    "Trideceth-10",
    "Histidine",
    "Benzyl Salicylate",
    "Propylene Glycol",
    "Limonene",
    "Linalool",
    "Butylene Glycol",
    "Magnesium Nitrate",
    "Aloe Barbadensis Leaf Juice",
    "Alcohol Denat",
    "Zea Mays Silk Extract",
    "Cocos Nucifera Fruit Extract",
    "Methylchloroisothiazolinone",
    "Magnesium Chloride",
    "Triethylene Glycol",
    "Benzyl Alcohol",
    "Methylisothiazolinone",
    "Ecklonia Radiata Extract"
  ],
  "inciCount": 41,
  "periodAfterOpening": null,
  "analysis": {
    "vegan": "vegan-status-unknown",
    "vegetarian": "vegetarian-status-unknown",
    "palmOil": "palm-oil-free",
    "flags": [
      "palm-oil-free",
      "vegan-status-unknown",
      "vegetarian-status-unknown"
    ]
  },
  "labels": []
}

Input schema

{
  "type": "object",
  "required": [
    "barcode"
  ],
  "properties": {
    "barcode": {
      "type": "string",
      "pattern": "^\\d{6,14}$",
      "description": "Cosmetic product barcode (EAN/UPC)."
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}