---
title: Ingredient Parser From Text API
slug: parse-ingredients
url: https://apyhub.com/ingredients/service/parse-ingredients
provider: Ingredients API
categories: [Data Extraction, Data Validation, E-commerce Quick Tools]
tags: [ingredient-parsing, food-labeling, allergen-detection, additive-detection, dietary-analysis]
auth: api_key
---

# Ingredient Parser From Text API

Parse ingredient text into additives, allergens, trace warnings, and dietary flags. Useful for food labels, compliance checks, and catalog enrichment.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/v1/parse` | What it does Parses a free-text ingredient list sent in the request body and returns a structured J… | 60 |
| GET | `/v1/additives/:code` | What it does Looks up a single E-number by its code path parameter and returns the regulatory data… | 10 |

## About

## What it does
Ingredient Parser turns a free-text ingredient list into structured ingredient intelligence. Send ingredient text and, optionally, a language hint, and get back additive detection, allergen classification, and dietary signals in a stable machine-readable format.

Use it when you need to normalise product labels, check ingredient declarations, or enrich food catalog data. The response includes `additives` with regulatory codes, names, optional Italian names, functional categories, confidence, and a recognition flag. It also returns confirmed `allergens`, separate `allergens_traces` for “may contain traces of” clauses, `dietary` flags for vegan, vegetarian, alcohol, palm oil, and added sugars, plus `unrecognized_ingredients` for fragments it could not classify.

Ingredient Parser is built for automation: field names and enum tokens stay stable, and the `lang` input only helps match dictionary terms in the source text. If the service reaches its spend cap, `degraded` tells you it switched to deterministic-only mode instead of failing. Use the `cached` flag to identify repeat parses and `llm_assisted` to see whether language-model assistance was used.

This is a good fit for ecommerce product ingestion, compliance workflows, recipe analysis, and internal search indexing where ingredient text needs to become structured data you can filter and audit.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/ingredients/service/parse-ingredients