Referência da API

Documentação da API de ingredientes cosméticos

Referência completa da API para os endpoints de análise INCI, pontuação de segurança, detecção de alérgenos e compatibilidade com a pele.

Autenticação para a API de cosméticos

Todas as requisições à INCI API exigem uma chave de API enviada no cabeçalho X-API-Key. Obtenha sua chave de API gratuita no Painel.

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913" \
  -H "X-API-Key: sk_live_your_api_key"

Aviso sobre os dados

Important Disclaimer

The ingredient safety data, scores, and ratings provided by INCI API are for informational and educational purposes only. This information is compiled from public databases and scientific literature, and may contain errors, omissions, or outdated information. INCI API does not guarantee the accuracy, completeness, or reliability of any data presented.

This service does not provide medical, dermatological, or health advice. Safety scores and ratings are algorithmic assessments based on available data and should not be used as a substitute for professional medical advice, diagnosis, or treatment. Always consult a qualified healthcare professional or dermatologist before making decisions about cosmetic products, especially regarding pregnancy safety, allergies, or skin conditions.

INCI API assumes no liability for any decisions made based on the information provided.

Todas as respostas da API contêm dados de ingredientes compilados de fontes públicas como EU CosIng, relatórios CIR e literatura científica publicada. A precisão não é garantida. As pontuações de segurança são estimativas algorítmicas baseadas nos dados disponíveis, não avaliações clínicas. Os usuários devem verificar de forma independente todas as informações sobre os ingredientes. Veja nossos Termos de Serviço e o Acordo de Licença da API para os termos completos.

Endpoints da API de análise INCI

GET/v1/products/:barcodeFree+

Busque um produto de beleza por código de barras. Retorna info do produto, marca, lista INCI e imagens.

Requisição

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913" \
  -H "X-API-Key: sk_live_your_api_key"

Resposta

json

{
  "success": true,
  "data": {
    "barcode": "3337875597913",
    "name": "La Roche-Posay Toleriane Double Repair",
    "brand": "La Roche-Posay",
    "category": ["Skincare", "Moisturizer"],
    "imageUrls": ["https://cdn.inciapi.com/..."],
    "inciList": [
      "Aqua", "Glycerin", "Dimethicone",
      "Niacinamide", "Ceramide NP"
    ],
    "vertical": "cosmetics",
    "qualityScore": 92
  }
}

GET/v1/products/:barcode/safetyStarter+

Obtenha a análise completa de segurança de um produto. Inclui pontuação geral e classificações por ingrediente.

Requisição

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/safety" \
  -H "X-API-Key: sk_live_your_api_key"

Resposta

json

{
  "success": true,
  "data": {
    "overallSafetyScore": 92,
    "cleanBeautyScore": 88,
    "ingredients": [
      {
        "inciName": "Aqua",
        "safetyRating": 1,
        "functions": ["Solvent"],
        "isAllergen": false,
        "isPregnancySafe": true
      },
      {
        "inciName": "Niacinamide",
        "safetyRating": 1,
        "functions": ["Antioxidant", "Brightening"],
        "isAllergen": false,
        "isPregnancySafe": true
      },
      {
        "inciName": "Phenoxyethanol",
        "safetyRating": 4,
        "functions": ["Preservative"],
        "isAllergen": false,
        "isPregnancySafe": true
      }
    ]
  }
}

GET/v1/products/:barcode/allergensStarter+

Obtenha avisos de alérgenos para um produto. Verifica os 80 alérgenos obrigatórios da UE, sensibilizantes de contato e alérgenos conservantes.

Requisição

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/allergens" \
  -H "X-API-Key: sk_live_your_api_key"

Resposta

json

{
  "success": true,
  "data": {
    "allergenWarnings": [
      {
        "inciName": "Linalool",
        "allergenType": "EU Fragrance Allergen",
        "severity": "moderate",
        "description": "Common fragrance allergen, mandatory labeling in EU"
      },
      {
        "inciName": "Citronellol",
        "allergenType": "EU Fragrance Allergen",
        "severity": "low",
        "description": "Fragrance component, potential sensitizer"
      }
    ],
    "totalAllergens": 2,
    "hasEuAllergens": true,
    "hasContactSensitizers": false
  }
}

GET/v1/products/:barcode/compatibility?skinType=sensitiveEm breve+

Verifique a compatibilidade com tipos de pele. Tipos suportados: oleosa, seca, sensível, mista, propensa à acne, normal.

Requisição

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/compatibility?skinType=sensitive" \
  -H "X-API-Key: sk_live_your_api_key"

Resposta

json

{
  "success": true,
  "data": {
    "skinType": "sensitive",
    "compatible": true,
    "score": 95,
    "concerns": [],
    "recommendations": [
      "Product is fragrance-free",
      "Contains ceramides (skin barrier support)",
      "Contains niacinamide (anti-inflammatory)"
    ],
    "allSkinTypes": [
      { "skinType": "sensitive", "compatible": true, "score": 95 },
      { "skinType": "dry", "compatible": true, "score": 90 },
      { "skinType": "oily", "compatible": true, "score": 82 },
      { "skinType": "combination", "compatible": true, "score": 88 },
      { "skinType": "acne-prone", "compatible": true, "score": 78 },
      { "skinType": "normal", "compatible": true, "score": 96 }
    ]
  }
}

GET/v1/products/:barcode/pregnancyEm breve+

Verifique a segurança na gravidez. Marca retinoides, ácido salicílico (BHA), hidroquinona e outros ingredientes inseguros na gravidez.

Requisição

