260.000 Produkte · 26.000 Marken · 26.000 Inhaltsstoffe

Die umfassendste API für Kosmetikprodukte

Rufen Sie normalisierte Produkt- und Inhaltsstoffdatensätze ab: Inhaltsstoffe in der Reihenfolge auf dem Etikett, forschungsbasierte Bewertungen zu Reizpotenzial und Komedogenität, chemische Kennungen und Produktbilder auf weißem Hintergrund.

Datenstand: 3. November 2026. Änderungen ansehen.

7 Tage kostenlos testen · Tarife ab 40 $/Monat · 10.000 API-Aufrufe enthalten · Jederzeit kündbar

Beispiel
GEThttps://api.thebeautyapi.com/v1/products/search?q=the+ordinary+niacinamide&page=1
Vollständige AntwortAPI-Referenz
Für KI-Programmierassistenten

Fügen Sie diese englischen Anweisungen in Ihre CLAUDE.md, AGENTS.md oder Editor-Regeln ein, damit Ihr Assistent die API richtig verwendet. Auch verfügbar unter https://thebeautyapi.com/agent.md.

Alle 23 Zeilen anzeigen ▾
# The Beauty API: instructions for coding agents
Base URL: https://api.thebeautyapi.com/v1 (JSON over HTTPS)
Auth: send the header x-api-key: $BEAUTY_API_KEY on every /v1 request. Keep the key in an environment variable, never in code or in this file.
Reference: https://thebeautyapi.com/docs.md | Spec: https://api.thebeautyapi.com/openapi.json | Keys: https://thebeautyapi.com/dashboard

## Endpoints
- Health: GET /health (no key)
- Search products: GET /v1/products/search?q=&page=
- Filter products: GET /v1/products?category=&brand=&origin=&fragrance_free=&alcohol_free=&paraben_free=&sulfate_free=&silicone_free=&has_ingredient=&excludes_ingredient=&page=
- Get a product: GET /v1/products/{id}
- Batch products: POST /v1/products/batch (body {"ids": [uuid, ...]}, max 50)
- Search ingredients: GET /v1/ingredients/search?q=&page=
- Get an ingredient: GET /v1/ingredients/{id}

## Rules
1. Find a product with search, then fetch the full record with GET /v1/products/{id}. Search and filter return slim records (id, brand, name, category, image_url); detail and batch return the full product record. See Ingredients data in the reference for the flat, sectioned and component formats.
2. Every word in q must appear in the product's brand or name, in any order. Send the brand plus the distinctive part of the name ("CeraVe Moisturizing Cream"), never a full retail title. Case, accents and punctuation are ignored; the last word may be partial.
3. When pagination.total is 0 the response carries a no_match object: drop the word no_match.hint names and retry. An empty result does not mean the brand is missing.
4. Pages hold 20 results; page runs 1 to 51 and anything higher returns 400. Read pagination.total and pagination.has_more; above 1,020 matches, narrow with filters instead of paging.
5. Batch takes up to 50 ids and is billed per item (50 ids = 50 calls); unknown ids come back as null in the same positions.
6. Errors are JSON {statusCode, error, message} and message says what to change. 403 is a missing or revoked key. 429 is the rate limit; no rate-limit headers are sent, so back off exponentially.
7. image_url can be null.
8. Deduplication aliases resolve older product and ingredient IDs to surviving records. Unknown or retired ingredient IDs return 400 in ingredient filters.
260.000
Produkte
26.000
Marken
Schwerpunkt Hautpflege
26.000
Inhaltsstoffdatensätze
5,5M
Inhaltsstoffeinträge
durchschnittlich 20,2 pro Produkt, in der Reihenfolge auf dem Etikett

Die API

Strukturierter Zugriff auf den gesamten Katalog

Greifen Sie über eine einheitliche JSON-Schnittstelle auf unseren Produktkatalog zu. Die Inhaltsstoffe sind standardisierten INCI-Bezeichnungen zugeordnet. Sie authentifizieren sich mit einem API-Schlüssel und nutzen versionierte Pfade. Ein anbieterspezifisches SDK ist nicht erforderlich.

GET /v1/products/search

