260 000 produits · 26 000 marques · 26 000 ingrédients

L’API de produits cosmétiques la plus complète

Interrogez des fiches produits et ingrédients normalisées : composition dans l’ordre exact de l’étiquette, indices d’irritation et de comédogénicité fondés sur la recherche, identifiants chimiques et images de produits sur fond blanc.

Données mises à jour le 3 novembre 2026. Voir les nouveautés.

Essai gratuit de 7 jours · Offres dès 40 $ US/mois · 10 000 appels inclus · Résiliation à tout moment

Exemple
GEThttps://api.thebeautyapi.com/v1/products/search?q=the+ordinary+niacinamide&page=1
Réponse complèteDocumentation de l’API
Pour les assistants de développement

Ajoutez ces instructions en anglais à votre fichier CLAUDE.md, AGENTS.md ou aux règles de votre éditeur pour aider votre assistant à utiliser l’API. Également disponibles sur https://thebeautyapi.com/agent.md.

Afficher les 23 lignes ▾
# The Beauty API: instructions for coding agents
Base URL: https://api.thebeautyapi.com/v1 (JSON over HTTPS)
Auth: send the header x-api-key: $BEAUTY_API_KEY on every /v1 request. Keep the key in an environment variable, never in code or in this file.
Reference: https://thebeautyapi.com/docs.md | Spec: https://api.thebeautyapi.com/openapi.json | Keys: https://thebeautyapi.com/dashboard

## Endpoints
- Health: GET /health (no key)
- Search products: GET /v1/products/search?q=&page=
- Filter products: GET /v1/products?category=&brand=&origin=&fragrance_free=&alcohol_free=&paraben_free=&sulfate_free=&silicone_free=&has_ingredient=&excludes_ingredient=&page=
- Get a product: GET /v1/products/{id}
- Batch products: POST /v1/products/batch (body {"ids": [uuid, ...]}, max 50)
- Search ingredients: GET /v1/ingredients/search?q=&page=
- Get an ingredient: GET /v1/ingredients/{id}

## Rules
1. Find a product with search, then fetch the full record with GET /v1/products/{id}. Search and filter return slim records (id, brand, name, category, image_url); detail and batch return the full product record. See Ingredients data in the reference for the flat, sectioned and component formats.
2. Every word in q must appear in the product's brand or name, in any order. Send the brand plus the distinctive part of the name ("CeraVe Moisturizing Cream"), never a full retail title. Case, accents and punctuation are ignored; the last word may be partial.
3. When pagination.total is 0 the response carries a no_match object: drop the word no_match.hint names and retry. An empty result does not mean the brand is missing.
4. Pages hold 20 results; page runs 1 to 51 and anything higher returns 400. Read pagination.total and pagination.has_more; above 1,020 matches, narrow with filters instead of paging.
5. Batch takes up to 50 ids and is billed per item (50 ids = 50 calls); unknown ids come back as null in the same positions.
6. Errors are JSON {statusCode, error, message} and message says what to change. 403 is a missing or revoked key. 429 is the rate limit; no rate-limit headers are sent, so back off exponentially.
7. image_url can be null.
8. Deduplication aliases resolve older product and ingredient IDs to surviving records. Unknown or retired ingredient IDs return 400 in ingredient filters.
260 000
Produits
26 000
Marques
Un catalogue particulièrement riche en soins de la peau
26 000
Fiches d’ingrédients
5,5M
Occurrences d’ingrédients
moyenne de 20,2 par produit, dans l’ordre de l’étiquette

L’API

Un accès structuré à tout le catalogue

Une interface JSON uniforme pour notre catalogue, dont les ingrédients sont associés à leurs noms INCI, avec authentification par clé API et chemins versionnés. Aucun SDK propriétaire requis.

GET /v1/products/search

Recherche

Recherchez par marque et par nom de produit et obtenez des fiches allégées adaptées aux listes de résultats.

GET /v1/products

Filtrer et découvrir

Combinez la catégorie, la marque, l’origine, cinq indicateurs de formulation et la présence ou l’absence d’ingrédients dans une seule requête.

