Nykaa APInykaa.com ↗
Retrieve L'Oreal Paris product listings and details from Nykaa.com including prices, ratings, variants, ingredients, and stock status via 2 endpoints.
What is the Nykaa API?
The Nykaa L'Oreal Paris API provides 2 endpoints to retrieve product data from Nykaa's L'Oreal Paris brand page. The list_products endpoint returns up to 20 products per page with fields like MRP, discount percentage, rating, and image URL, while get_product_details delivers granular data including variants, SKU codes, tags, ingredients, usage instructions, and live stock availability for any individual product.
curl -X GET 'https://api.parse.bot/scraper/32e32b3b-bce2-4ebc-9fd3-cd6b95bcc9b5/list_products?page=1&category_id=595' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace nykaa-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.nykaa_l_oreal_paris_products_api import Nykaa, ProductSummary, Product, ProductNotFound
nykaa = Nykaa()
# Browse L'Oreal Paris product listings
for product_summary in nykaa.productsummaries.list(category_id="595", limit=5):
print(product_summary.name, product_summary.mrp, product_summary.rating)
# Get full details for the first product
first = nykaa.productsummaries.list(category_id="595", limit=1)
for item in first:
detail = item.details()
print(detail.name, detail.offer_price, detail.discount)
print(detail.description)
print(detail.primary_categories.l3.name)
for variant in detail.variants:
print(variant.variant_name, variant.offer_price, variant.in_stock)
List L'Oreal Paris products from Nykaa with pagination. Returns up to 20 products per page with basic metadata including name, price, discount, rating, and category information. Products are ordered by Nykaa's default relevance ranking for the brand page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. Each page returns up to 20 products. |
| category_id | string | Nykaa brand/category ID. 595 is L'Oreal Paris. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"per_page": "integer number of products returned on this page",
"products": "array of product summary objects with id, name, brand_name, product_title, slug, image_url, mrp, price, discount, rating, rating_count, in_stock, variant_count, variant_type, primary_categories, tags",
"total_found": "integer total number of products available"
},
"sample": {
"data": {
"page": 1,
"per_page": 20,
"products": [
{
"id": "26636069",
"mrp": 949,
"name": "L'Oreal Paris Hyaluron Tint Lip Stain Serum Weightless Color",
"slug": "l-oreal-paris-hyaluron-tint-lip-stain-serum-weightless-color/p/26636069",
"tags": [
"FEATURED",
"NEW"
],
"price": 902,
"rating": 4.3,
"discount": 5,
"in_stock": true,
"image_url": "https://images-static.nykaa.com/media/catalog/product/tr:h-200,w-200,cm-pad_resize/c/b/cb487d26902395980254_1.jpg",
"brand_name": "L'Oreal Paris",
"rating_count": 267,
"variant_type": "shade",
"product_title": "Hyaluron Tint Lip Stain Serum Weightless Color",
"variant_count": 6,
"primary_categories": {
"l1": {
"id": "12",
"name": "Makeup"
},
"l2": {
"id": "15",
"name": "Lips"
},
"l3": {
"id": "253",
"name": "Lip Tint"
}
}
}
],
"total_found": 122
},
"status": "success"
}
}About the Nykaa API
Product Listings
The list_products endpoint accepts two optional parameters: page (integer) for pagination and category_id (string) to target a specific brand or category — 595 is L'Oreal Paris on Nykaa. Each response includes a products array of up to 20 items, each carrying id, name, brand_name, product_title, slug, image_url, mrp, price, discount, and rating fields, plus a total_found integer so you can compute total page count without a separate call. Products are returned in Nykaa's default relevance order for the brand page.
Product Details
The get_product_details endpoint accepts either a slug (e.g. l-oreal-paris-elseve-extraordinary-oil-serum/p/1133168) taken directly from list_products results, or a numeric product_id. The response extends the listing fields with sku, tags, in_stock boolean, and a variants array that carries per-variant pricing, stock status, and size or shade details — useful for products offered in multiple shades or pack sizes. It also includes full product description, usage instructions, ingredients, and manufacturer details not present in the listing response.
Coverage and Pagination
The API covers the L'Oreal Paris brand catalogue on Nykaa.com (category ID 595). Pagination is handled by the page parameter on list_products; dividing total_found by per_page gives the total number of pages. For bulk catalogue work, iterate pages until the returned products array is shorter than per_page or page * per_page exceeds total_found.
The Nykaa API is a managed, monitored endpoint for nykaa.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nykaa.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official nykaa.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track MRP and discounted
pricechanges across L'Oreal Paris SKUs over time for price-monitoring dashboards. - Build a shade-finder tool using the
variantsarray fromget_product_detailsto surface available colour options and their individual stock status. - Aggregate
ratingandrating_cfields fromlist_productsto rank L'Oreal Paris products by consumer sentiment. - Sync Nykaa product catalogue data — names, slugs, images, and prices — into an internal product database using paginated
list_productscalls. - Compare
mrpversuspriceacross variants to identify which pack sizes carry the highest discount percentage. - Extract ingredient lists and usage instructions from
get_product_detailsto populate a cosmetic ingredient analysis tool. - Monitor
in_stockboolean per variant to trigger restock alerts for high-demand L'Oreal Paris products.
| 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 | 100 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 offer an official public developer API?+
What does the `variants` field in `get_product_details` actually contain?+
variants array contains one object per purchasable variant of a product. Each object includes its own pricing (MRP and selling price), stock availability, and descriptors for the size or shade — so a foundation available in 10 shades returns 10 variant objects, each independently queryable for stock and price.Does the API return customer reviews or review text?+
rating and rating_c (rating count) fields but does not return individual review text or reviewer metadata. You can fork this API on Parse and revise it to add a reviews endpoint that returns per-review content.Can I retrieve products from Nykaa brand categories other than L'Oreal Paris?+
list_products endpoint accepts a category_id parameter, and 595 is the L'Oreal Paris brand ID. Other Nykaa brand IDs are not documented in the current API. You can fork it on Parse and revise the endpoint to support additional brand or category IDs from Nykaa's catalogue.How fresh is the pricing and stock data returned by the API?+
get_product_details will return the current price, discount, and in_stock value shown on the Nykaa product page at that moment. High-frequency polling is subject to the rate limits shown on this page.