Suchen

Suchen Sie nach Marken- und Produktnamen. Die API liefert kompakte Datensätze, die Sie direkt in Ihren Ergebnislisten anzeigen können.

GET /v1/products

Filtern und entdecken

Filtern Sie nach Kategorie, Marke, Herkunft und fünf Formulierungsmerkmalen. Legen Sie zugleich fest, welche Inhaltsstoffe enthalten sein sollen und welche Sie ausschließen möchten. Eine einzige Anfrage genügt.

GET /v1/products/{id}

Vollständiger Produktdatensatz

Inhaltsstofflisten in der Reihenfolge auf dem Etikett, mit Funktionsklassen, Bewertungen zu Reizpotenzial und Komedogenität sowie CAS-, EG-, IUPAC- und Ph.-Eur.-Kennungen.

POST /v1/products/batch

Mehrere Produkte gleichzeitig abrufen

Bis zu 50 vollständige Datensätze pro Anfrage, zurückgegeben in der Reihenfolge der übermittelten IDs.

GET /v1/ingredients/{id}

Wissenschaftliche Informationen zu Inhaltsstoffen

26.000 normalisierte Inhaltsstoffdatensätze: Funktionsklassen, Bewertungen zu Reizpotenzial und Komedogenität sowie CAS-, EG-, IUPAC- und Ph.-Eur.-Kennungen.

GET image_url

Produktbilder auf weißem Hintergrund

Professionelle Produktfotografien auf weißem Hintergrund, die Sie direkt in Ihrer Benutzeroberfläche verwenden können.

Data Scientists weltweit vertrauen uns

Hugging FaceHugging Face
KaggleDatarade

Integration

So funktioniert es

Erstellen Sie einen Schlüssel in Ihrem Entwickler-Dashboard und übergeben Sie ihn im Header Ihrer Anfragen. So einfach ist die Integration.

01

Tarif wählen und Schlüssel erhalten

Wählen Sie Ihren Tarif im Dashboard und erstellen Sie in wenigen Minuten einen API-Schlüssel. Bis zu 2 aktive Schlüssel pro Konto. Sie können Schlüssel jederzeit erstellen, anzeigen und widerrufen.

Ihr Dashboard
Abonnement     Pro · 100.000 API-Aufrufe/Monat
API-Schlüssel  ····························9xYz · aktiv
Als Header     x-api-key: <Ihr Schlüssel>
02

In Ihre bestehende Anwendung integrieren

Nutzen Sie HTTPS und JSON mit den Technologien, die Sie bereits einsetzen. Kombinieren Sie Filter, um passende Produkte mit einer einzigen Anfrage zu finden. Die Ergebnisse lassen sich seitenweise abrufen.

Duftstofffreie Hautpflege mit einer Anfrage
$ curl "https://api.thebeautyapi.com/v1/products?\
category=skincare&fragrance_free=true&page=1" \
    -H "x-api-key: $BEAUTY_API_KEY"

{
  "results": [ …20 Produkte… ],
  "pagination": { "page": 1, "has_more": true, "total": 43669 }
}
03

Gestalten Sie die Ansicht für Ihre Nutzer

Nutzen Sie die API-Antwort für eine Produktansicht mit Hinweisen zur Zusammensetzung, Inhaltsstoffbewertungen und Prüfungen auf problematische Inhaltsstoffkombinationen. Die Darstellung gestalten Sie selbst.

The Ordinary

Niacinamide 10% + Zinc 1%

alkoholfreiduftstofffrei
Niacinamide10%direkte Wirkstoffe
Zinc PCA1%unterstützende Wirkstoffe
Reizpotenzial0/5
Komedogenität0/5

Diese Beispielansicht entsteht aus einer einzigen API-Antwort. Die Darstellung gestalten Sie selbst.

Abdeckung

Ist Ihre Marke enthalten?

Wir erfassen mehr als 26.000 Marken mit 260.000 Produkten, mit Schwerpunkt Hautpflege. Suchen Sie nach einer Marke und sehen Sie sofort, welche Produktdaten enthalten sind.

Zum Beispiel:

Verteilung nach Kategorien