GET /v1/products/{id}

Fiche produit complète

Les ingrédients dans l’ordre de l’étiquette, leurs fonctions, leurs indices d’irritation et de comédogénicité, ainsi que leurs identifiants CAS, CE, IUPAC et Ph. Eur.

POST /v1/products/batch

Récupération par lot

Jusqu’à 50 fiches complètes par requête, renvoyées dans l’ordre des identifiants que vous avez envoyés.

GET /v1/ingredients/{id}

Informations scientifiques sur les ingrédients

26 000 fiches d’ingrédients normalisées : fonctions, indices d’irritation et de comédogénicité, et identifiants CAS, CE, IUPAC et Ph. Eur.

GET image_url

Images de produits sur fond blanc

Des photographies professionnelles de produits sur fond blanc, à utiliser directement dans votre interface.

Des spécialistes des données du monde entier nous font confiance

Hugging FaceHugging Face
KaggleDatarade

Intégration

Comment ça fonctionne

Créez une clé depuis votre tableau de bord développeur. Transmettez-la dans l’en-tête de vos requêtes.

01

Choisissez une offre, obtenez votre clé

Abonnez-vous depuis le tableau de bord et créez votre clé API en quelques minutes. Jusqu’à 2 clés actives par compte. Créez-les, affichez-les et révoquez-les à tout moment.

Votre tableau de bord
Abonnement     Pro · 100 000 appels/mois
Clé API        ····························9xYz · active
En-tête        x-api-key: <votre clé>
02

Appelez l’API depuis vos outils

HTTPS et JSON s’intègrent à votre environnement existant. Combinez les filtres pour répondre à vos questions sur les produits en une seule requête, avec pagination intégrée.

Les soins sans parfum en une requête
$ curl "https://api.thebeautyapi.com/v1/products?\
category=skincare&fragrance_free=true&page=1" \
    -H "x-api-key: $BEAUTY_API_KEY"

{
  "results": [ …20 produits… ],
  "pagination": { "page": 1, "has_more": true, "total": 43669 }
}
03

Créez l’interface de vos utilisateurs

Transformez la réponse en fiches interactives avec badges de formulation, évaluations d’ingrédients et vérifications d’incompatibilité. Vous maîtrisez la présentation.

The Ordinary

Niacinamide 10% + Zinc 1%

sans alcoolsans parfum
Niacinamide10%actifs principaux
Zinc PCA1%actifs complémentaires
irritation0/5
comédogénicité0/5

Exemple d’interface construit à partir d’une réponse de l’API. À vous de concevoir la présentation.

Couverture

Votre marque est-elle dans le catalogue ?

Notre catalogue réunit 260 000 produits de plus de 26 000 marques, avec une couverture particulièrement développée en soins de la peau. Recherchez une marque pour voir immédiatement les données disponibles.

Par exemple :

Répartition par catégorie

Part approximative du catalogue
Soins de la peau44%
Soins capillaires15%
Maquillage10%
Corps et bain9%
Protection solaire6%
Autres16%

Présence d’informations sur les ingrédients

Dans le catalogue de l’API.

Texte des ingrédients disponible
~83 %
Déclaration d’ingrédients au format texte.
Ingrédients structurés disponibles
~76 %
Ingrédients organisés en entrées distinctes, avec les sections et les composants des coffrets lorsqu’ils sont disponibles.

Informations disponibles sur les ingrédients

Ces pourcentages tiennent compte du nombre de fois où chaque ingrédient apparaît dans le catalogue.

Fonctions des ingrédients
~94 %
Numéro CAS
~86 %
Numéro CE
~75 %
Classification des ingrédientsCatégories éditoriales : actifs principaux, actifs complémentaires, sensibilisants
~33 %
Indice de comédogénicité
~23 %
Indice d’irritation
~23 %
ConcentrationUniquement lorsqu’elle est publiée par le fabricant, sans estimation
<1 %

Présence de codes-barres

Codes GTIN (UPC/EAN)Part des produits associés à au moins un code
~61 %

À qui s’adresse l’API

Pour vos projets dans le secteur de la beauté

