Namshi API & Scraper: parameters and responses
This is the reference for the 3 Namshi endpoints under /namshi/v1 (search, category/products and product/detail) and their 14 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.
Namshi API returns live Namshi data as clean JSON for namshi The primary endpoint, search, returns matching records including product id, variant sku, title, brand and brand code.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Developers reach for it when they need to track product listings, prices, availability, variants and reviews without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Namshi scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, category/products, product/detail. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/namshi/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "red summer dress",
"country": "ae"
}
}{
"ok": true,
"meta": {
"api": "namshi",
"endpoint": "search",
"mode": "live",
"latency_ms": 1931.5,
"record_count": 60,
"bytes": 1304238,
"cache_hit": false,
"pagination": {
"page": 1,
"has_more": true,
"page_size": 60,
"total": 916
},
"country": "ae",
"currency": "AED",
"charged_credits": 1,
"version": "0.1.0",
"request_id": "3d4d0c2fee6641c7",
"queue_ms": 2.1,
"fetched_at": "2026-11-03T17:32:10.441Z"
},
"data": {
"results": [
{
"product_id": "Z70B902FF50AD9460F89CZ",
"variant_sku": "Z70B902FF50AD9460F89CZ-1",
"title": "Girls Red One Shoulder Flower Details Ruffle Mini Dress",
"brand": "Take Two",
"brand_code": "take_two",
"url": "https://www.namshi.com/uae-en/buy-take-two-girls-red-one-shoulder-flower-details-ruffle-mini-dress/Z70B902FF50AD9460F89CZ/p/",
"image": "https://f.nooncdn.com/p/pzsku/Z70B902FF50AD9460F89CZ/45/_/1773836491/a9a9f403-e29b-4c6f-a9d9-482dcd5da364.jpg?format=webp&width=800",
"images": [
"https://f.nooncdn.com/p/pzsku/Z70B902FF50AD9460F89CZ/45/_/1773836491/a9a9f403-e29b-4c6f-a9d9-482dcd5da364.jpg?format=webp&width=800",
"https://f.nooncdn.com/p/pzsku/Z70B902FF50AD9460F89CZ/45/_/1773836491/48ad7e8a-2d9b-48ca-9a91-4ab04b0f916d.jpg?format=webp&width=800",
"https://f.nooncdn.com/p/pzsku/Z70B902FF50AD9460F89CZ/45/_/1773836491/a3a4523c-691b-4137-a1cd-7cd44fbcaead.jpg?format=webp&width=800"
],
"price": 58,
"price_before_discount": 66,
"discount_percent": 13,
"currency": "AED",
"market": "ae",
"rating": null,
"review_count": null,
"rating_scale": null,
"placement": "organic",
"express_delivery": false,
"global_delivery": false,
"outlet": false,
"has_size_variants": true,
"max_quantity": 3,
"listing_type": "product"
},
{
"product_id": "Z6253C67EAC4770C6C578Z",
"variant_sku": "Z6253C67EAC4770C6C578Z-1",
"title": "Layered Tulle Party Dress",
"brand": "D'daniela",
"brand_code": "ddaniela",
"url": "https://www.namshi.com/uae-en/buy-ddaniela-layered-tulle-party-dress/Z6253C67EAC4770C6C578Z/p/",
"image": "https://f.nooncdn.com/p/9a02f3de56325beaaf9b8ef5d6644d8d|pzsku/Z6253C67EAC4770C6C578Z/45/1770714247/510f14d5-ccfc-4cef-a37e-44bcd93dde27.jpg?format=webp&width=800",
"images": [
"https://f.nooncdn.com/p/9a02f3de56325beaaf9b8ef5d6644d8d|pzsku/Z6253C67EAC4770C6C578Z/45/1770714247/510f14d5-ccfc-4cef-a37e-44bcd93dde27.jpg?format=webp&width=800",
"https://f.nooncdn.com/p/9a02f3de56325beaaf9b8ef5d6644d8d|pzsku/Z6253C67EAC4770C6C578Z/45/1770714248/faeabe0a-fd36-4ba0-a871-a337e3995922.jpg?format=webp&width=800",
"https://f.nooncdn.com/p/9a02f3de56325beaaf9b8ef5d6644d8d|pzsku/Z6253C67EAC4770C6C578Z/45/1770714248/3662acb1-0301-436b-958b-4d48a76b96b7.jpg?format=webp&width=800"
],
"price": 98,
"price_before_discount": 139,
"discount_percent": 30,
"currency": "AED",
"market": "ae",
"rating": null,
"review_count": null,
"rating_scale": null,
"placement": "organic",
"express_delivery": false,
"global_delivery": false,
"outlet": false,
"has_size_variants": true,
"max_quantity": 1,
"listing_type": "product"
},
{
"product_id": "ZD3530CA631AD8704E16CZ",
"variant_sku": "ZD3530CA631AD8704E16CZ-1",
"title": "Styli Red Textured Sweetheart Neck Midi Dress",
"brand": "Styli",
"brand_code": "styli",
"url": "https://www.namshi.com/uae-en/buy-styli-styli-red-textured-sweetheart-neck-midi-dress/ZD3530CA631AD8704E16CZ/p/",
"image": "https://f.nooncdn.com/p/pzsku/ZD3530CA631AD8704E16CZ/45/_/1775221022/a3ede23c-8fe4-40e7-99d9-eee99d97b434.jpg?format=webp&width=800",
"images": [
"https://f.nooncdn.com/p/pzsku/ZD3530CA631AD8704E16CZ/45/_/1775221022/a3ede23c-8fe4-40e7-99d9-eee99d97b434.jpg?format=webp&width=800",
"https://f.nooncdn.com/p/pzsku/ZD3530CA631AD8704E16CZ/45/_/1775221022/7f5edb8f-edbf-423e-b482-6ebabf4877b2.jpg?format=webp&width=800",
"https://f.nooncdn.com/p/pzsku/ZD3530CA631AD8704E16CZ/45/_/1775221022/a690d9ff-bbd0-4561-909e-b9ddd5103771.jpg?format=webp&width=800"
],
"price": 80,
"price_before_discount": 129,
"discount_percent": 38,
"currency": "AED",
"market": "ae",
"rating": null,
"review_count": null,
"rating_scale": null,
"placement": "organic",
"express_delivery": false,
"global_delivery": false,
"outlet": false,
"has_size_variants": true,
"max_quantity": 2,
"listing_type": "product"
}
],
"count": 60,
"total_results": 916,
"total_pages": 16,
"page": 1,
"echoed_query": "red summer dress",
"department": "all",
"breadcrumbs": null,
"filters": [
{
"code": "brand_code",
"name": "Brand",
"type": "multiselect",
"options": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
],
"range": null
},
{
"code": "category",
"name": "Category",
"type": "multiselect",
"options": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
],
"range": null
},
{
"code": "namshi_occasion",
"name": "Style",
"type": "multiselect",
"options": [
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
},
{
"code": "[trimmed-depth]",
"name": "[trimmed-depth]",
"count": "[trimmed-depth]"
}
],
"range": null
}
],
"sorts_available": [
"Recommended",
"Discount",
"New Arrivals"
],
"currency": "AED",
"market": "ae",
"country": "ae",
"language": "en",
"redirected": false,
"landing_path": null,
"query": "red summer dress"
}
}What the Namshi API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search one namshi storefront by keyword and get the matching products: namshi product id, title, brand, images, the price the shopper actually pays together with the struck-through price and the discount percentage, the market and currency the price is quoted in, rating and review count where namshi publishes them, and the express / global / outlet flags. Filter by brand, colour, price band, discounted-only, new arrivals and delivery programme; sort by namshi's ranking, price, discount or newest. The response also carries namshi's whole facet catalogue with counts, so the next call can be narrowed without guessing codes. | Pricing teams call search to search one namshi storefront by keyword and get the matching products. | query, country, language, page, sort, ... |
| category/products | List one namshi category by its path — the same product rows, filters, sorts and paging as `search`, plus the category breadcrumb. Use it to walk a department (women's dresses, men's shoes, kids' clothing) rather than a keyword. | Marketplace operators call category/products to list one namshi category by its path. | category, country, language, page, sort, ... |
| product/detail | The full namshi product record for one product in one market: title, brand and brand logo, description, the whole image gallery, the price paid with the struck-through price and discount, the market and currency, availability, rating and review count where namshi publishes them, the attribute table, the category breadcrumb, the returns and exchange policy flags, and every size variant with its own stock state and its own price. | Catalog enrichment teams call product/detail to get the full namshi product record for one product in one market. | product_id, country, language |
Call search from your stack
curl -X POST https://api.reefapi.com/namshi/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"red summer dress","country":"ae"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/namshi/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "red summer dress",
"country": "ae"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/namshi/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "red summer dress",
"country": "ae"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.namshi.search with {"query":"red summer dress","country":"ae"}.Who uses this API and why
- Pricing teams use Namshi to search one namshi storefront by keyword and get the matching products.
- Marketplace operators use Namshi to list one namshi category by its path.
- Catalog enrichment teams use Namshi to get the full namshi product record for one product in one market.
Questions developers ask before integrating
What is the Namshi API?
Namshi API is a ReefAPI endpoint group for namshi It returns live JSON through POST requests under /namshi/v1.
Is the Namshi API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Namshi calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Namshi login or account?
No login to Namshi is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Namshi data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Namshi API use?
Namshi actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Namshi from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call namshi actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Namshi API a Namshi scraper?
It is the managed alternative to a DIY Namshi scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same namshi back as clean JSON.
Why does my Namshi scraper keep getting blocked?
Most Namshi scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.