Das Wichtigste: The Beauty API bietet zwei Möglichkeiten, den Katalog zu nutzen. Die gehostete API ist ein Dienst im Abonnement: Ihre Anwendung sendet Anfragen, erhält Antworten und kann sie anzeigen und zwischenspeichern. Nach Ende des bezahlten Zugangszeitraums enden der API-Zugang, das Bildhosting und der Bezug neuer Daten. The Complete Archive ist ein einmaliger Kauf: Sie laden CSV-, JSONL- und SQLite-Dateien sowie Bilder herunter und behalten sie dauerhaft. Wählen Sie die API für einen gehosteten Abfragedienst oder das Archiv, um eine vollständige Kopie in Ihren eigenen Systemen zu nutzen.
Die Entscheidung hängt davon ab, wie Sie die Daten nutzen und hosten möchten. Beide Angebote können eine Produktsuche oder ein Empfehlungssystem unterstützen. Dieser Leitfaden erklärt, was Sie jeweils erhalten, was Sie behalten können und welche Aufgaben damit verbunden sind.
Einen Dienst abfragen oder Dateien herunterladen
Eine herunterladbare Datenbank besteht aus Dateien. Mit The Complete Archive importieren Sie den Katalog in eine Tabellenkalkulation, eine Datenbank, einen Datenverarbeitungsprozess oder ein Werkzeug zum Modelltraining. Sie können Datensätze abrufen, die mit jedem Produkt verknüpften Inhaltsstoffe finden und die Daten in Ihren eigenen Werkzeugen filtern.
Eine API ist ein Dienst. Die Daten werden bei uns gehostet, und Ihre Anwendung fordert über HTTPS an, was sie benötigt: eine Seite mit 20 Suchergebnissen, einen Produktdatensatz oder bis zu 50 Produkte in einer Stapelabfrage. Die API liefert den vollständigen Katalog nicht als Datei. Für eine vollständige Kopie ist der Kauf des Archivs vorgesehen.
Daraus ergibt sich, wer die Daten hostet, wie sie aktualisiert werden, wie Sie bezahlen und welche Daten Sie behalten können.
Was Sie erhalten
Mit der gehosteten API: eine REST-API unter api.thebeautyapi.com mit Produktsuche, Filtern nach Kategorie, Marke, Merkmalen und Inhaltsstoffen, Einzel- und Stapelabrufen sowie Inhaltsstoffdatensätzen. Tarife mit Barcode-Zugriff enthalten zusätzlich die Barcode-Suche. Die Datensätze zeigen Inhaltsstoffe in der Reihenfolge auf dem Etikett, Verknüpfungen zu einem INCI-Verzeichnis, verfügbare Funktionen und Bewertungen sowie URLs der gehosteten Bilder. Neue Kunden erhalten eine siebentägige Testphase mit insgesamt 100 Anfragen. Danach beginnt der ausgewählte kostenpflichtige Tarif, sofern Sie nicht kündigen. Abonnements beginnen bei 40 US-Dollar pro Monat mit 10.000 enthaltenen Aufrufen. Weitere Informationen finden Sie in der Dokumentation.
Mit The Complete Archive: eine Lizenz für die gekaufte Katalogversion mit rund 260.000 Produkten, Inhaltsstoffen in der Reihenfolge auf dem Etikett und Verknüpfungen zum INCI-Verzeichnis, rund 26.000 Inhaltsstoffdatensätzen, bekannten GTINs und einem Bildarchiv von ~23GB. Die Formate sind CSV, JSONL und SQLite. Die Archivseite beschreibt die angebotene Version.
Was Sie behalten können
Mit der API können Sie die erhaltenen Daten in Ihrer Anwendung anzeigen und zwischenspeichern. Nach einer Kündigung bleiben Zugang und Bildhosting bis zum Ende des bezahlten Zeitraums aktiv. Danach enden Zugang und Aktualisierungen. Eine dauerhafte Kopie des vollständigen Katalogs erhalten Sie mit dem Kauf des Archivs. Die Nutzungsbedingungen untersagen die Weiterverbreitung der API-Daten als eigenständige Datenbank, Datenfeed oder öffentliche API sowie die Extraktion über die normale Nutzung einer Anwendung hinaus.
Die API-Bilder sind über image_url zugänglich und dürfen zwischengespeichert und über Ihr eigenes Auslieferungsnetzwerk bereitgestellt werden. Unser Bildhosting endet mit dem Zugang zum Dienst. Beim Archiv gehören die Bilddateien zum Download.
Mit The Complete Archive behalten Sie Dateien und Bilder ohne Abonnement. Sie können sie importieren, einen erweiterten Katalog für Ihre Anwendung erstellen, Modelle trainieren und die Bilder hosten. Die Lizenz erlaubt weder die Weiterverbreitung oder den Weiterverkauf der Rohdateien noch die Erstellung eines konkurrierenden Datenprodukts.
So werden die Daten aktualisiert
Mit der API erhalten Sie Zugang zu neuen Produkten und Korrekturen, sobald der Dienst aktualisiert wird. Das Archiv entspricht der gekauften Version. Künftige Versionen sind nicht automatisch enthalten; Sie können eine Aktualisierung anfordern, die je nach Umfang der aktualisierten Daten gesondert berechnet wird.
Mit der API entfällt für Sie der Import neuer Versionen. Beim Archiv bestimmen Sie selbst, wann Sie Ihren Katalog aktualisieren. Das Versionsprotokoll zeigt die veröffentlichten Änderungen.
Die Kennungen unterscheiden sich
Die API verwendet UUIDs für Produkte und Inhaltsstoffe, beispielsweise 06d9476a-397b-5f61-abc8-640b30a9ae23. The Complete Archive verwendet ganzzahlige Kennungen in SQLite und für die Beziehungen zwischen Produkten, Inhaltsstoffen und Zeilen in product_ingredients. Es gibt keine öffentliche Zuordnung zwischen den beiden Systemen: Eine Archivzeile lässt sich nicht allein über ihre Kennung direkt mit einem API-Datensatz verknüpfen.
Entscheiden Sie, welches System in Ihrer Anwendung maßgeblich sein soll. Für einen Abgleich zwischen beiden müssen Produktidentität, Variante und Formulierung geprüft werden; ein ähnlicher Name allein belegt keine Übereinstimmung.
Die Angebote im Vergleich
| Kriterium | Gehostete API | The Complete Archive |
|---|---|---|
| Zugang | Gehosteter Dienst für API-Abfragen | Dateien des vollständigen Katalogs |
| Zahlung | Monatliches Abonnement ab 40 US-Dollar; siebentägige Testphase mit insgesamt 100 Anfragen | Einmaliger Kauf |
| Bereitstellung | JSON; Seiten mit 20 Ergebnissen; Stapel mit höchstens 50 Kennungen | CSV, JSONL, SQLite und Bilder |
| Aktualisierungen | Im Dienst bereitgestellte Versionen | Gekaufte Version; kostenpflichtige Aktualisierungen auf Anfrage |
| Zwischenspeicherung | In Ihrer Anwendung; Zugang und Hosting enden mit dem bezahlten Zeitraum | Dateien bleiben dauerhaft erhalten |
| Bilder | Gehostete URLs während des Zugangs zum Dienst | Archiv mit ~23GB enthalten |
| Vollständiger Katalog als Dateien | Nein | Ja |
| Kennungen | UUIDs | Ganzzahlen |
| Barcodes | Suche in den entsprechenden Tarifen | Tabelle product_barcodes |
| Modelltraining | Keine vollständige Kopie enthalten | Von der Lizenz abgedeckte Nutzung |
| Erstattungen | Gebühren nicht erstattungsfähig, keine anteilige Erstattung | Endgültiger Kauf; Beispieldaten vor dem Kauf verfügbar |
| Hosting und Wartung | Wir betreiben den Datendienst | Sie betreiben Ihre eigenen Systeme |
Die passende Lösung für Ihr Projekt
- Anwendung oder Shop, der Datensätze bei Bedarf abruft: Die API liefert den gehosteten Dienst. Unser Leitfaden für Empfehlungen zeigt die erforderlichen Aufrufe.
- Katalog für Ihre eigenen Systeme: Importieren Sie The Complete Archive und verwenden Sie seine Kennungen für Ihre Beziehungen.
- Analyse, Forschung oder maschinelles Lernen: Das Archiv bündelt Daten und Bilder für Ihre Verarbeitung.
- Suche nach einem Scan: Ein API-Tarif mit Barcode-Suche liefert Datensätze, ohne dass Sie den Katalog selbst hosten.
- Dauerhafte Kopie und selbst gewählte Aktualisierungen: Mit dem Archiv und regelmäßigen Aktualisierungen kontrollieren Sie den Zeitplan Ihrer Importe. Die API bietet keine Abfrage, die ausschließlich Änderungen seit Ihrer Archivversion liefert.
Häufige Fragen
Enthalten API und Archiv dieselben Daten?
Sie stammen aus demselben Katalog, aber Format und Version können sich unterscheiden. Das Archiv bleibt auf dem Stand der gekauften Version; der Dienst kann neue Versionen oder Korrekturen erhalten.
Kann man den gesamten Katalog über die API herunterladen?
Nein. The Complete Archive ist für eine vollständige und dauerhafte Kopie vorgesehen. Die API beantwortet die Anfragen Ihrer Anwendung.
Was passiert nach einer Kündigung?
API-Zugang und Bildhosting bleiben bis zum Ende des bezahlten Zeitraums bestehen. Danach enden der Zugang zum Dienst und die Aktualisierungen. Ihr Code und Ihre eigenen Nutzerdaten bleiben Ihre.
Kann das Abonnement erstattet werden?
Sie können jederzeit kündigen. Abonnementgebühren werden nicht erstattet. Auch für angebrochene Monate erfolgt keine anteilige Erstattung. Neue Kunden können die API während der Testphase prüfen, bevor der ausgewählte kostenpflichtige Tarif beginnt.
Wie kann ich die Angebote vor der Entscheidung ausprobieren?
Nutzen Sie die siebentägige Testphase mit insgesamt 100 Anfragen oder die kostenlosen Beispieldaten mit 1.000 Produkten, um mit den Archivdateien zu arbeiten.
Wo finde ich die genauen Bedingungen?
Die Nutzungsbedingungen beschreiben Lizenz, Einschränkungen, Zahlungen und Aktualisierungen.
Die Daten passend zu Ihrem Projekt nutzen
Wählen Sie die API, wenn Sie Daten über einen gehosteten Dienst abrufen möchten. Wählen Sie das Archiv, wenn Sie den vollständigen Katalog samt Bildern importieren und behalten möchten. Beschreiben Sie uns Ihr Projekt, wenn Sie Unterstützung bei der Auswahl wünschen.

