Free
- Ingredient match list + summary
- No CosIng flags, colorants, similar products, or brand insights
- Evaluation only
Docs
Search the catalog by ingredient or pull a product's full ingredient breakdown — a separate plan and endpoint from the Products API above.
Live, plan-gated access to search the catalog by ingredient, or pull the full ingredient breakdown for a known product — a separate plan and subscription from the Products API above, not bundled with it either direction.
This API and the Similar Products by Ingredient portal tool draw from the same monthly request budget — subscribing once unlocks both. For the full endpoint-by-endpoint reference (exact request/response shapes), see app.beautyfeeds.io/docs/api#ingredients.
Same header as the Products API, but checked against your Ingredients API subscription specifically — a Products API key alone doesn't grant access here, and vice versa:
X-API-KEY: your_api_key_here
| Request | What it does |
|---|---|
GET /api/v1/ingredient_analysis?ingredient=RETINOL | Search the catalog for products containing one or more ingredients (comma-separated, OR match). Returns per-ingredient catalog stats too (how common it is, typical position, EU/US restrictions) — even for a requested ingredient that matched zero products. |
GET /api/v1/ingredient_analysis?uniq_id=abc123 | Full ingredient breakdown for one known catalog product — every ingredient, with function, EU allergen flag, and restrictions. |
Pass exactly one of ingredient or uniq_id per request — both or neither returns 400.
Deliberately minimal, on purpose: this endpoint identifies matching products, it doesn't replace the Products API. Every product row carries only uniq_id, product_name, product_url, brand_name, site_name, sku, gtin, upc, plus match_percentage and which of your requested ingredients it contains. Price, images, description, and ratings aren't included — that's what the separate Products API is for.
Four tiers, priced by monthly request volume — one request-budget line, no separate ingredient-lookup credits to track. See app.beautyfeeds.io/plans for current pricing and to subscribe.
| Status | Meaning |
|---|---|
400 | Both or neither of ingredient/uniq_id passed |
401 | Missing/invalid API key, or no active Ingredients API subscription |
429 | Plan request limit exceeded |
The same subscription includes the Similar Products by Ingredient portal tool — paste an ingredient list, no integration required. Questions? Get in touch.