Das Wichtigste: Open Beauty Facts bietet eine kostenlose, offene Kosmetikdatenbank, die von der Community gepflegt wird und auf Barcodes ausgerichtet ist. The Beauty API bietet einen normalisierten Katalog und eine REST-API mit Zugang zu rund 260.000 Produkten und 26.000 Inhaltsstoffen. Der Katalog verknüpft Produktdatensätze mit Informationen zu ihren Inhaltsstoffen und enthält Bilder. Die passende Lösung hängt davon ab, ob Sie eine offene Datenbank nutzen und mitgestalten oder bereits aufbereitete Daten in Ihre Anwendung integrieren möchten.

Für eine Hautpflege-App, eine Inhaltsstoffsuche oder einen E-Commerce-Katalog benötigen Sie nutzbare Produktdatensätze. Hier erfahren Sie, wie sich die beiden Angebote in ihrer Funktionsweise, Struktur und Lizenz unterscheiden. Wir entwickeln The Beauty API und erläutern die Unterschiede aus unserer Perspektive als Anbieter.

So funktioniert Open Beauty Facts

Open Beauty Facts ist das Kosmetikprojekt der Open-Food-Facts-Familie. Mitwirkende können einen Barcode scannen, Verpackungsfotos hinzufügen und die Inhaltsstoffliste eingeben. Ein Produkt wird mit einer GET-Anfrage abgerufen:

curl "https://world.openbeautyfacts.org/api/v2/product/3600523281176"

// Gekürzte Antwort
{
  "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"
  }
}

Die Antwort hängt von den Informationen der Mitwirkenden ab: Barcode, Name, Marke, Fotos, Inhaltsstofftext und eine daraus abgeleitete strukturierte Liste. Die Datenbank steht auch zum Download bereit. Das Projekt bittet API-Nutzer, ihre Anfragen zu begrenzen und Antworten zwischenzuspeichern.

Das bietet The Beauty API

Die Produktdatensätze von The Beauty API enthalten Inhaltsstofflisten in der Reihenfolge ihrer Deklaration sowie Verknüpfungen zu einheitlichen INCI-Bezeichnungen. Zu den verfügbaren Informationen gehören Funktionen und Bewertungen der Inhaltsstoffe, Werte für Reizpotenzial und Komedogenität, CAS- und EG-Nummern sowie Synonyme. Fünf Merkmale beschreiben das Vorhandensein von Duftstoffen, austrocknenden Alkoholen, Parabenen, Sulfaten und Silikonen. Bilder ergänzen die Datensätze.

Sie können die gehostete API nutzen oder The Complete Archive kaufen: CSV-, JSONL- und SQLite-Dateien mit einem Bildarchiv von ~23GB.

curl "https://api.thebeautyapi.com/v1/products/search?q=niacinamide" \
  -H "x-api-key: YOUR_API_KEY"

// Anschließend den vollständigen Datensatz abrufen
curl "https://api.thebeautyapi.com/v1/products/06d9476a-397b-5f61-abc8-640b30a9ae23" \
  -H "x-api-key: YOUR_API_KEY"

// Gekürzte Antwort
{
  "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"
    }
  ]
}

Die Suche berücksichtigt Marke und Produktname. Mit Filtern können Sie den Katalog nach Kategorie, Marke, Herkunft, Formulierungsmerkmalen oder Inhaltsstoff durchsuchen. Tarife mit Barcode-Suche ermöglichen die Suche nach UPC oder EAN. Neue Kunden erhalten eine siebentägige Testphase mit insgesamt 100 Anfragen. Der ausgewählte kostenpflichtige Tarif beginnt nach Ablauf der sieben Tage, sofern Sie nicht kündigen. Die verfügbaren Endpunkte finden Sie in der API-Dokumentation.

Die beiden Angebote im Vergleich

KriteriumOpen Beauty FactsThe Beauty API
ZugangOffene API und DatenbankAPI im Abonnement; Archiv als einmaliger Kauf
Aufbau des KatalogsBeiträge der CommunityBereinigte und normalisierte Daten, in Versionen veröffentlicht
InhaltsstoffeEingegebener Text und strukturierte Darstellung, soweit vorhandenReihenfolge der Deklaration bleibt erhalten, mit Verknüpfungen zu einem INCI-Verzeichnis
Ergänzende InformationenIn den Datensätzen und der Projektdokumentation nachzulesenFunktionen, Bewertungen und chemische Kennungen, je nach Inhaltsstoff
BilderVon Mitwirkenden hochgeladene FotosStandardisierte Produktbilder
BarcodesGrundlage der ProduktsucheVerfügbar in Tarifen mit Barcode-Suche
StrukturFelder je nach Beiträgen ausgefülltFelder und Strukturen in OpenAPI dokumentiert
LizenzODbL für Daten; eigene Lizenzen für BilderKommerzielle Lizenz für die API oder das Archiv

