# Incibeauty — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```