Ungefährer Anteil am Katalog
Hautpflege44%
Haarpflege15%
Make-up10%
Körperpflege und Badeprodukte9%
Sonnenschutz6%
Sonstige16%

Verfügbare Inhaltsstoffdaten

Im Katalog der gehosteten API.

Inhaltsstoffliste als Text verfügbar
~83 %
Inhaltsstoffdeklaration als Text.
Strukturierte Inhaltsstoffdaten verfügbar
~76 %
Die Inhaltsstoffe liegen als einzelne Einträge vor. Vorhandene Abschnitte und Bestandteile von Sets bleiben dabei erhalten.

Verfügbare Angaben zu Inhaltsstoffen

Die Prozentwerte beziehen sich auf die Inhaltsstoffeinträge im Katalog. Ein Inhaltsstoff, der in mehreren Produkten vorkommt, wird entsprechend mehrfach gezählt.

Funktionen der Inhaltsstoffe
~94 %
CAS-Nummer
~86 %
EG-Nummer
~75 %
Einordnung der InhaltsstoffeRedaktionelle Einordnung: direkte Wirkstoffe, unterstützende Wirkstoffe und sensibilisierende Stoffe
~33 %
Komedogenitätsbewertung
~23 %
Bewertung des Reizpotenzials
~23 %
KonzentrationNur erfasst, wenn der Hersteller sie öffentlich angibt; keine Schätzwerte
<1 %

Barcode-Abdeckung

GTIN-Barcodes (UPC/EAN)Anteil der Produkte mit mindestens einem Code
~61 %

Für wen die Daten gedacht sind

Für Teams, die Beauty-Anwendungen entwickeln

Ob Sie Empfehlungssysteme entwickeln oder Rezepturen untersuchen: Unsere aufbereiteten Daten ersparen Ihrem Team Monate beim Sammeln und Vereinheitlichen von Produktinformationen.

E-Commerce und Einzelhandel

Ergänzen Sie Ihren Shop und Ihre Suchergebnisse mit unseren Kosmetikproduktdaten. Informationen zu Inhaltsstoffen und Hinweise zur Zusammensetzung unterstützen Kaufentscheidungen und helfen, Retouren zu reduzieren.

Mögliche Anwendungen:

  • Ausführliche Produktseiten mit Inhaltsstoffinformationen, die Besucher über die organische Suche gewinnen
  • Aussagekräftige Produktseiten mit Inhaltsstofflisten, die Kaufentscheidungen erleichtern
  • Filter nach Komedogenität und Reizpotenzial für empfindliche Haut
  • Vertrauen schaffen mit klaren Angaben zur Zusammensetzung und passenden Clean-Beauty-Kennzeichnungen

Gründer im Beauty-Tech-Bereich

Sparen Sie sich Monate der Datensammlung. Starten Sie direkt mit der Entwicklung Ihrer App für Pflegeroutinen oder Hautanalysen.

Mögliche Anwendungen:

  • Prüfung auf problematische Inhaltsstoffkombinationen anhand strukturierter Listen
  • Personalisierte Pflegeroutinen auf Grundlage von Komedogenität und Reizpotenzial
  • Produktempfehlungen nach Hauttyp
  • Inhaltsstoffbasierte Filtersysteme für 260.000 Produkte

Marktforschung und F&E

Vergleichen Sie Rezepturen weltweit. Verfolgen Sie Inhaltsstofftrends in 260.000 Kosmetikprodukten und erkennen Sie Marktlücken. Nutzen Sie dafür die API oder den lizenzierten Datensatz.

Mögliche Anwendungen:

  • Produkte von Wettbewerbern weltweit vergleichen
  • Analyse von Inhaltsstoff- und Rezepturtrends in 260.000 Produkten
  • Training von KI-Modellen zur Untersuchung von Zusammenhängen zwischen Verpackung und Inhaltsstoffen
  • Präzise Computer-Vision-Modelle für automatisierte Kontrollen im Einzelhandel
The Beauty API hat einen Teil der in Bestie verwendeten Kosmetikproduktdaten bereitgestellt. Die sauberen, gut strukturierten Produktdaten haben uns geholfen, unseren Katalog zu erweitern. Vielen Dank für die Unterstützung!
Pavan KGründer von Bestie

