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.

35.000+
Inhaltsstoffe
6
Bezeichnungsstandards
DE + EN
Sprachen

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.

  1. Erstelle ein kostenloses Konto, öffne dann Account → API keys und erzeuge eines. Das Token wird nur einmal angezeigt, bewahre es sicher auf.
  2. 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.

Anfrage
POST /api/ingredients/search HTTP/1.1
Host: api.retraceable.io
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

{
  "terms": ["Carmine", "E422"]
}
Antwort
{
  "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.

Privat
Kostenlos

Bis zu 500 Abfragen pro Tag. Ideal für Forschung, Hobbyprojekte und zum Testen der API.

Registrieren
Kommerziell
Kontakt aufnehmen

Für Marken, Plattformen und Produktivintegrationen. Beschreibe deinen Anwendungsfall und wir erarbeiten gemeinsam Preise und Volumen.

Kontakt aufnehmen

Bereit loszulegen?

Erstelle ein kostenloses Konto für deinen API-Schlüssel, oder melde dich bei uns für kommerzielles Volumen.

Registrieren