Nykaa Category API Documentation 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.
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
Numeric category id from search, for example 8397
example
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.