Questions

Questions fréquentes

Une autre question ? Écrivez-nous.

L’API hébergée

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.

Quelles données puis-je consulter avec l’API ?

L’ensemble du catalogue. Recherchez par marque et nom ; filtrez par catégorie, pays d’origine, caractéristiques de formulation et composition ; consultez les fiches avec les ingrédients dans l’ordre de l’étiquette ; récupérez jusqu’à 50 produits par lot ; et consultez les 26 000 fiches d’ingrédients normalisées, avec leurs évaluations et identifiants chimiques. Les images disponibles possèdent des URL hébergées utilisables directement dans votre interface. Les offres Barcode permettent aussi de retrouver un produit à partir d’un UPC ou d’un EAN scanné.

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 proposent les offres Barcode en plus ?

Les variantes Barcode de Starter et Pro donnent accès à la recherche par code-barres. Envoyez un UPC-A, EAN-13 ou GTIN-8/14 scanné ou issu de votre catalogue pour obtenir la fiche complète du produit. Les codes unitaires, de lots et de variantes (teinte, parfum ou format d’une même gamme) sont pris en charge. Environ 61% des produits possèdent actuellement au moins un code ; cette couverture augmente au fil des mises à jour.

Puis-je changer d’offre ou résilier ?

Oui, depuis le tableau de bord. Pendant l’essai, vous pouvez passer de Starter à Pro ou inversement sans réinitialiser les sept jours ni le quota de 100 requêtes. Le bouton « Convert to paid plan » permet de passer immédiatement à une offre payante. Cette action met fin à l’essai et déclenche le prélèvement du premier mois. Pour les abonnements prépayés, le passage à une offre supérieure ouvre un nouveau mois de facturation dès que le paiement est confirmé. Le temps prépayé non utilisé est crédité et les dépassements déjà signalés sont réglés. Le passage à une offre inférieure prend effet au renouvellement. Pour éviter le premier prélèvement, ouvrez la gestion de la facturation avec le bouton « Manage billing » et résiliez avant la fin de l’essai. Si vous résiliez un abonnement payant, vous conservez l’accès jusqu’à la fin de la période réglée. Les derniers dépassements sont facturés en fin de mois de facturation. Vos clés et l’URL de base restent identiques lors d’un changement d’offre. Vous pouvez avoir jusqu’à 2 clés actives par compte.

La base de données sous licence

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.

Quels formats fournissez-vous ?

Trois représentations des mêmes données pour s’adapter à votre environnement : du JSONL imbriqué (un produit par ligne avec ses ingrédients), des CSV relationnels (produits, ingrédients, relations, groupes et alias dans des fichiers séparés) et une base SQLite autonome avec clés étrangères et index. Vous pouvez les intégrer dans Postgres, MongoDB, DuckDB ou un notebook Pandas. Le dictionnaire de données décrit chaque colonne.

Comment les images sont-elles reliées aux produits ?

Pour chaque produit disposant d’une image, image_name (par exemple 1042.jpeg) indique son nom de fichier dans l’archive. Ce nom de fichier vous permet de retrouver l’image associée à chaque fiche. Vous hébergez les images sur votre propre infrastructure pour les utiliser dans votre application.

Comment mettre à jour une base achetée ?

La licence porte sur une version du catalogue au moment de l’achat (version actuelle : 2026.11). Pour intégrer les nouveautés, nous préparons une mise à jour différentielle qui contient la base de données complète et actualisée, au tarif de 0,0025 $ US par donnée mise à jour. Vous payez ainsi les changements plutôt qu’une seconde licence complète. Si vous préférez accéder aux données actuelles sans gérer ces mises à jour, l’API hébergée vous donne accès à la version en cours du catalogue.

Couverture et qualité

Ma marque est-elle couverte ?

Nous suivons plus de 26 000 marques dans un catalogue de 260 000 produits. L’outil de couverture sur la page de la base permet de vérifier une marque et son nombre de produits. Si une marque dont vous avez besoin est absente, dites-le-nous : vos demandes alimentent la prochaine mise à jour.

Quelles catégories de produits sont couvertes ?

Les soins de la peau constituent la principale catégorie, mais le catalogue couvre l’ensemble des rayons beauté. Répartition approximative des produits : • Soins de la peau : 44 % • Soins capillaires : 15 % • Maquillage : 10 % • Corps et bain : 9 % • Protection solaire : 6 % • Autres : 16 %

Dans quelle proportion les champs sont-ils renseignés ?

