incibeauty.com APIincibeauty.com ↗
Access cosmetic ingredient safety ratings, CAS numbers, functions, product associations, and editorial dossiers from INCI Beauty via 10 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/b749d1dd-8e42-42c0-8cc8-dd7908e473aa/get_ingredients_by_letter?letter=C' \ -H 'X-API-Key: $PARSE_API_KEY'
Get cosmetic ingredients starting with a specific letter. Returns ingredient names, safety ratings, slugs, and French common names for all ingredients beginning with the specified character.
| Param | Type | Description |
|---|---|---|
| letter | string | Letter to filter by (A-Z). Digits 0-9 are also accepted and mapped to a single numeric page. |
{
"type": "object",
"fields": {
"count": "integer, total number of ingredients returned",
"letter": "string, the letter used for filtering",
"ingredients": "array of ingredient objects with name, slug, url, common_name_fr, and safety_rating"
},
"sample": {
"data": {
"count": 702,
"letter": "B",
"ingredients": [
{
"url": "https://incibeauty.com/ingredients/18223-babassu-oil-glycereth-8-esters",
"name": "BABASSU OIL GLYCERETH-8 ESTERS",
"slug": "18223-babassu-oil-glycereth-8-esters",
"safety_rating": "Unsatisfactory",
"common_name_fr": ""
}
]
},
"status": "success"
}
}About the incibeauty.com API
The INCI Beauty API exposes 10 endpoints covering cosmetic ingredient profiles, product safety scores, and editorial content from incibeauty.com. You can retrieve full ingredient details — including CAS registry numbers, origin, functions, and safety ratings — via get_ingredient_detail, browse every ingredient alphabetically with get_ingredients_by_letter, or search across products, ingredients, and articles in one call with search_products_and_ingredients.
Ingredient Data
The core of this API is ingredient-level data. get_ingredient_detail accepts an id_slug parameter (e.g. 6832-glycerin) and returns the ingredient's INCI name, CAS number, origin, an array of function strings (e.g. emollient, humectant), a French common name, a safety_rating value drawn from one of five labels — Good, Satisfactory, Unsatisfactory, Risk, or empty — and a usage_percentage text field describing how frequently the ingredient appears in cosmetics. search_ingredients provides an autocomplete-style lookup that returns id, main_inci_name, cas, product_count, and slug for each match, making it the natural starting point before calling get_ingredient_detail.
Browsing and Discovery
get_ingredients_by_letter accepts a single character (A–Z or 0–9) and returns all matching ingredients with their name, slug, URL, French common name, and safety rating — useful for bulk enumeration. get_all_ingredients iterates that same logic across the full alphabet and returns a flattened array with a total_count; note the endpoint documentation warns this may be slow due to the volume of pages fetched. get_most_used_ingredients and get_recently_seen_ingredients each return lightweight arrays of ingredient name and URL pairs, differentiated by the tab field in each response.
Product Associations
Two endpoints expose product data tied to specific ingredients. get_ingredient_products takes the same id_slug parameter and returns an array of product objects, each carrying brand, name, url, and score. The same product array also appears inside get_ingredient_detail as associated_products. search_products_and_ingredients extends this to keyword searches, returning separate arrays for products, brands, articles, and a total_results_text string, with page parameter support for pagination.
Editorial Content
get_dossiers returns the full list of editorial theme categories, each with name, slug, and url. get_dossier_detail accepts a dossier id_slug (e.g. 7-la-reglementation-cosmetique) and returns the dossier title, description, and an array of article objects with title and url. This makes it possible to surface INCI Beauty's structured editorial content alongside raw ingredient and product data.
- Build an ingredient safety checker that maps INCI names to safety_rating and CAS numbers for a cosmetic formula.
- Populate a product formulation database by pulling associated_products for specific ingredient id_slugs.
- Generate an A–Z ingredient reference index using get_ingredients_by_letter across all 26 letters.
- Surface trending or frequently used ingredients in a beauty app via get_most_used_ingredients.
- Enrich a cosmetics catalog with structured function labels (e.g. emollient, preservative) from the functions array in get_ingredient_detail.
- Index INCI Beauty's editorial dossier articles for a cosmetic regulatory knowledge base using get_dossier_detail.
- Autocomplete ingredient search in a formulation tool using search_ingredients, which returns product_count and slug for each match.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.