Die weltweit umfassendste vegane Inhaltsstoffdatenbank.
Über 35.000 Inhaltsstoffe, klassifiziert nach veganem und vegetarischem Status, abgeglichen mit internationalen Bezeichnungsstandards und verfügbar auf Englisch und Deutsch. Dieselbe Datenbank, die die retraceable-Zertifizierung antreibt, als API verfügbar.
Alles, was du zur Klassifizierung eines Inhaltsstoffs benötigst.
Vegane und vegetarische Klassifizierung
Jeder Inhaltsstoff trägt eine unabhängig berechnete vegane Klassifizierung (vegan, nicht vegan, nicht bestätigt) und vegetarische Klassifizierung (vegetarisch, nicht vegetarisch, nicht bestätigt). Nicht bestätigt bedeutet, dass der Inhaltsstoff tierischen oder nicht-tierischen Ursprungs sein kann und die genaue Herkunft unbekannt ist.
Bezeichnungsabdeckung
Inhaltsstoffe werden mit CAS-Nummern, EC-Nummern, E-Nummern, CI-Nummern, INS-Nummern und CosIng-IDs abgeglichen. Alle Bezeichnungen sind als durchsuchbare Aliasse gespeichert, sodass eine Suche nach CAS-Nummer dasselbe Ergebnis liefert wie eine Namenssuche.
Mehrsprachige Aliasse
Jeder Inhaltsstoff verfügt über Aliasse auf Englisch und Deutsch, einschließlich geläufiger Handelsnamen, Abkürzungen und regionaler Varianten. Derselbe Inhaltsstoff ist auffindbar, unabhängig davon, wie er auf einem Etikett erscheint.
Authentifizierung
Jede Anfrage wird über ein Bearer-Token authentifiziert. Kein Antragsverfahren, keine Freigabe-Warteschlange, kein OAuth-Flow.
- Erstelle ein kostenloses Konto, öffne dann Account → API keys und erzeuge eines. Das Token wird nur einmal angezeigt, bewahre es sicher auf.
- Sende es bei jeder Anfrage als Bearer-Token:
Authorization: Bearer YOUR_API_TOKEN
Nur ein aktiver Schlüssel pro Konto gleichzeitig. Widerrufe ihn auf derselben Seite, um einen Ersatz zu erzeugen. Kostenlose Schlüssel sind auf 500 Anfragen pro Tag begrenzt; für höheres Volumen siehe die Preise weiter unten.
Was eine Abfrage liefert.
Sende eine Liste von Suchbegriffen (Namen, Aliasse oder Bezeichnungen wie CAS- oder E-Nummern) und erhalte jeden passenden Inhaltsstoff zurück, inklusive seiner veganen und vegetarischen Klassifizierung und abgeglichener Bezeichnungen.
POST /api/ingredients/search HTTP/1.1
Host: api.retraceable.io
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
{
"terms": ["Carmine", "E422"]
}
{
"results": [
{
"term": "Carmine",
"matches": [
{
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"canonical_name": "Carmine",
"slug": "carmine",
"cas_number": "1390-65-4",
"ec_number": "215-680-6",
"e_number": "E120",
"ci_number": "75470",
"cosing_id": "34348",
"ins_number": "120",
"vegan_classification": "not_vegan",
"vegetarian_classification": "not_vegetarian",
"vegan_alternatives": [
{
"id": "9c4e3a2b-6d1f-4e8a-8b2c-1a2b3c4d5e6f",
"canonical_name": "Beet Red",
"slug": "beet-red"
},
{
"id": "7d2f1c8a-4b9e-4a3d-9f0e-2b3c4d5e6f7a",
"canonical_name": "Lycopene",
"slug": "lycopene"
}
],
"matched_text": "Carmine"
}
]
},
{
"term": "E422",
"matches": [
{
"id": "3b9e2f6a-7a1a-4b3b-9e2e-2f6a7a1a4b3b",
"canonical_name": "Glycerin",
"slug": "glycerin",
"cas_number": "56-81-5",
"ec_number": "200-289-5",
"e_number": "E422",
"ci_number": null,
"cosing_id": "34260",
"ins_number": "422",
"vegan_classification": "unconfirmed",
"vegetarian_classification": "unconfirmed",
"vegan_alternatives": [
{
"id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
"canonical_name": "Vegetable Glycerin",
"slug": "vegetable-glycerin"
}
],
"matched_text": "E422"
}
]
}
]
}
Antwortfelder
Jeder Treffer im matches-Array enthält diese Felder.
| Feld | Typ | Beschreibung |
|---|---|---|
id |
string (UUID) |
Eindeutige Kennung der Inhaltsstoff-/Materialzeile. |
canonical_name |
string |
Kanonischer englischer Name des Inhaltsstoffs oder Materials. |
slug |
string |
URL-Slug für die Seite des Inhaltsstoffs, z. B. checkvegan.org/glossary/:slug. |
cas_number |
string | null |
CAS-Registrierungsnummer, sofern bekannt. |
ec_number |
string | null |
EC-/EINECS-/ELINCS-Nummer, sofern bekannt. |
e_number |
string | null |
EU-Lebensmittel- oder Kosmetik-Zusatzstoff-E-Nummer, sofern bekannt. |
ci_number |
string | null |
Colour-Index-Nummer, sofern bekannt. |
cosing_id |
string | null |
EU-CosIng-Datenbank-ID, sofern bekannt. |
ins_number |
string | null |
Nummer des Codex International Numbering System für Lebensmittelzusatzstoffe, sofern bekannt. |
vegan_classification |
"vegan" | "not_vegan" | "unconfirmed" |
Veganer Status. Nicht bestätigt bedeutet, dass der Inhaltsstoff tierischen oder nicht-tierischen Ursprungs sein kann und die genaue Herkunft unbekannt ist. |
vegetarian_classification |
"vegetarian" | "not_vegetarian" | "unconfirmed" |
Vegetarischer Status, dieselbe dreistufige Logik wie vegan_classification. |
vegan_alternatives |
array |
Andere Inhaltsstoffe, die als vegane Alternativen zu diesem hinterlegt sind, jeweils mit id, canonical_name und slug. Leer, wenn keine hinterlegt sind. |
matched_text |
string |
Der genaue Teil deines Suchbegriffs, der zu diesem Treffer geführt hat. Ein zusammengesetzter Begriff kann in mehrere Inhaltsstoffe zerlegt werden, jeweils markiert mit dem Teil der Eingabe, der gematcht hat. |
Fehler
Fehler werden als JSON-Objekt mit einem error-Feld zurückgegeben.
| Status | Fehler | Bedeutung |
|---|---|---|
400 |
terms must be a non-empty array of strings |
Das Feld terms im Request-Body fehlte, war kein Array oder war leer. |
401 |
invalid_token |
Der Authorization-Header fehlt oder ist fehlerhaft, oder das Token ist ungültig oder wurde widerrufen. |
429 |
limit_exceeded |
Das tägliche Anfragelimit deines Schlüssels ist erreicht. Die Antwort enthält ein limit-Feld; das Limit setzt sich am nächsten Tag zurück. |
500 |
limit_exceeded |
Beim Erfassen der Nutzung ist ein interner Fehler aufgetreten. Ein erneuter Versuch ist unbedenklich. |
Einfache, transparente Preise.
Keine umsatzabhängigen Gebühren, keine versteckten Stufen. Private Nutzung ist kostenlos, kommerzielle Nutzung ist ein Gespräch.
Bis zu 500 Abfragen pro Tag. Ideal für Forschung, Hobbyprojekte und zum Testen der API.
RegistrierenFür Marken, Plattformen und Produktivintegrationen. Beschreibe deinen Anwendungsfall und wir erarbeiten gemeinsam Preise und Volumen.
Kontakt aufnehmenBereit loszulegen?
Erstelle ein kostenloses Konto für deinen API-Schlüssel, oder melde dich bei uns für kommerzielles Volumen.