Reef AI: ask for any data. Try it
The playground

Try any of 3860 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com
post/nykaa/v1/search2 credits

Search Nykaa exactly as a shopper does and get the product grid: the price actually paid, the printed MRP, the real discount, rating and rating count, shade count, stock and the product id. Two things this action does for you: it reads the same index the website shows (a cheaper keyword route on the same host answers 0 for 'nykaa foundation', where the site answers 116), and when Nykaa redirects a head term such as 'lipstick' to a category it follows that and tells you, so you get the catalogue instead of nothing. 🔴 Nykaa server-renders only the FIRST 20 matches of a search: `total_results` is its own count, and a deeper walk goes through `category` with the `category_id` this action hands back.

Working example
Parameters

What a shopper would type on nykaa.com — a product, a brand, a category, or a concern phrase such as 'serum for oily skin'.

Result order. Nykaa's own default is `popularity`. It refuses any order it does not know, so these seven are all that exist.

Lowest selling price in INR. Use with `price_max`; the source takes the pair as one band. (0–)

Highest selling price in INR. Measured on the Lipstick category: 718 products unfiltered, 295 under 500, 84 between 1000 and 1999. (1–)

Only products discounted by at least this percentage. Measured on Lipstick: 718 unfiltered, 453 discounted at all, 184 at 20 % or more, 92 at 30 %, 36 at 40 %. (0–90)

Only products whose average customer rating is at least this many stars (1-4; Nykaa publishes no 5-only filter). Measured on the query 'kajal waterproof': 329 unfiltered, 309 at 3+, 278 at 4+. (1–4)

Narrow to one brand. The id comes from `facets.brand` on this action (set `include_facets`) or from `brands`. Measured: brand 3899 in category 249 returns exactly the 26 the facet promises. Nykaa offers no brand facet on a KEYWORD search, only on a category or brand listing.

Narrow to one colour family; the id comes from `facets.color`. 🔴 This one matches at SHADE level, so on a category its own count can exceed the unfiltered product count.

Finish, e.g. matte / creme / satin / glossy. Id from `facets.finish`. Measured on Lipstick: 454 of 718 are matte.

Skin or hair concern (acne, pigmentation, dryness, hair fall). Id from `facets.concern` — this is the axis Indian beauty shoppers actually buy on.

Formulation (liquid, cream, powder, pencil, gel). Id from `facets.formulation`.

Hero ingredient (hyaluronic acid, niacinamide, salicylic acid, retinol). Id from `facets.ingredient_v1`.

Gender the product is listed for. Id from `facets.gender` (10711 female, 10712 unisex on the categories measured).

ISO country code of manufacture, as Nykaa files it. Id from `facets.country_of_origin` — 'IN' and 'KR' are the two a buyer of Indian beauty data usually wants.

Claim or preference (paraben free, cruelty free, vegan, dermatologically tested). Id from `facets.preference`.

Skin type the product is listed for (oily, dry, normal, combination, sensitive). Id from `facets.skin_type`.

Also return `facets`: every filter Nykaa offers for this listing — brands, colours, finishes, concerns, ingredients, formulations, price bands, ratings, discounts, country of origin — each with its id and the number of products behind it. This is where every `*_id` parameter above comes from.

Ask Reef AI
request preview
curl -X POST https://api.reefapi.com/nykaa/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"maybelline mascara"}'

Press Send request to see the live result here.

Not sure what to send? Ask Reef AI

What you can run here, without an account

ReefAPI is one HTTP gateway to 632 live web-data APIs covering 3860 endpoints across 13 categories. Every endpoint answers with the same JSON envelope, so one integration reaches all of them. Each response reports what it cost and when the source was read.

No signup, no API key and no card are required to try an endpoint on this page. Anonymous calls run on a shared demo key, capped at 15 calls per hour per visitor. Pick an API, fill the parameters and the real response comes back from the live source, not from a canned sample. A free account lifts the cap and gives you 1,000 credits and your own key.

Browse every API in the catalog, read an endpoint's fields and example response in the docs, or see per-call credit costs on the pricing page.

Coverage by category

ecommerce350
classifieds116
real-estate29
media25
utilities18
jobs18
developer-tools18
reviews15
social15
search-seo11
travel8
other5
finance4