nykaafashion.com APInykaafashion.com ↗
Access Nykaa Fashion product listings, category trees, search results, and product details including pricing, sizes, reviews, and offers via a structured API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e751ecfe-21cc-40bb-a5a3-93efd4b9d0ff/get_category_tree' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full category hierarchy including top-level categories, subcategories, and brands. Returns a nested tree structure with category IDs, names, images, and action URLs.
No input parameters required.
{
"type": "object",
"fields": {
"id": "integer, root category ID",
"name": "string, root category name",
"children_data": "array of nested category objects with id, name, parent_id, children_data, action_url"
},
"sample": {
"data": {
"id": 2,
"name": "Nykaa",
"image": "",
"level": 1,
"position": 1,
"parent_id": 1,
"children_data": [
{
"id": "007",
"name": "Home",
"level": "2",
"position": "2",
"parent_id": "2",
"children_data": [
{
"id": 7,
"name": "master",
"level": 2,
"position": 3,
"parent_id": 3,
"children_data": [
{
"id": 40000,
"name": "Super Category",
"level": 3,
"position": 3,
"parent_id": 7,
"children_data": [
{
"id": 6557,
"name": "Women",
"action_url": "/women/c/6557"
},
{
"id": 6823,
"name": "Men",
"action_url": "/men/c/6823"
},
{
"id": 6266,
"name": "Kids",
"action_url": "/kids/c/6266"
}
]
}
]
}
]
}
]
},
"status": "success"
}
}About the nykaafashion.com API
The Nykaa Fashion API provides 5 endpoints for querying the nykaafashion.com catalog, covering search, category browsing, product details, and autocomplete suggestions. The get_product_details endpoint returns over a dozen fields per product — including sizeOptions, productMedia, pdp_sections, productOffers, and reviews — making it suitable for building price trackers, fashion discovery tools, or catalog aggregators.
Catalog Search and Browsing
The search_products endpoint accepts a required query string (e.g. 'red dress', 'sneakers') along with optional page and sort parameters. Sort options include popularity, price-low-to-high, price-high-to-low, discount, and new-arrivals. Responses include a products array with per-item fields: id, title, subTitle, price, discountedPrice, discount, imageUrl, actionUrl, and sizeVariation. A total_count field and current_page allow you to paginate through full result sets. The filters array in the response reflects available facets for that query.
Category Navigation
get_category_tree returns the full nested category hierarchy — no inputs required. Each node carries an id, name, parent_id, action_url, and a children_data array for sub-levels. This is useful for mapping the site's full taxonomy before querying get_category_products, which accepts a category_url (e.g. /women/c/6557) and the same page and sort parameters as search. Category URLs can be pulled from action fields in the tree response.
Product Detail Data
get_product_details requires both a product_id and a slug, both available from search_products results. The response contains a product object with full pricing, size options, media assets, and structured pdp_sections (which cover materials, care instructions, and delivery info). A separate reviews object delivers user review data, and productOffers lists applicable coupons and promotions. exploreImages provides lifestyle or editorial images beyond the standard product gallery.
Autocomplete and Suggestions
get_search_suggestions takes a partial query string and returns a response object whose suggestions array contains entries with suggestionWord, url, type, id, and match_count. This is suited for building type-ahead search interfaces or auditing which brand and keyword terms have significant catalog coverage on the platform.
- Track price and discount changes on fashion items using
discountedPriceanddiscountfields fromsearch_products. - Build a size-availability checker by polling
sizeOptionsfromget_product_detailsfor specific product IDs. - Map the full Nykaa Fashion category taxonomy using
get_category_treeto structure a product feed or taxonomy mirror. - Aggregate user reviews and ratings from the
reviewsobject inget_product_detailsfor sentiment analysis. - Populate a type-ahead search bar using
suggestionWordandmatch_countfromget_search_suggestions. - Compare promotional offers across products by extracting
productOffersdata from multiple product detail calls. - Curate a brand-specific product listing by combining
get_category_treebrand nodes withget_category_productsresults.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Nykaa Fashion have an official developer API?+
What does `get_product_details` return beyond basic pricing?+
price and discountedPrice, the endpoint returns sizeOptions, productMedia (product images), pdp_sections (materials, care instructions, delivery details), a reviews object with user review data, exploreImages for lifestyle imagery, and a productOffers object listing active coupons and promotions.Can I filter search results by attributes like color, brand, or size?+
search_products endpoint exposes a filters array in its response that reflects available facets for a given query, but the current endpoint inputs only support query, page, and sort. Filtering by specific attribute values is not currently supported as an input parameter. You can fork this API on Parse and revise it to add filter parameters to the search endpoint.Does the API cover seller information or stock availability?+
How does pagination work across endpoints?+
search_products and get_category_products both accept an integer page parameter. The search_products response includes a total_count field so you can calculate the number of pages for a given query. Page numbering starts at 1, and requests without a page parameter default to the first page of results.