Nous publions les taux de remplissage pour vous permettre de connaître les données disponibles. Les taux des champs d’ingrédients sont pondérés par leur fréquence d’apparition dans la base ; les taux des champs produits représentent une part des produits : • Texte des ingrédients disponible : ~87% • Ingrédients structurés disponibles : ~81% • Fonctions des ingrédients : ~94% • Numéro CAS : ~86% • Numéro CE : ~75% • Classification des ingrédients : ~33% (catégories éditoriales : actifs principaux, actifs complémentaires, sensibilisants) • Indice de comédogénicité : ~23% • Indice d’irritation : ~23% • Concentration : <1% (renseignée uniquement lorsque le fabricant la publie ; jamais estimée) • Codes-barres GTIN (UPC/EAN) : ~59% (part des produits possédant au moins un code) Nous renseignons la concentration uniquement lorsque le fabricant la publie, sans estimation ni extrapolation. Les évaluations portent surtout sur les ingrédients fréquemment utilisés, les actifs et les sensibilisants connus, plutôt que sur chaque excipient présent à l’état de trace. L’échantillon gratuit vous permet de consulter les champs et formats disponibles.

Comment les informations sur les ingrédients sont-elles préparées ?

Nous rassemblons des fiches produits publiques provenant de plusieurs sources et normalisons les noms d’ingrédients à l’aide d’un dictionnaire commun. Les fiches incluent les fonctions, évaluations et identifiants chimiques disponibles. La couverture varie selon le champ ; les pourcentages ci-dessus indiquent ce qui est renseigné. Les alias de produits et d’ingrédients préservent les liens vers les fiches regroupées lors du dédoublonnage.

À quelle fréquence les données sont-elles mises à jour ?

Des contrôles continus alimentent une actualisation de la base principale tous les deux mois. La dernière date du 3 novembre 2026.

Licence et utilisation

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.

Les mêmes règles s’appliquent-elles aux données obtenues par l’API ?

Oui. Vous pouvez afficher les données à vos utilisateurs, les stocker dans la base de votre application et continuer à utiliser les données stockées après la fin de votre abonnement. Elles ne peuvent pas servir à reconstruire et redistribuer le catalogue, ni être revendues ou exposées sous forme de flux de données concurrent. Pour disposer du catalogue complet hors ligne, choisissez la base téléchargeable.

Achat et assistance

Faut-il choisir l’API ou la base téléchargeable ?

Choisissez l’API pour accéder aux données actuelles sans héberger le catalogue et adapter votre offre à votre consommation. Choisissez la base sous licence pour disposer du catalogue complet hors ligne, réaliser des analyses approfondies ou entraîner des modèles sur toutes les fiches. Vous payez une seule fois et utilisez les fichiers sans abonnement. Consultez le comparatif complet.

Puis-je essayer avant d’acheter ?

Oui. L’échantillon gratuit de 1 000 produits comprend un fichier JSONL, cinq tables CSV décrivant les produits et leurs ingrédients, un guide du schéma et les images correspondantes. Les nouveaux clients API qui choisissent Starter ou Pro, y compris les variantes Barcode, bénéficient de sept jours d’essai et de 100 requêtes au total. Résiliez avant l’échéance pour éviter le passage automatique à l’offre payante.

Quelle est votre politique de remboursement ?

La vente d’une version de la base est définitive dès l’émission du lien de téléchargement ; l’échantillon gratuit vous permet d’en vérifier l’adéquation avant l’achat. Les frais mensuels de l’API sont prélevés d’avance et ne sont pas remboursés en cas de résiliation en cours de mois. L’accès continue jusqu’à la fin de la période réglée ; les derniers dépassements sont facturés à la fin du mois de facturation. Le passage à une offre supérieure crédite le temps prépayé non utilisé lors du démarrage de la nouvelle offre. Résiliez l’essai avant son échéance pour éviter le premier prélèvement.

Comment obtenir de l’aide ?

Écrivez à [email protected]. Nous répondons à vos questions sur la couverture des marques ou des marchés, le schéma, l’intégration, les changements d’offre et la facturation.

Contact

Parlons de votre projet

Écrivez-nous

[email protected]

Nous répondons généralement sous 3 jours ouvrés.

Pour nous aider à vous répondre, précisez votre projet, si vous vous intéressez à la base de données ou à l’API, ainsi que les technologies utilisées.

Nous pouvons vous accompagner sur

Abonnements et base de données

Offres API, factures, contenu de la base téléchargeable et tarifs des nouvelles versions.

Données et intégration

Points d’accès de l’API, champs disponibles, formats, normalisation INCI et adéquation avec votre projet.

Assistance client

Clés API, changement d’offre, téléchargements, documentation des champs et nouvelles versions.

API hébergée

Intégrez les données avec l’API

Consultez tout le catalogue via HTTPS. Choisissez une offre à partir de 40 $ US/mois avec 10 000 appels inclus et commencez par l’essai gratuit. Créez votre clé depuis le tableau de bord en quelques minutes.

Vous préférez une version complète à télécharger ? Découvrir la base sous licence →