API Documentation Preview

Get a glimpse of what our API can do. Full documentation available at launch.

Comprehensive Docs

Detailed guides for every endpoint

Code Examples

Ready-to-use snippets in multiple languages

Quick Start

Get up and running in under 5 minutes

Authentication

All API requests require an API key. Include your key in the Authorization header of each request.

Authorization Header

Authorization: Bearer YOUR_API_KEY

Get Ingredient Details

GET /v1/ingredients/:name

Retrieve comprehensive information about a specific ingredient including safety ratings, benefits, and scientific research.

JavaScript Example

// Get detailed ingredient information
const response = await fetch(
  'https://api.dermalytics.dev/v1/ingredients/niacinamide',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    }
  }
);

const ingredient = await response.json();

console.log(ingredient);
// {
//   name: "Niacinamide",
//   inci_name: "Niacinamide",
//   cas_number: "98-92-0",
//   safety_rating: 9.2,
//   function: ["Antioxidant", "Skin conditioning"],
//   benefits: ["Reduces inflammation", "Improves skin barrier"],
//   concerns: [],
//   skin_types: ["all"],
//   concentration_range: "2-10%"
// }

Analyze Product

POST /v1/analyze

Analyze a complete product formulation and get personalized recommendations based on skin type and concerns.

JavaScript Example

// Analyze a complete product
const response = await fetch(
  'https://api.dermalytics.dev/v1/analyze',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      ingredients: [
        "Aqua", "Glycerin", "Niacinamide",
        "Salicylic Acid", "Hyaluronic Acid"
      ],
      skin_type: "oily",
      concerns: ["acne", "large_pores"]
    })
  }
);

const analysis = await response.json();

console.log(analysis);
// {
//   overall_safety: 8.7,
//   skin_type_match: 9.5,
//   allergens: [],
//   warnings: ["May cause dryness if overused"],
//   recommendations: ["Good for acne-prone skin"],
//   ingredient_conflicts: []
// }

Want to See More?

Join our waitlist to get early access to the full API documentation, interactive playground, and exclusive launch pricing.

Disclaimer: Information provided is for educational purposes only and is not a substitute for professional medical or dermatological advice. Always consult a healthcare provider before using skincare products, especially if you have allergies or medical conditions. Learn more