# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/incibeauty/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/incibeauty/get-all-ingredients \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/get-dossier-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/get-dossiers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/get-ingredient-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/get-ingredient-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/get-ingredients-by-letter \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/get-most-used-ingredients \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/get-recently-seen-ingredients \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/search-ingredients \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/incibeauty/search-products-and-ingredients \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.