B2B · REST API · MCP · SDKs

Cosmetic ingredient API, agent-ready

Search cosmetic products by name, brand and ingredient. Retrieve stored INCI lists, look up ingredient profiles and analyze compositions through REST or MCP — structured data for apps, backends and AI agents.

5 free REST requests per IP every 24 hours. No registration needed.
Official SDKs 1.0.0 and MCP: npm · PyPI · MCP docs

Example API Call

import { Dermalytics } from "dermalytics";

const client = new Dermalytics();

// Single ingredient lookup
const ingredient = await client.getIngredient("niacinamide");
// → severity, comedogenicity (0–5), irritancy (0–5),
//   synonyms[], category, functions[], cas_no, ec_no

// Batch INCI analysis
const result = await client.analyze([
  "Aqua", "Glycerin", "Niacinamide",
]);
// → safety_status, per-ingredient rows, credits_remaining

// AI agents can call the same data through:
// https://api.dermalytics.dev/mcp

19,000+

Ingredients indexed

REST + MCP

Integration surfaces

Core API endpoints

JS + Python

Official SDKs

Looking for an INCIDecoder API? Compare its public website with Dermalytics' REST, OpenAPI, SDK, and MCP surfaces.

Live Demo

Try the Ingredient API

Paste an INCI-style list and preview the structured scores and fields the API returns.

Paste a comma-separated ingredient list — we'll check each one against our database

From product search to an ingredient list

Find a product by name or brand, filter by an ingredient, then retrieve its stored composition. Search costs one credit per non-empty page; product lookup costs one credit.

Try catalog search Explore the product API

GET /v1/products?q=cream&ingredient=Niacinamide
GET /v1/products/{id}
GET /v1/ingredients?q=niacinamide

Authorization: Bearer YOUR_API_KEY

MCP for AI Agents

Use the same ingredient data directly inside your AI tools

Connect Cursor, Claude Desktop, or any Streamable HTTP MCP client to the hosted Dermalytics server. Tools use your existing API key and the same credit rules as REST.

Server URL

https://api.dermalytics.dev/mcp

Tools

get_ingredient · analyze_product
search_ingredients
search_products
get_product

.cursor/mcp.jsonBearer auth

{
  "mcpServers": {
    "dermalytics": {
      "url": "https://api.dermalytics.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

API Capabilities

Everything you need to build better skincare apps

Structured ingredient records, nullable ratings, and documented fields for your application

GET /v1/ingredients/{name}

Ingredient lookup

Returns a rich profile for one INCI name or synonym over a single authenticated request.

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

POST /v1/analyze

Batch analysis

Send a JSON array of ingredient names and receive a full formulation report in one response.

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

severity · safety_status

Safety signals

Structured severity enums and formulation-level safety_status ready for your own UI and business rules.

Four-level severity scale (safe → high_risk)
Per-ingredient severity and match status on batch analyze
Overall safety_status for the analyzed INCI list
Designed for building your own UX and filters

credits_remaining

Credits, MCP, and contract

Predictable per-lookup pricing across REST, SDKs, and MCP tools.

credits_remaining in JSON and X-Credits-Remaining header
1 credit per successful single-ingredient GET
1 credit per analyze row with found: true
MCP tools use the same API key and credit balance

Who It's For

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 Apps

Mobile App Developers

Build ingredient scanners, product analyzers, and recommendation features using our HTTP API and SDKs.

Real-time ingredient lookup for barcode scanning
Product analysis for recommendation engines
User profile matching for skincare routines
Integration with camera APIs for label scanning

Wellness Platforms

Wellness & Lifestyle Apps

Enrich product catalogues and power filters with ingredient metadata — your app defines UX, copy, and compliance.

Batch lookups for catalogue and search
Severity and signal fields for your own rules and badges
Consistent data across web and mobile clients
You decide how to label results for end users

E-commerce

E-commerce Solutions

Enhance product pages with detailed ingredient insights and automated safety information.

Automated product data enrichment
Trust badges and safety certifications
Ingredient-based search and filters
Customer education and transparency

Quick Start

How It Works

Get started in minutes with our developer-friendly API

Install the client or connect MCP

Try REST without a key, use an official SDK, or connect an MCP client with your API key.

Example API Call

npm install dermalytics

import { Dermalytics } from "dermalytics";
const client = new Dermalytics();
await client.getIngredient("niacinamide");

// MCP server:
// https://api.dermalytics.dev/mcp

Send ingredient or product data

Query individual ingredients or analyze complete product formulations.

Example API Call

const result = await client.analyze([
  "Aqua",
  "Glycerin",
  "Niacinamide",
]);

Receive detailed analysis

Get safety_status, per-ingredient rows with severity and identifiers, and remaining credits.

Example API Call

{
  safety_status: "safe",
  ingredients: [
    {
      name: "Niacinamide",
      found: true,
      severity: "safe",
      comedogenicity: 0,
      irritancy: 1,
      cas_no: "98-92-0",
    }
  ],
  credits_remaining: 99
}

FAQ

Frequently Asked Questions

Everything you need to know about our API

Records include ingredient names, synonyms, cosmetic functions and identifiers where available. Comedogenicity and irritancy ratings are nullable and coverage varies by field. Test representative ingredients from your own catalog and consult the live OpenAPI contract before integration. The API provides data for software, not clinical diagnosis.

Severity labels are derived from stored comedogenicity and irritancy values. Missing ratings remain null; the legacy severity label alone does not distinguish an unassessed ingredient from a low-scored one. Check the underlying fields and show missing data explicitly. Ratings do not predict an individual's response to a finished product.

Yes. The API is intended for commercial products: mobile apps, e-commerce, internal tools, and SaaS. Plans, rate limits, and pricing are described on our pricing page (subscriptions plus usage-style options). Enterprise customers can discuss custom terms, SLAs, and integrations on our contact page.

We target high availability for production use and document SLA-style expectations with paid tiers where applicable. Infrastructure is monitored around the clock; status and incidents are communicated through our status page when available. Exact numbers depend on your plan—ask sales for Enterprise guarantees.

Yes. Try REST without a key: 5 requests per IP per 24-hour window, up to 3 search results without pagination, or 5 names per analysis. The allowance is shared across endpoints. After the second request, responses include a registration link. Register for an API key and 100 welcome credits to continue with full access. Hosted MCP requires a key.

Response time depends on your region, network, endpoint, payload size, and current service load. Test the production API from the regions your application serves and contact us if you need plan-specific performance or availability terms.

Any language that can send HTTPS requests works. Try REST without a key or use a Bearer token for full access. Our published SDKs 1.0.0 support ingredient and product search, lookup, analysis and optional API keys: JavaScript/TypeScript on npm (https://www.npmjs.com/package/dermalytics) and Python on PyPI (https://pypi.org/project/dermalytics/). AI agents can use the hosted MCP server at https://api.dermalytics.dev/mcp with docs at https://api.dermalytics.dev/v1/mcp/docs. 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.

Coverage and records can change over time. We do not promise a fixed refresh schedule for every ingredient or product. Validate the fields your application relies on, and contact us to discuss update requirements for your integration.

Ship ingredient features faster

No credit card required · Free trial available · Cancel anytime

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.

Read full disclaimer