Skincare Ingredient API with Safety Ratings
Query ingredient profiles and analyze full INCI lists over HTTPS. Responses include severity labels, comedogenicity and irritancy scores, identifiers, optional category, synonyms, batch safety_status and per-row matches, plus transparent credit usage on every successful call.
Trusted by 300+ developers building the future of skincare tech
import { Dermalytics } from "dermalytics";
const client = new Dermalytics({
apiKey: process.env.DERMALYTICS_API_KEY,
});
const ingredient = await client.getIngredient("niacinamide");
// category, synonyms[], credits_remaining,
// comedogenicity / irritancy (0–5), identifiers, functionsTry the Ingredient API
Paste any skincare ingredient list and see safety ratings instantly — powered by our database of 30,000+ ingredients.
Paste a comma-separated ingredient list — we'll check each one against our database
Everything You Need to Build Better Skincare Apps
Research-backed data from thousands of ingredients, inspired by INCIDecoder's trusted methodology
Ingredient lookup
GET /v1/ingredients/{name} returns rich profile data for one INCI or synonym
- Severity labels and comedogenicity / irritancy (0–5)
- CAS / EC identifiers and optional Ph. Eur. naming
- Category and cosmetic function lists
- Synonyms for alternate INCI or trade names
Batch analysis
POST /v1/analyze with a JSON body { "ingredients": ["..."] }
- Overall formulation safety_status
- Per-ingredient rows with found flag and nullable category
- Same detail fields as single lookup when matched
- credits_remaining after charging matched rows only
Safety signals
Structured severity enums and formulation-level safety_status in the API response
- Four-level severity scale (safe → high_risk)
- Per-ingredient severity and match status (found) on batch analyze
- Overall safety_status for the analyzed list
- Designed for building your own UX and filters
Credits and contract
Predictable usage: credits on successful lookups and per matched analyze row
- credits_remaining in JSON and X-Credits-Remaining header
- 1 credit per successful single-ingredient GET
- 1 credit per analyze row with found: true
- Official SDKs: dermalytics on npm and PyPI
Built for Modern Development Teams
Whether you're building the next viral skincare app or enhancing an existing platform, our API scales with your needs
Mobile App Developers
Build ingredient scanners, product analyzers, and personalized skincare recommendation apps with our comprehensive API
Key Benefits:
- • Real-time ingredient lookup for barcode scanning apps
- • Product analysis for beauty recommendation engines
- • User profile matching for personalized skincare
- • Integration with camera APIs for label scanning
Health & Wellness Platforms
Integrate skincare safety analysis into your health tracking ecosystem for comprehensive user care
Key Benefits:
- • Allergen detection for sensitive skin users
- • Ingredient safety recommendations
- • Health condition compatibility checks
- • Pregnancy-safe product filtering
E-commerce Solutions
Enhance product pages with detailed ingredient insights and automated safety badges
Key Benefits:
- • Automated product data enrichment
- • Trust badges and safety certifications
- • Ingredient-based search and filters
- • Customer education and transparency
How It Works
Get started in minutes with our developer-friendly API
Install the official client
Use the published npm package or call the REST API directly—Bearer auth either way.
Send Ingredient or Product Data
Query individual ingredients or analyze complete product formulations.
Receive detailed analysis
Get formulation safety_status, per-ingredient rows (with found and detail fields), and remaining credits.
Frequently Asked Questions
Everything you need to know about our API
Our API aggregates data from over 50 authoritative sources including peer-reviewed dermatological journals (PubMed, Journal of the American Academy of Dermatology), regulatory databases (FDA, EU CosIng, Health Canada), and established ingredient databases. We process over 10,000 scientific papers and regulatory documents, covering more than 5,000 cosmetic ingredients with safety profiles, efficacy data, and usage guidelines. Our methodology is inspired by trusted sources like INCIDecoder and EWG, but enhanced with proprietary algorithms that cross-reference multiple sources for accuracy.
Our safety ratings are based on a multi-factor scoring system that evaluates ingredients across 12 different safety dimensions including irritation potential, allergenicity, comedogenicity, and phototoxicity. Each rating is calculated using weighted algorithms that consider concentration levels (typically 0.1% to 5% in formulations), skin type compatibility, and usage context (leave-on vs. rinse-off products). We achieve 94% accuracy when validated against dermatologist-reviewed product assessments. Ratings are updated within 48 hours when new critical safety data is published.
Yes! Our API is designed for commercial use with flexible licensing options. Whether you're building a mobile app, e-commerce platform, SaaS product, or wellness service, our standard commercial license allows unlimited end-users and revenue generation. We offer pay-per-use pricing starting at $0.01 per ingredient lookup with volume discounts available at 10,000+ calls/month. Enterprise customers can negotiate custom licensing terms including white-label options and on-premise deployment. No upfront costs, no subscription fees—just transparent usage-based pricing.
We maintain a 99.95% uptime SLA for all production environments. Our infrastructure runs on AWS with multi-region redundancy across 3 availability zones, automatic failover capabilities, and 24/7 monitoring. We provide real-time status updates through our status page (status.dermalytics.dev) and send proactive incident notifications via email, SMS, and webhooks. Historical uptime over the past 12 months has been 99.97%. Enterprise customers receive dedicated infrastructure with custom SLA guarantees up to 99.99%.
Yes! We offer a free trial with 100 API calls per month and a rate limit of 3 requests per minute—perfect for testing, proof of concept development, and small personal projects. The trial includes full access to all ingredient data, safety ratings, and product analysis features with no credit card required. After the trial, we maintain a free tier with 100 calls/month for ongoing development. Paid plans start at $39/month for 10,000 calls with higher rate limits and priority support.
Our API is optimized for speed with typical response times under 300ms for ingredient lookups and under 500ms for complete product analysis. We use global CDN distribution and intelligent caching to ensure low latency regardless of your location.
Any language that can send HTTPS requests with a Bearer token works. We also publish official alpha SDKs: JavaScript/TypeScript on npm (https://www.npmjs.com/package/dermalytics) and Python on PyPI (https://pypi.org/project/dermalytics/). For interactive API tests, use the hosted Swagger UI at https://api.dermalytics.dev/docs. The REST contract is defined in OpenAPI 3 at https://api.dermalytics.dev/openapi.json. Guides and examples are on our /docs page.
We continuously monitor scientific literature, regulatory updates, and industry publications through automated systems that process over 200 new papers and regulatory documents weekly. Major database updates with new ingredients and revised safety profiles occur quarterly (January, April, July, October). Critical safety information—such as FDA warnings or EU regulatory changes—is updated within 24-48 hours of publication. All API users automatically receive updated data without any code changes. We maintain a changelog documenting all updates, and Enterprise customers receive advance notifications of upcoming changes.
Our insights are generated using statistical algorithms informed by scientific research and best practices. They are provided for informational purposes only and do not constitute medical or dermatological advice. Accuracy is not guaranteed, and results may not account for individual health conditions or sensitivities. Always consult a qualified healthcare professional before using skincare products.