Comedogenic ingredient API
A free, read-only JSON API over our database of 550+ ingredients — comedogenicity rating (0–5), pore-clogging flag and fungal-acne (Malassezia) trigger. Build it into your own app, store or skincare tool.
Look up one ingredient
GET https://acnesafecheck.com/api/check?ingredient=coconut oil
{
"query": "coconut oil",
"result": {
"name": "Coconut Oil", "rating": 4, "category": "Oil",
"poreClogging": true, "fungalAcneTrigger": true,
"match": "exact",
"slug": "coconut-oil",
"url": "https://acnesafecheck.com/ingredient/coconut-oil.html"
}
}
Screen a whole ingredient list
GET https://acnesafecheck.com/api/check?ingredients=water,glycerin,coconut oil,niacinamide
{
"summary": { "total": 4, "matched": 4, "poreClogging": 1, "fungalAcneTriggers": 1 },
"results": [ { "input": "water", "result": { "name": "Water", "rating": 0, "match": "exact", ... } },
{ "input": "some unknown ingredient", "result": null }, ... ]
}
Notes
- CORS is enabled — call it directly from the browser.
resultisnullwhen an ingredient isn't in the database.matchis"exact"for a direct alias hit or"partial"when we matched the trailing INCI name inside a longer token (e.g. "cocos nucifera coconut oil" → Coconut Oil).- Limits: max 200 ingredients / 20,000 characters per request.
- Responses are cached at the edge; no API key required for normal use.
- Want the whole database instead of per-request lookups? Download it from the open dataset page (CSV/JSON, CC BY 4.0).
- Ratings are general guidance compiled from published references, not medical advice. Please attribute acnesafecheck.com.
Need higher volume, a bulk dataset, or commercial terms? That's part of our upcoming premium plan — get in touch.