# Nykaa — 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.

> Browse and retrieve L'Oreal Paris beauty products from Nykaa, accessing comprehensive details like prices, ratings, descriptions, and available variants. Find exactly what you need with detailed product information to compare options and make informed purchase decisions.

**Category:** E-commerce | **Website:** [www.nykaa.com/brands/loreal-paris/c/595?ptype=brand&id=595](https://www.nykaa.com/brands/loreal-paris/c/595?ptype=brand&id=595) | **Docs:** [parse.bot/marketplace/4fb12b30-c4b8-4482-9c87-8bb9febfc403/nykaa-com-api](https://parse.bot/marketplace/4fb12b30-c4b8-4482-9c87-8bb9febfc403/nykaa-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-nykaa-com-api-4fb12b30/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed information about a specific product including full description, usage instructions, ingredients, variants with pricing and size/shade details, manufacturer details, and ratings. Accepts either a product slug (from list_products results) or a numeric product ID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | Nykaa product ID (e.g. '1133168'). Either slug or product_id must be provided. |
| `slug` | string | No | Product URL slug from list_products results (e.g. 'l-oreal-paris-elseve-extraordinary-oil-serum/p/1133168'). Either slug or product_id must be provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nykaa-com-api-4fb12b30/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>","slug":"<string>"}'
```

### list_products

List L'Oreal Paris products from Nykaa with pagination. Returns up to 20 products per page with basic metadata including name, price, discount, rating, and category information. Products are ordered by Nykaa's default relevance ranking for the brand page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Nykaa brand/category ID. 595 is L'Oreal Paris. |
| `page` | integer | No | Page number for pagination. Each page returns up to 20 products. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nykaa-com-api-4fb12b30/list_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>"}'
```