# Nykaa Category API Documentation

<p><strong>Nykaa Category API Documentation</strong> Browse one Nykaa category by its numeric id. Filter by brand and price range and sort by relevance, popularity, price, discount or new arrival. Every item has the sale price and the list price (MRP) as numbers in rupees, the discount, brand, rating with count, stock state and full size photos. The answer holds the real page, the page count and the facets with counts. Every returned item matches your filters. Use a category id from search. The exact charge is in meta.credits and can be higher for this route. A page can hold fewer than 20 items when filters drop rows; pagination.per_page is the real count. The exact charge is in meta.credits: 1 credit on the primary exit and 22 for search, 27 for category or 2 for reviews when the paid fallback serves the lookup. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/nykaa-api/nykaa_category](https://scrappa.co/docs/nykaa-api/nykaa_category)
- **API group:** Nykaa API
- **Endpoint:** `GET https://scrappa.co/api/nykaa/category`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | string | Yes | Numeric category id from search, for example 8397 |
| `sort` | string | No | relevance, popularity, price_asc, price_desc, discount or new_arrival |
| `brand` | string | No | Brand facet id from the filters answer |
| `min_price` | integer | No | Minimum price in rupees |
| `max_price` | integer | No | Maximum price in rupees |
| `page` | integer | No | Page number, default 1 |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | A filter or id is not valid. |
|  | Error | No data exit is available or the upstream is unavailable. Not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