Que vous développiez un moteur de recommandation ou travailliez sur des formulations, nos données structurées vous permettent de rechercher des produits et de comparer leurs compositions sans préparer vous-même le catalogue.

E-commerce et distribution

Enrichissez votre boutique et vos résultats de recherche avec nos données cosmétiques. Favorisez les conversions et réduisez les retours grâce aux informations sur les ingrédients et aux badges de formulation.

Ce que vous pouvez créer :

  • Des fiches produits détaillant leur composition pour attirer des visiteurs grâce au référencement naturel
  • Des fiches produits avec leur composition pour favoriser les conversions
  • Un filtrage selon les indices d’irritation et de comédogénicité pour les peaux sensibles
  • Des informations rassurantes et des badges de formulation

Créateurs d’applications beauté

Évitez des mois de collecte de données. Lancez dès le premier jour votre application de routines de soin ou d’analyse de la peau.

Ce que vous pouvez créer :

  • Détection des incompatibilités à partir de listes d’ingrédients structurées
  • Création de routines personnalisées à partir des indices d’irritation et de comédogénicité
  • Recommandations de produits selon le type de peau
  • Filtrage par ingrédient parmi 260 000 produits

Études de marché et R&D

Comparez les formulations du monde entier. Suivez les tendances des ingrédients dans 260 000 produits cosmétiques et repérez les opportunités grâce à l’API ou à la base de données sous licence.

Ce que vous pouvez créer :

  • Comparaison des produits concurrents à l’échelle mondiale
  • Analyse des tendances d’ingrédients et de formulations dans 260 000 produits
  • Entraînement de modèles d’IA pour étudier les liens entre emballages et ingrédients
  • Modèles de vision par ordinateur de haute précision pour automatiser les audits en magasin
The Beauty API a fourni une partie des données sur les produits cosmétiques utilisées dans Bestie. Leurs données propres et bien structurées nous ont aidés à élargir la couverture de notre catalogue. Merci pour leur soutien !
Pavan KFondateur de Bestie

Offres API

Des tarifs mensuels simples

Toutes les offres donnent accès au catalogue complet. Elles diffèrent par le nombre d’appels inclus, les limites de débit et l’accès aux codes-barres.

Les quotas sont réinitialisés au début de chaque mois de facturation · Résiliation à tout moment

La plus populaire

Starter

60 $ US/mois

Le volume Starter avec recherche par code-barres.

Essai gratuit de 7 jours. Abonnement payé d’avance, dépassements facturés en fin de mois de facturation

  • 10 000 appels API par mois inclus
  • Données complètes sur les produits et les ingrédients
  • Recherche par code-barres (GTIN/UPC/EAN → produit)
  • Dépassement : 0,02 $ US par appel (lots : par élément)

Pro

300 $ US/mois

Pour la production à grande échelle, avec recherche par code-barres.

Essai gratuit de 7 jours. Abonnement payé d’avance, dépassements facturés en fin de mois de facturation

  • 100 000 appels API par mois inclus
  • Données complètes sur les produits et les ingrédients
  • Recherche par code-barres (GTIN/UPC/EAN → produit)
  • Débits de requêtes plus élevés
  • Dépassement : 0,02 $ US par appel (lots : par élément)

La base de données

Obtenez la base de données du catalogue

Le même catalogue est disponible en achat unique aux formats SQLite, CSV et JSONL, avec l’archive complète des images, pour l’héberger, l’interroger et entraîner vos modèles.

260 000 produits · 260 000 images

The Complete Archive

260 000 fiches produits normalisées, un dictionnaire complet d’ingrédients avec leurs fonctions et leur potentiel comédogène, et l’intégralité des images produits.

1 500 $ US
version datée, en un seul paiement
  • 260 000 produits avec marque, nom, catégorie, origine et indicateurs de composition
  • Listes d’ingrédients dans l’ordre de l’étiquette, reliées au dictionnaire
  • Dictionnaire d’ingrédients normalisé : irritation, comédogénicité, classifications et fonctions
  • 260 000 images produits (~23Go), reliées aux fiches par leur identifiant
  • Codes-barres GTIN (UPC/EAN, au format GTIN-14) sur ~59 % des produits
  • Formats JSONL, SQLite et CSV
  • Documentation complète du schéma
