Nykaa Search API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Search words, for example cetaphil
coffee shops
string
Optional
relevance, popularity, price_asc, price_desc, discount or new_arrival
relevance
string
Optional
Brand facet id from the filters answer
example
integer
Optional
Minimum price in rupees
10
integer
Optional
Maximum price in rupees
10
integer
Optional
Page number, default 1
1
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A filter or id is not valid.
HTTP 503
No data exit is available or the upstream is unavailable. Not billed.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.