Reef AI: ask for any data. Try it
This page is the Namshi parameter reference. What the data is used for, a real sample and pricing are on Namshi API: what you get →
E-commerce & Marketplaces

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.

3 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "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"
  }
}
Captured response
{
  "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"
  }
}
Actions

What the Namshi API does

ActionDescriptionConcrete use caseKey params
searchSearch 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/productsList 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/detailThe 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
Code samples

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.namshi.search with {"query":"red summer dress","country":"ae"}.
Use cases

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.
FAQ

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.

docs / namshi

Namshi

Namshi

base /namshi/v13 endpoints
post/namshi/v1/category/products1 credit

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.

ParameterAllowed / rangeDescription
categoryrequired—The namshi category to list, as its path or as a full category URL. Take it from `breadcrumbs[].path` or from `filters` → `category` on any result, e.g. 'women-clothing-dresses', 'men-shoes', 'women/women-clothing/women-clothing-dresses/women-clothing-dresses-midi'.
country = aeoptionalae · sa · kw · bh · om · qaWhich namshi storefront to read. Each one is a separate market with its OWN catalogue, availability and currency — a price is only meaningful together with the market it came from, and every row returns both. All six were measured open.
language = enoptionalen · arLanguage of the titles, descriptions, categories and filter names namshi returns.
page = 1optional1–400Result page. namshi returns 60 products per page; `total_pages` in the response says how many there are.
sort = recommendedoptionalrecommended · price_asc · price_desc · discount · newestHow namshi orders the results. Anything outside this list is refused, because namshi answers an unrecognised sort by dropping the search and returning its whole catalogue.
brandoptional—Keep only one brand, given as namshi's brand code — lowercase with underscores, as it appears in `brand_code` on every result row and in the `brand_code` entry of `filters` (e.g. 'nike', 'tommy_hilfiger', 'h_m').
colouroptional—Keep only one colour family, given as namshi's colour code. The codes available for the current result set, with counts, are returned under `filters` → `colour_family` (e.g. 'red', 'black', 'multicolour').
price_minoptional0–Lowest price to keep, IN THE CURRENCY OF THE CHOSEN MARKET (AED for ae, SAR for sa, KWD for kw, BHD for bh, OMR for om, QAR for qa). The band namshi itself offers for the current result set is in `filters` → `current_price` → `range`.
price_maxoptional0–Highest price to keep, in the currency of the chosen market. Must not be below `price_min`.
discounted_only = falseoptional—Keep only products namshi currently shows at a reduced price (those with a struck-through `price_before_discount`).
new_arrivals_only = falseoptional—Keep only the products namshi flags as new arrivals.
delivery_typeoptionalstandard · globalKeep only products in one of namshi's delivery programmes.
Try in playground →
post/namshi/v1/product/detail1 credit

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.

ParameterAllowed / rangeDescription
product_idrequired—Which product to read: the code before /p/ in a namshi product URL (…/Z39B32B8C27F319D6E18FZ/p/ → Z39B32B8C27F319D6E18FZ), or the full product URL itself. Every `search` and `category/products` row returns it as `product_id`; a size-specific code such as …FZ-2 is accepted and resolves to its parent product.
country = aeoptionalae · sa · kw · bh · om · qaWhich namshi storefront to read. Each one is a separate market with its OWN catalogue, availability and currency — a price is only meaningful together with the market it came from, and every row returns both. All six were measured open.
language = enoptionalen · arLanguage of the titles, descriptions, categories and filter names namshi returns.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.