# Nykaa Search API Documentation

<p><strong>Nykaa Search API Documentation</strong> Search Nykaa beauty products by query. 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 rating_count field is the number of ratings; review_count is the number of written reviews in the search feed, where both carry the same number. Both are numbers. The answer also holds the total, the page count and the filter facets with counts. A head term that redirects is resolved to its category inside the same request and keeps your query in filters_applied.query. That follow makes two lookups in one request and can cost up to 48 credits when both lookups use the paid fallback; the exact charge is in meta.credits. An id from an item works unchanged in the reviews endpoint. 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_search](https://scrappa.co/docs/nykaa-api/nykaa_search)
- **API group:** Nykaa API
- **Endpoint:** `GET https://scrappa.co/api/nykaa/search`

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search words, for example cetaphil |
| `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)
