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: 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.

// Get detailed ingredient information
const response = await fetch('https://api.skincare.com/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.

// Analyze a complete product
const response = await fetch('https://api.skincare.com/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.