API-Tarife

Übersichtliche Monatstarife

Jeder Tarif bietet Zugriff auf den gesamten Katalog. Die Tarife unterscheiden sich in den enthaltenen API-Aufrufen, den zulässigen Anfrageraten und dem Barcode-Zugriff.

Sie erhalten ein neues Kontingent zu Beginn jedes Abrechnungsmonats · Jederzeit kündbar

Am beliebtesten

Starter

60 $/Monat

Das Starter-Kontingent mit Barcode-Suche.

7 Tage kostenlos testen. Die Monatsgebühr wird im Voraus berechnet, Mehrverbrauch am Ende des Abrechnungsmonats.

  • Inklusive 10.000 API-Aufrufe pro Monat
  • Vollständige Produkt- und Inhaltsstoffdaten
  • Barcode-Suche (GTIN/UPC/EAN → Produkt)
  • Zusätzliche Nutzung: 0,02 $ pro Aufruf (bei Stapelabfragen: pro Eintrag)

Pro

300 $/Monat

Für produktive Anwendungen mit hohem Volumen und Barcode-Suche.

7 Tage kostenlos testen. Die Monatsgebühr wird im Voraus berechnet, Mehrverbrauch am Ende des Abrechnungsmonats.

  • Inklusive 100.000 API-Aufrufe pro Monat
  • Vollständige Produkt- und Inhaltsstoffdaten
  • Barcode-Suche (GTIN/UPC/EAN → Produkt)
  • Höhere Anfrageraten
  • Zusätzliche Nutzung: 0,02 $ pro Aufruf (bei Stapelabfragen: pro Eintrag)

Der Datensatz

Den vollständigen Katalog herunterladen

Sie erhalten denselben Katalog auch als feste Version zum einmaligen Kauf: in SQLite, CSV und JSONL, einschließlich des vollständigen Bildarchivs. Hosten Sie die Daten selbst, führen Sie eigene Abfragen aus oder nutzen Sie sie zum Modelltraining.

260.000 Produkte · 260.000 Bilder

The Complete Archive

260.000 normalisierte Produktdatensätze, ein vollständiges Inhaltsstoffverzeichnis mit Funktionen und Komedogenitätsbewertungen sowie sämtliche Produktbilder.

1.500 $
feste Katalogversion zum einmaligen Kauf
  • 260.000 Produkte mit Marke, Name, Kategorie, Herkunft und Formulierungsmerkmalen
  • Inhaltsstofflisten in der Reihenfolge auf dem Etikett, mit dem Inhaltsstoffverzeichnis verknüpft
  • Normalisiertes Inhaltsstoffverzeichnis: Reizpotenzial, Komedogenität, Klassifikationen und Funktionen
  • 260.000 Produktbilder (~23GB), über IDs mit den Datensätzen verknüpft
  • GTIN-Barcodes (UPC/EAN im GTIN-14-Format) für ~59 % der Produkte
  • Formate JSONL, SQLite und CSV
  • Vollständige Schemadokumentation
Alle Details ansehen →

Beispieldaten

Die Daten vor dem Kauf ausprobieren

Laden Sie Beispieldaten mit 1.000 Produkten und Schemadokumentation herunter oder prüfen Sie die Markenabdeckung auf der Datensatzseite.

CSV + JSONL + 1.000 Bilder · Keine Zahlung erforderlich

Datensatz und API im Vergleich

Fragen

Häufig gestellte Fragen

Hier finden Sie die wichtigsten Antworten. Die vollständigen FAQ erläutern Abdeckung, Nutzung und Details zum Datensatz.

Wie erhalte ich Zugriff auf die API?

