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

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/nykaa/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/nykaa/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/nykaa/list-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>"}'
```

## Next steps

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