Die Stärken von Open Beauty Facts

  • Offener Zugang. Sie können ein Lern- oder Forschungsprojekt beginnen und die Datenbank herunterladen.
  • Produktsuche per Barcode. Über den Barcode lassen sich Produkte abrufen und neue Einträge ergänzen.
  • Eine Datenbank zum Mitgestalten. Sie können selbst Produkte und zugehörige Informationen hinzufügen.

Die Stärken von The Beauty API

  • Produkte sind mit ihren Inhaltsstoffen verknüpft. Die Bezeichnungen auf den Etiketten sind einem gemeinsamen INCI-Verzeichnis zugeordnet. So erkennen Sie dieselben Inhaltsstoffe in verschiedenen Produkten und können Pflegeprodukte anhand der gewünschten Inhaltsstofffunktionen vorschlagen.
  • Dokumentation für Ihre Integration. OpenAPI-Definitionen und Beispiele erklären die Produkt- und Inhaltsstofffelder.
  • Bilder für Ihren Katalog. Sie ergänzen die Datensätze für Ihre Produktlisten und Detailseiten.
  • Der Katalog auf Ihrer eigenen Infrastruktur. Sie können den gekauften Katalog in Ihre Systeme importieren und für Ihre Anwendung erweitern.

Die unterschiedlichen Lizenzen verstehen

Die ODbL erlaubt die kommerzielle Nutzung mit Pflichten zur Namensnennung und, in den von der Lizenz vorgesehenen Fällen, zur Weitergabe einer abgeleiteten Datenbank unter gleichen Bedingungen. Das ist relevant, wenn Sie eine angereicherte Datenbank für die öffentliche Nutzung aufbauen. Die Bedingungen von The Beauty API unterscheiden zwischen dem Zugang zum gehosteten Dienst und dem Kauf einer Katalogkopie. Unser Lizenzleitfaden erklärt diesen Unterschied.

Die passende Lösung für Ihr Projekt

  • Studienprojekt oder Anwendung mit offenen Daten: Mit Open Beauty Facts können Sie beginnen und selbst mitwirken.
  • Scanner-App ohne Datenbudget: Der offene Zugang ist ein sinnvoller Ausgangspunkt; planen Sie die Verarbeitung der erhaltenen Informationen ein.
  • Inhaltsstoffsuche oder Planer für Hautpflegeroutinen: The Beauty API verknüpft Produkte mit einem INCI-Verzeichnis und den Funktionen der Inhaltsstoffe. So können Sie Produkte passend zu den Vorlieben Ihrer Nutzer suchen. Unser Leitfaden für Empfehlungen zeigt, wie Sie diese Informationen verwenden.
  • E-Commerce-Katalog: Unsere Datensätze, Bilder und Filter erleichtern die Integration. Ergänzen Sie die Barcode-Suche, wenn Ihr Ablauf auf dem Scannen basiert.
  • Analyse oder Modelltraining: The Complete Archive liefert den Katalog als Dateien einschließlich der Bilder.
  • Zum Kennenlernen: Mit unseren kostenlosen Beispieldaten mit 1.000 Produkten können Sie sich die Struktur vor dem Kauf ansehen.

Häufige Fragen

Ist die API von Open Beauty Facts kostenlos?

Ja. Beachten Sie die Vorgaben des Projekts zur Kennzeichnung Ihrer Anwendung, zur Zwischenspeicherung und zur Häufigkeit der Anfragen.

Enthält sie die Inhaltsstoffe von Kosmetika?

Ja, sofern die Informationen hinzugefügt wurden. Die Datensätze können den Text der Deklaration und seine strukturierte Darstellung enthalten.

Darf man sie in einer kostenpflichtigen App verwenden?

Ja, unter den Bedingungen der ODbL, insbesondere zur Namensnennung und, soweit anwendbar, zur Weitergabe unter gleichen Bedingungen.

Kann man The Beauty API testen?

Ja, mit der siebentägigen Testphase mit insgesamt 100 Anfragen oder den kostenlosen Beispieldaten des Archivs.

Unterstützt The Beauty API Barcodes?

Ja, über GET /v1/products/barcode/{barcode} in den entsprechenden Tarifen. Gleichwertige Darstellungen derselben GTIN mit führenden Nullen werden erkannt.

Die passende Datengrundlage für Ihre Anwendung

Open Beauty Facts ist eine nützliche offene Ressource für gemeinschaftliche Projekte und die Barcode-Suche. The Beauty API bietet Ihnen bereinigte und normalisierte Produktdatensätze mit verknüpften Informationen zu ihren Inhaltsstoffen. Sie können sie per API abrufen oder aus dem Archiv importieren. Entscheiden Sie danach, welche Informationen Ihre Anwendung benötigt und welche Arbeit Sie selbst übernehmen möchten.