# Incibeauty — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search cosmetic ingredients and products to discover detailed formulation data, safety ratings, and usage statistics. Browse expert editorial dossiers on cosmetic topics, explore the most popular ingredients used across the beauty industry, and retrieve recently referenced items for quick lookup.

**Category:** Healthcare | **Website:** [incibeauty.com/](https://incibeauty.com/) | **Docs:** [parse.bot/marketplace/500a4bf9-cd2e-4f40-bde7-8a74704ffedc/incibeauty-com-api](https://parse.bot/marketplace/500a4bf9-cd2e-4f40-bde7-8a74704ffedc/incibeauty-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_ingredients

Get all ingredients from the database by iterating through letters A-Z and the numeric page. Warning: this fetches many pages and may be slow (~27 requests).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_all_ingredients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_dossier_detail

Get details and articles for a specific dossier/theme. Returns the dossier title, description, and its associated editorial articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id_slug` | string | Yes | Dossier ID and slug (e.g. '7-la-reglementation-cosmetique'). Obtainable from get_dossiers results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_dossier_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id_slug":"<string>"}'
```

### get_dossiers

Get list of editorial dossier categories (themes) available on the site. Each dossier groups articles by cosmetic topic such as regulation, sunscreens, or nanoparticles.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_dossiers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_ingredient_detail

Get full details for a specific ingredient by its ID-slug. Returns safety rating, CAS number, functions, usage percentage, origin, and associated products. The id_slug is obtainable from get_ingredients_by_letter or search_ingredients results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id_slug` | string | Yes | Ingredient ID and slug from the URL path (e.g. '5555-aqua', '6832-glycerin'). Obtainable from get_ingredients_by_letter or search_ingredients results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_ingredient_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id_slug":"<string>"}'
```

### get_ingredient_products

Get list of products containing a specific ingredient. Returns associated products with brand, name, URL, and safety score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id_slug` | string | Yes | Ingredient ID and slug (e.g. '5555-aqua', '6832-glycerin'). Obtainable from search_ingredients or get_ingredients_by_letter results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_ingredient_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id_slug":"<string>"}'
```

### get_ingredients_by_letter

Get cosmetic ingredients starting with a specific letter. Returns ingredient names, safety ratings, slugs, and French common names. Letters A-Z filter alphabetically; digits 0-9 are mapped to a single numeric page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Letter to filter by (A-Z). Digits 0-9 are also accepted and mapped to a single numeric page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_ingredients_by_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### get_most_used_ingredients

Get the most commonly used cosmetic ingredients. Returns a list of popular ingredients sorted by frequency of use in cosmetic products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_most_used_ingredients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_recently_seen_ingredients

Get recently encountered ingredients on the platform. Returns a list of ingredients that have been recently viewed or referenced across the site.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/get_recently_seen_ingredients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_ingredients

Search for ingredients using the autocomplete API. Returns matching ingredients with IDs, CAS numbers, product counts, and URL slugs. Faster and more precise than full-text search for ingredient lookup.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Ingredient search query (e.g. 'glycerin', 'aqua') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/search_ingredients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### search_products_and_ingredients

Search for products, ingredients, and articles by keyword. Returns paginated results including product listings, related ingredient links, editorial articles, and brand suggestions. Use page param to paginate through product results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword (e.g. 'retinol', 'hyaluronic acid') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-incibeauty-com-api-500a4bf9/search_products_and_ingredients \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```