bash

curl -X GET "https://api.inciapi.com/v1/products/3337875597913/pregnancy" \
  -H "X-API-Key: sk_live_your_api_key"

Resposta

json

{
  "success": true,
  "data": {
    "pregnancySafe": true,
    "warnings": [],
    "flaggedIngredients": [],
    "safeAlternatives": [],
    "note": "No pregnancy-unsafe ingredients detected"
  }
}

POST/v1/analyzeEm breve+

Analise uma lista INCI crua sem código de barras. Envie nomes de ingredientes e receba uma análise de segurança completa.

Requisição

bash

curl -X POST "https://api.inciapi.com/v1/analyze" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "inci": [
      "Aqua", "Glycerin", "Niacinamide",
      "Cetearyl Alcohol", "Phenoxyethanol",
      "Retinol", "Linalool"
    ]
  }'

Resposta

json

{
  "success": true,
  "data": {
    "overallSafetyScore": 78,
    "cleanBeautyScore": 72,
    "ingredients": [
      { "inciName": "Aqua", "safetyRating": 1, "isAllergen": false, "isPregnancySafe": true },
      { "inciName": "Glycerin", "safetyRating": 1, "isAllergen": false, "isPregnancySafe": true },
      { "inciName": "Niacinamide", "safetyRating": 1, "isAllergen": false, "isPregnancySafe": true },
      { "inciName": "Retinol", "safetyRating": 7, "isAllergen": false, "isPregnancySafe": false },
      { "inciName": "Linalool", "safetyRating": 5, "isAllergen": true, "isPregnancySafe": true }
    ],
    "allergenWarnings": [
      { "inciName": "Linalool", "allergenType": "EU Fragrance Allergen", "severity": "moderate" }
    ],
    "pregnancySafe": false,
    "pregnancyWarnings": ["Retinol: Vitamin A derivative, avoid during pregnancy"]
  }
}

GET/v1/ingredients/:inciNameFree+

Obtenha informações detalhadas sobre um ingrediente específico pelo nome INCI.

Requisição

bash

curl -X GET "https://api.inciapi.com/v1/ingredients/Niacinamide" \
  -H "X-API-Key: sk_live_your_api_key"

Resposta

json

{
  "success": true,
  "data": {
    "inciName": "Niacinamide",
    "commonName": "Vitamin B3",
    "casNumber": "98-92-0",
    "safetyRating": 1,
    "functions": ["Antioxidant", "Brightening", "Anti-inflammatory"],
    "isAllergen": false,
    "isPregnancySafe": true,
    "comedogenicity": 0,
    "suitableSkinTypes": ["oily", "dry", "sensitive", "combination", "acne-prone", "normal"],
    "euStatus": "approved",
    "description": "Well-researched skincare ingredient. Helps with hyperpigmentation, fine lines, and skin barrier function."
  }
}

GET/v1/ingredients/search?q=retinolFree+

Busque ingredientes por nome ou função. Retorna ingredientes correspondentes com dados de segurança.

Requisição

bash

curl -X GET "https://api.inciapi.com/v1/ingredients/search?q=retinol&limit=5" \
  -H "X-API-Key: sk_live_your_api_key"

Resposta

json

{
  "success": true,
  "data": {
    "ingredients": [
      {
        "inciName": "Retinol",
        "safetyRating": 7,
        "functions": ["Anti-Aging", "Cell Turnover"],
        "isAllergen": false,
        "isPregnancySafe": false
      },
      {
        "inciName": "Retinyl Palmitate",
        "safetyRating": 5,
        "functions": ["Anti-Aging", "Antioxidant"],
        "isAllergen": false,
        "isPregnancySafe": false
      }
    ],
    "total": 2,
    "page": 1,
    "pageSize": 5
  }
}

POST/v1/products/submitFree+

Envie um produto de beleza ausente com sua lista INCI. Os produtos contribuídos ficam disponíveis após moderação.

Requisição

bash

curl -X POST "https://api.inciapi.com/v1/products/submit" \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "barcode": "1234567890123",
    "name": "My Beauty Serum",
    "brand": "Indie Beauty",
    "inciList": ["Aqua", "Hyaluronic Acid", "Niacinamide"]
  }'

Resposta

json

{
  "success": true,
  "data": {
    "submissionId": "sub_abc123",
    "status": "pending_review",
    "message": "Product submitted successfully. Will be available after moderation."
  }
}

Limites de requisições da API de cosméticos

Os limites de requisições da API de análise de ingredientes dependem do nível da sua assinatura. Os limites são retornados nos cabeçalhos de resposta.

Plano	Limite	Reset
Free	100 requisições/dia	Diariamente à meia-noite UTC
Starter	5.000 requisições/mês	Mensalmente na data de cobrança

Cabeçalhos de resposta:

http

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4831
X-RateLimit-Reset: 1711929600

Códigos de erro INCI API

Código	Significado	Ação
`400`	Requisição inválida	Verifique os parâmetros e o formato do corpo da requisição
`401`	Não autorizado	Verifique sua chave de API no cabeçalho X-API-Key
`403`	Proibido	O endpoint exige um plano superior
`404`	Não encontrado	Produto ou ingrediente não consta na nossa base
`429`	Limite de requisições excedido	Aguarde os segundos indicados em Retry-After e tente novamente
`500`	Erro interno do servidor	Tente novamente mais tarde, contate o suporte se persistir

Formato da resposta de erro:

json

{
  "success": false,
  "error": {
    "code": 404,
    "message": "Product not found for barcode: 1234567890123"
  }
}