Voir tous les détails →

Découvrez les données

Essayez les données avant de vous engager

Téléchargez un échantillon de 1 000 produits avec la documentation du schéma, ou vérifiez les marques disponibles sur la page de la base de données.

CSV + JSONL + 1 000 images · Aucun paiement requis

Pour choisir : base de données ou API

Questions

Questions fréquentes

Les réponses essentielles ci-dessous. Consultez la FAQ complète pour en savoir plus sur la couverture, l’utilisation et la base de données.

Comment accéder à l’API ?

Inscrivez-vous depuis le tableau de bord, puis choisissez Starter ou Pro, avec ou sans Barcode, pour bénéficier de sept jours d’essai gratuit et de 100 requêtes au total, partagées entre vos clés API. Créez une clé et authentifiez vos requêtes avec l’en-tête x-api-key. Après 100 requêtes, l’accès est suspendu jusqu’au passage à une offre payante. Atteindre cette limite ne déclenche aucun prélèvement anticipé. L’offre choisie démarre automatiquement après sept jours, sauf résiliation. Les frais mensuels sont prélevés d’avance et les dépassements à la fin du mois de facturation. Les offres payantes commencent à 40 $ US/mois. Consultez la documentation pour les points d’accès et les exemples.

Comment fonctionnent les quotas et les dépassements ?

L’essai comprend 100 requêtes au total pendant sept jours, partagées entre toutes vos clés ; un lot compte pour une requête. Les requêtes authentifiées qui atteignent l’API consomment ce quota, y compris celles qui renvoient une erreur. L’essai ne génère aucun dépassement facturé. Après 100 requêtes, l’API renvoie 429. Pour passer immédiatement à une offre payante, cliquez sur « Convert to paid plan » dans le tableau de bord. Vous pouvez aussi attendre le passage automatique à la fin de l’essai. Les offres payantes incluent 10 000 appels pour Starter et 100 000 pour Pro. Les frais mensuels sont prélevés au début de chaque mois de facturation. Chaque appel supplémentaire coûte 0,02 $ US, facturé à la fin de ce mois. Sur les offres payantes, chaque élément demandé dans un lot compte pour un appel. Le quota est réinitialisé au début de chaque mois de facturation ; un plafond anti-abus et des limites de débit s’appliquent également. Les appels signalés après la finalisation d’une facture ne sont ni facturés ni reportés. Les appels d’essai sont exclus de la consommation payante.

Que contient la base de données ?

Une version complète du catalogue : 260 000 produits avec marque, catégorie, pays d’origine et indicateurs de formulation (parfum, alcool desséchant, parabènes, sulfates, silicones) ; des listes d’ingrédients dans l’ordre de l’étiquette, reliées à un dictionnaire normalisé qui rassemble les fonctions, les indices d’irritation et de comédogénicité, les évaluations et les identifiants chimiques ; les codes-barres GTIN connus ; et l’archive complète des images (~23Go, 260 000 images). La livraison comprend les formats CSV, JSONL et SQLite, un dictionnaire de données complet et un guide du schéma.

Que puis-je faire avec la base de données ?

L’achat vous donne une version du catalogue utilisable sans limite de durée. Vous pouvez l’intégrer à vos systèmes, créer des produits et des analyses, et afficher les informations à vos utilisateurs, avec les images associées aux fiches pour votre propre usage. Vous ne pouvez pas redistribuer, revendre ni héberger publiquement les fichiers bruts (CSV, JSONL, SQLite et images) pour permettre à des tiers de les télécharger. Les versions ultérieures sont vendues séparément sous forme de mises à jour différentielles.

Commencer

L’API de référence pour les produits cosmétiques

Une seule clé donne accès à 260 000 fiches produits normalisées, 26 000 fiches d’ingrédients et des images de produits sur fond blanc. Essayez gratuitement ou passez en production dès 40 $ US/mois. Vous préférez les fichiers ? La base de données est disponible en achat unique ci-dessus.