À retenir : The Beauty API propose deux façons d’utiliser son catalogue. L’API hébergée est un service sur abonnement : votre application envoie des requêtes, reçoit les réponses et peut les afficher et les mettre en cache. À la fin de la période d’accès payée, l’accès à l’API, l’hébergement des images et les nouvelles données s’arrêtent. The Complete Archive est un achat unique : vous téléchargez les fichiers CSV, JSONL, SQLite et les images, puis les conservez durablement. Choisissez l’API pour un service de consultation hébergé, ou l’archive pour exploiter une copie complète dans vos systèmes.
Le choix dépend de la façon dont vous souhaitez utiliser et héberger les données. Les deux offres peuvent alimenter une recherche de produits ou un outil de recommandation. Ce guide explique ce que chacune fournit, ce que vous pouvez conserver et les responsabilités associées.
Un service à interroger ou des fichiers à télécharger
Une base téléchargeable est un ensemble de fichiers. Avec The Complete Archive, vous importez le catalogue dans un tableur, une base, un traitement de données ou un outil d’entraînement de modèles. Vous pouvez consulter les fiches, retrouver les ingrédients associés à chaque produit et filtrer les données dans vos propres outils.
Une API est un service. Les données sont hébergées chez nous et votre application demande ce dont elle a besoin par HTTPS : une page de 20 résultats de recherche, la fiche d’un produit ou un lot pouvant contenir 50 identifiants. L’API ne fournit pas le catalogue complet en fichier. L’achat de l’archive est l’offre prévue pour disposer d’une copie complète.
Cette différence détermine l’hébergement, les mises à jour, le mode de paiement et la conservation des données.
Ce que vous recevez
Avec l’API hébergée : une API REST à l’adresse api.thebeautyapi.com, avec recherche de produits, filtres par catégorie, marque, indicateurs et ingrédients, consultation individuelle ou par lot et fiches d’ingrédients. Les offres concernées incluent la recherche par code-barres. Les fiches présentent les ingrédients dans l’ordre de l’étiquette, avec des liens vers un dictionnaire INCI, les fonctions et évaluations disponibles, ainsi que les URL des images hébergées. Les nouveaux clients disposent d’un essai de sept jours avec 100 requêtes au total. L’offre payante sélectionnée commence ensuite, sauf résiliation. Les abonnements commencent à 40 $ US par mois pour 10 000 appels inclus. Consultez la documentation.
Avec The Complete Archive : une licence sur la version achetée du catalogue, comprenant environ 260,000 produits, les ingrédients dans l’ordre de l’étiquette et leurs liens vers le dictionnaire INCI, environ 26,000 fiches d’ingrédients, les GTIN connus et une archive d’images de ~23GB. Les formats sont CSV, JSONL et SQLite. La page de l’archive détaille la version proposée.
Ce que vous pouvez conserver
Avec l’API, vous pouvez afficher les données reçues et les mettre en cache dans votre application. Une résiliation laisse l’accès et l’hébergement des images actifs jusqu’à la fin de la période payée. Ensuite, l’accès et les mises à jour cessent. La copie permanente du catalogue complet relève de l’achat de l’archive. Les conditions d’utilisation interdisent de redistribuer les données de l’API sous forme de base autonome, de flux ou d’API publique, ainsi que l’extraction au-delà de l’usage normal d’une application.
Les images de l’API sont accessibles par image_url et peuvent être mises en cache et servies par votre propre réseau de diffusion. Notre hébergement d’images s’arrête avec l’accès au service. Avec l’archive, les fichiers d’images font partie du téléchargement.
Avec The Complete Archive, vous conservez les fichiers et images sans abonnement. Vous pouvez les importer, créer un catalogue enrichi pour votre application, entraîner des modèles et héberger les images. La licence n’autorise pas la redistribution ou la revente des fichiers bruts, ni la création d’un produit de données concurrent.
Comment les données sont mises à jour
Avec l’API, vous accédez aux nouveaux produits et aux corrections dès la mise à jour du service. L’archive correspond à la version achetée. Les versions futures ne sont pas incluses automatiquement ; vous pouvez demander une mise à jour, facturée séparément selon le volume de données mises à jour.
L’API vous évite de gérer l’import des nouvelles versions. L’archive vous permet de choisir quand mettre à jour votre propre catalogue. Le journal des versions présente les changements publiés.
Les identifiants ne sont pas les mêmes
L’API utilise des UUID pour les produits et ingrédients, par exemple 06d9476a-397b-5f61-abc8-640b30a9ae23. The Complete Archive utilise des identifiants entiers dans SQLite et pour les relations entre les produits, ingrédients et lignes de product_ingredients. Il n’existe pas de correspondance publique entre ces deux systèmes : vous ne pouvez pas joindre directement une ligne de l’archive à une fiche API à partir de son identifiant.
Choisissez le système qui fera référence dans votre application. Un rapprochement entre les deux demande de vérifier l’identité du produit, sa variante et sa formule ; une ressemblance de nom ne suffit pas à établir qu’il s’agit de la même fiche.
Comparer les offres
| Critère | API hébergée | The Complete Archive |
|---|---|---|
| Accès | Service interrogé par requêtes | Fichiers du catalogue complet |
| Paiement | Abonnement mensuel à partir de 40 $ US ; essai de sept jours avec 100 requêtes au total | Achat unique |
| Livraison | JSON ; pages de 20 résultats ; lots de 50 identifiants maximum | CSV, JSONL, SQLite et images |
| Mises à jour | Versions déployées dans le service | Version achetée ; mises à jour payantes sur demande |
| Cache | Dans votre application ; l’accès et l’hébergement cessent à la fin de la période payée | Fichiers conservés durablement |
| Images | URL hébergées accessibles avec le service | Archive de ~23GB incluse |
| Catalogue complet en fichiers | Non | Oui |
| Identifiants | UUID | Entiers |
| Codes-barres | Recherche dans les offres concernées | Table product_barcodes |
| Entraînement de modèles | Pas de copie complète fournie | Usage couvert par la licence |
| Remboursements | Frais non remboursables, sans prorata | Ventes définitives ; échantillon disponible avant achat |
| Hébergement et maintenance | Nous prenons en charge le service de données | Vous prenez en charge vos systèmes |
Choisir selon votre projet
- Application ou boutique qui consulte les fiches à la demande : l’API fournit le service hébergé. Notre guide de recommandation illustre les appels nécessaires.
- Catalogue à conserver dans vos propres systèmes : importez The Complete Archive et utilisez ses identifiants pour vos relations.
- Analyse, recherche ou apprentissage automatique : l’archive rassemble les données et les images pour vos traitements.
- Recherche à partir d’un scan : une offre API avec codes-barres fournit les fiches sans que vous hébergiez le catalogue.
- Copie durable et mises à jour choisies : l’archive avec des mises à jour périodiques vous permet de contrôler le calendrier des imports. L’API ne propose pas de requête donnant les seules modifications depuis votre archive.
Questions fréquentes
L’API et l’archive contiennent-elles les mêmes données ?
Elles proviennent du même catalogue, mais leur format et leur version peuvent différer. L’archive reste la version achetée ; le service peut recevoir de nouvelles versions ou des correctifs.
Peut-on télécharger tout le catalogue par l’API ?
Non. The Complete Archive est l’offre prévue pour une copie complète et permanente. L’API répond aux requêtes de votre application.
Que se passe-t-il après une résiliation ?
L’accès à l’API et l’hébergement des images continuent jusqu’à la fin de la période payée. L’accès au service et les mises à jour cessent ensuite. Votre code et vos propres données utilisateurs restent les vôtres.
Peut-on obtenir un remboursement de l’abonnement ?
Vous pouvez résilier à tout moment. Les frais d’abonnement ne sont pas remboursables et les mois partiels ne sont pas calculés au prorata. L’essai permet aux nouveaux clients d’évaluer l’API avant le début de l’offre payante choisie.
Comment essayer avant de choisir ?
Vous pouvez utiliser l’essai de sept jours avec 100 requêtes au total ou l’échantillon gratuit de 1 000 produits pour travailler avec les fichiers de l’archive.
Où trouver les conditions exactes ?
Les conditions d’utilisation précisent la licence, les restrictions, les paiements et les mises à jour.
Choisir comment utiliser vos données
Choisissez l’API si vous voulez consulter les données dans un service hébergé. Choisissez l’archive si vous voulez importer et conserver le catalogue complet avec ses images. Décrivez-nous votre projet si vous avez besoin d’aide pour choisir.