Registrieren Sie sich im Dashboard und wählen Sie Starter oder Pro, jeweils mit oder ohne Barcode. Sie erhalten sieben kostenlose Testtage mit insgesamt 100 Anfragen, gemeinsam für alle Ihre API-Schlüssel. Erstellen Sie einen Schlüssel und authentifizieren Sie Ihre Anfragen mit dem Header x-api-key. Nach 100 Anfragen pausiert der Zugriff bis zum Wechsel auf einen kostenpflichtigen Tarif. Das Erreichen dieser Grenze löst keine vorzeitige Zahlung aus. Nach sieben Tagen beginnt der gewählte Tarif automatisch, sofern Sie nicht kündigen. Die monatliche Grundgebühr wird im Voraus berechnet, Mehrverbrauch am Ende des Abrechnungsmonats. Kostenpflichtige Tarife beginnen bei 40 $/Monat. Endpunkte und Beispiele finden Sie in der Dokumentation.

Wie funktionieren Kontingente und Mehrverbrauch?

Der Testzeitraum umfasst insgesamt 100 Anfragen innerhalb von sieben Tagen, gemeinsam für alle Ihre Schlüssel. Ein Stapel zählt als eine Anfrage. Authentifizierte Anfragen, die die API erreichen, verbrauchen dieses Kontingent, auch wenn sie einen Fehler zurückgeben. Während des Tests entstehen keine Mehrverbrauchskosten. Nach 100 Anfragen liefert die API 429. Für einen sofortigen Wechsel auf einen kostenpflichtigen Tarif klicken Sie im Dashboard auf „Convert to paid plan“. Sie können auch den automatischen Wechsel am Ende des Testzeitraums abwarten. Kostenpflichtige Tarife enthalten 10.000 Aufrufe bei Starter und 100.000 bei Pro. Die monatliche Grundgebühr wird zu Beginn jedes Abrechnungsmonats berechnet. Jeder zusätzliche Aufruf kostet 0,02 $ und wird am Ende dieses Monats abgerechnet. Bei kostenpflichtigen Tarifen zählt jeder angeforderte Eintrag einer Stapelabfrage als ein Aufruf. Das Kontingent wird zu Beginn jedes Abrechnungsmonats zurückgesetzt; zusätzlich gelten eine Obergrenze zum Schutz vor Missbrauch und Begrenzungen der Anfragerate. Erst nach Abschluss einer Rechnung gemeldete Aufrufe werden weder berechnet noch übertragen. Testanfragen zählen nicht zum kostenpflichtigen Verbrauch.

Was enthält die Datenbank?

Eine vollständige Katalogversion: 260.000 Produkte mit Marke, Kategorie, Herkunftsland und Formulierungsmerkmalen (Duftstoffe, austrocknender Alkohol, Parabene, Sulfate, Silikone); Inhaltsstofflisten in der Reihenfolge auf dem Etikett, verknüpft mit einem normalisierten Verzeichnis mit Funktionen, Werten zu Reizpotenzial und Komedogenität, Bewertungen und chemischen Kennungen; bekannte GTIN-Barcodes und das vollständige Bildarchiv (~23GB, 260.000 Bilder). Sie erhalten CSV-, JSONL- und SQLite-Dateien, eine vollständige Beschreibung der Datenfelder und eine Anleitung zum Schema.

Was darf ich mit der Datenbank machen?

Mit dem Kauf erhalten Sie eine Katalogversion, die Sie zeitlich unbegrenzt nutzen können. Sie dürfen die Daten in Ihre Systeme integrieren, Produkte und Analysen entwickeln und Ihren Nutzern Informationen anzeigen, einschließlich der zugehörigen Bilder für Ihre eigene Nutzung. Die Rohdateien (CSV, JSONL, SQLite und Bilder) dürfen Sie nicht weitergeben, weiterverkaufen oder öffentlich zum Download für Dritte bereitstellen. Spätere Versionen werden separat als differenzielle Aktualisierungen angeboten.

Jetzt starten

Die API für Ihre Kosmetikproduktdaten

Mit einem API-Schlüssel erhalten Sie Zugriff auf 260.000 normalisierte Produkte, 26.000 Inhaltsstoffdatensätze und Produktbilder auf weißem Hintergrund. Testen Sie kostenlos oder nutzen Sie die API im Produktivbetrieb ab 40 $/Monat. Für die Nutzung auf Ihrer eigenen Infrastruktur erhalten Sie den vollständigen Datensatz auch zum einmaligen Kauf.