À retenir : Open Beauty Facts propose une base collaborative de cosmétiques, gratuite et ouverte, organisée autour des codes-barres. The Beauty API propose un catalogue normalisé et une API REST donnant accès à environ 260,000 produits et 26,000 ingrédients. Le catalogue relie les fiches produits aux informations sur leurs ingrédients et comprend des images. Le choix dépend de votre besoin : participer à une base ouverte ou intégrer des données déjà préparées dans votre application.
Pour créer une application dédiée aux soins de la peau, un explorateur d’ingrédients ou un catalogue e-commerce, vous avez besoin de fiches produits exploitables. Voici les différences de fonctionnement, de structure et de licence entre les deux offres. Nous développons The Beauty API et présentons cette comparaison du point de vue de notre équipe.
Comment fonctionne Open Beauty Facts ?
Open Beauty Facts est le projet consacré aux cosmétiques de la famille Open Food Facts. Les contributeurs peuvent scanner un code-barres, ajouter des photos de l’emballage et saisir la liste d’ingrédients. La consultation d’un produit passe par une requête GET :
curl "https://world.openbeautyfacts.org/api/v2/product/3600523281176"
// Réponse abrégée
{
"status": 1,
"product": {
"code": "3600523281176",
"product_name": "...",
"brands": "...",
"ingredients_text": "Aqua, Glycerin, ...",
"ingredients": [{ "id": "en:water", "text": "Aqua" }, ...],
"image_front_url": "https://images.openbeautyfacts.org/...jpg",
"image_ingredients_url": "https://images.openbeautyfacts.org/...jpg"
}
}
La réponse dépend des informations apportées par les contributeurs : code-barres, nom, marque, photos, texte des ingrédients et liste structurée dérivée de ce texte. La base est également proposée en téléchargement. Le projet demande aux utilisateurs de l’API de limiter leurs requêtes et de mettre les réponses en cache.
Que propose The Beauty API ?
The Beauty API réunit des fiches produits, les ingrédients dans l’ordre de leur déclaration et des liens vers des noms INCI de référence. Les informations disponibles comprennent les fonctions et les évaluations des ingrédients, les indices d’irritation et de comédogénicité, les numéros CAS et CE ainsi que les synonymes. Cinq indicateurs décrivent la présence de parfum, d’alcools desséchants, de parabènes, de sulfates et de silicones. Les images complètent les fiches.
Vous pouvez utiliser l’API hébergée ou acheter The Complete Archive : des fichiers CSV, JSONL et SQLite, accompagnés d’une archive d’images de ~23GB.
curl "https://api.thebeautyapi.com/v1/products/search?q=niacinamide" \
-H "x-api-key: YOUR_API_KEY"
// Récupérer ensuite la fiche complète
curl "https://api.thebeautyapi.com/v1/products/06d9476a-397b-5f61-abc8-640b30a9ae23" \
-H "x-api-key: YOUR_API_KEY"
// Réponse abrégée
{
"brand": "The Ordinary",
"name": "Niacinamide 10% + Zinc 1%",
"image_url": "https://images.thebeautyapi.com/06d9476a-....jpg",
"contains_fragrance": false,
"contains_drying_alcohol": false,
"ingredients": [
{
"position": 1,
"name": "Niacinamide",
"concentration": 10.0,
"rating": "direct actives",
"irritancy": null,
"comedogenicity": null,
"functions": ["smoothing"],
"cas_number": "98-92-0"
}
]
}
La recherche porte sur la marque et le nom du produit. Les filtres permettent d’explorer le catalogue par catégorie, marque, origine, indicateurs de formulation ou ingrédient. Les offres avec recherche par code-barres donnent accès à la recherche UPC ou EAN. Les nouveaux clients bénéficient d’un essai de sept jours avec 100 requêtes au total. L’offre payante sélectionnée commence à la fin des sept jours, sauf résiliation. Consultez la documentation de l’API pour les points d’accès disponibles.
Comparer les deux offres
| Critère | Open Beauty Facts | The Beauty API |
|---|---|---|
| Accès | API et base ouvertes | API sur abonnement ; archive achetée en une fois |
| Constitution du catalogue | Contributions de la communauté | Données nettoyées et normalisées, diffusées par version |
| Ingrédients | Texte saisi et représentation structurée lorsqu’ils sont disponibles | Ordre de déclaration conservé et liens vers un dictionnaire INCI |
| Informations complémentaires | À examiner dans les fiches et la documentation du projet | Fonctions, évaluations et identifiants chimiques selon les ingrédients |
| Images | Photos ajoutées par les contributeurs | Images de produits normalisées |
| Codes-barres | Au centre de la recherche produit | Recherche disponible dans les offres qui l’incluent |
| Structure | Champs renseignés selon les contributions | Champs et structures documentés dans OpenAPI |
| Licence | ODbL pour les données ; licences propres aux images | Licence commerciale adaptée à l’API ou à l’archive |
Les atouts d’Open Beauty Facts
- Un accès ouvert. Vous pouvez commencer un projet d’apprentissage ou de recherche et télécharger la base.
- Une recherche pensée pour le scan. Le code-barres est le point d’entrée naturel des contributions.
- Une base à laquelle vous pouvez contribuer. Vous pouvez ajouter vous-même des produits et leurs informations.
Les atouts de The Beauty API
- Des produits reliés à leurs ingrédients. Les noms présents sur les étiquettes sont associés à un dictionnaire INCI commun. Vous pouvez ainsi retrouver les mêmes ingrédients dans différents produits et proposer des soins selon les fonctions recherchées par vos utilisateurs.
- Une documentation pour votre intégration. Les définitions OpenAPI et les exemples expliquent les champs produits et ingrédients.
- Des images pour votre catalogue. Elles accompagnent les fiches pour construire vos listes et pages produits.
- Une archive pour votre propre infrastructure. Vous pouvez importer le catalogue acheté dans vos systèmes et l’enrichir pour votre application.
Comprendre la différence de licence
La licence ODbL autorise les usages commerciaux avec des obligations d’attribution et, dans les situations prévues par la licence, de partage à l’identique d’une base dérivée. C’est un point à prendre en compte si vous construisez une base enrichie destinée à être utilisée publiquement. Les conditions de The Beauty API distinguent l’accès au service hébergé de l’achat d’une copie du catalogue. Notre guide des licences explique cette distinction.
Quelle option choisir pour votre projet ?
- Projet étudiant ou application autour des données ouvertes : Open Beauty Facts vous permet de commencer et de contribuer.
- Application de scan sans budget pour les données : son accès ouvert est un point de départ pertinent ; prévoyez le traitement des informations reçues.
- Explorateur d’ingrédients ou outil pour composer une routine de soins : The Beauty API relie les produits à un dictionnaire INCI et aux fonctions des ingrédients pour vous aider à rechercher des produits selon les préférences de vos utilisateurs. Notre guide de recommandation montre comment utiliser ces informations.
- Catalogue e-commerce : nos fiches, images et filtres facilitent l’intégration. Ajoutez la recherche par code-barres si votre parcours repose sur le scan.
- Analyse ou entraînement de modèles : The Complete Archive fournit le catalogue en fichiers avec ses images.
- Premier essai : notre échantillon gratuit de 1 000 produits permet d’examiner la structure avant l’achat.
Questions fréquentes
L’API Open Beauty Facts est-elle gratuite ?
Oui. Respectez les consignes du projet concernant l’identification de votre application, le cache et la fréquence des requêtes.
Contient-elle les ingrédients des cosmétiques ?
Oui, lorsque les informations ont été ajoutées. Les fiches peuvent contenir le texte de la déclaration et sa représentation structurée.
Peut-on l’utiliser dans une application payante ?
Oui, dans les conditions de l’ODbL, notamment pour l’attribution et le partage à l’identique lorsqu’il s’applique.
Peut-on essayer The Beauty API ?
Oui, avec l’essai de sept jours comprenant 100 requêtes au total, ou l’échantillon gratuit de l’archive.
The Beauty API prend-elle en charge les codes-barres ?
Oui, avec GET /v1/products/barcode/{barcode} dans les offres concernées. Les représentations équivalentes d’un même GTIN, complétées par des zéros à gauche, sont reconnues.
Choisir selon les besoins de votre application
Open Beauty Facts est une ressource ouverte utile pour les projets collaboratifs et la recherche par code-barres. The Beauty API vous apporte des fiches produits nettoyées et normalisées, reliées aux informations sur leurs ingrédients. Vous pouvez les consulter par API ou les importer depuis l’archive. Choisissez selon les informations nécessaires à votre application et le travail que vous souhaitez prendre en charge.

