Namshi API

Gulf fashion as JSON, with each market's price in that market's currency

success rate
99.9%
median response
2.2s
fields per result
20
endpoints
3
Measured on live customer calls,

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.

This page covers what the Namshi API returns, who uses it, a real response and pricing. Every parameter and response field is in Namshi API parameters and responses →

POST/namshi/v1/search
Real result
titlepricevariant_skubrand
Nikias Nida Abaya With Folded Band15.58 KWDZ1A0534B39B17B70379C2Z-1Nikias
Women's Abaya with Matching Sheila17.35 KWDZD9748148CB2113EED95CZ-1Reem Abayas
The Sunburst Black Pleat Abaya27.08 KWDZ95972D3F4B7E40BF7A67Z-1MSquare Fashion
3 active endpoints. Every call is 1 credit.search · category/products · product/detailDetails ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Namshi API

3 of 3 endpoints, ready to run

View docs ↗

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.

1 credit1 required · 11 optional
POST/namshi/v1/search
oksample
{
  "ok": true,
  "data": {
    "results": [
      {
        "product_id": "Z1A0534B39B17B70379C2Z",
        "variant_sku": "Z1A0534B39B17B70379C2Z-1",
        "title": "Nikias Nida Abaya With Folded Band",
        "brand": "Nikias",
        "brand_code": "nikias",
        "url": "https://www.namshi.com/kuwait-en/buy-nikias-nikias-nida-abaya-with-folded-band/Z1A0534B39B17B70379C2Z/p/",
        "image": "https://f.nooncdn.com/p/pzsku/Z1A0534B39B17B70379C2Z/45/1765551811/dd5591ce-3886-4af7-820c-cfae7f5fbf87.jpg?format=webp&width=800",
        "images": [
          "https://f.nooncdn.com/p/pzsku/Z1A0534B39B17B70379C2Z/45/1765551811/dd5591ce-3886-4af7-820c-cfae7f5fbf87.jpg?format=webp&width=800",
          "https://f.nooncdn.com/p/pzsku/Z1A0534B39B17B70379C2Z/45/1764854944/592d37f9-0ef8-422f-9b10-dcc05237523e.jpg?format=webp&width=800",
          "https://f.nooncdn.com/p/pzsku/Z1A0534B39B17B70379C2Z/45/1765551811/dce3e145-112d-4eba-834e-000bbf2885d2.jpg?format=webp&width=800"
        ],
        "price": 15.58,
        "price_before_discount": 63.34,
        "discount_percent": 76,
        "currency": "KWD",
        "market": "kw",
        "rating": null,
        "review_count": null,
        "rating_scale": null,
        "placement": "organic",
        "express_delivery": false,
        "global_delivery": false,
        "outlet": true,
        "has_size_variants": true,
        "max_quantity": 10,
        "listing_type": "product"
      },
      {
        "product_id": "ZD9748148CB2113EED95CZ",
        "variant_sku": "ZD9748148CB2113EED95CZ-1",
        "title": "Women's Abaya with Matching Sheila",
        "brand": "Reem Abayas",
        "brand_code": "reem_abayas",
        "url": "https://www.namshi.com/kuwait-en/buy-reem-abayas-women-s-abaya-with-matching-sheila/ZD9748148CB2113EED95CZ/p/",
        "image": "https://f.nooncdn.com/p/pzsku/ZD9748148CB2113EED95CZ/45/_/1781634679/4aa1b04e-b6f9-4ff6-a55b-1dee19955bb4.jpg?format=webp&width=800",
        "images": [
          "https://f.nooncdn.com/p/pzsku/ZD9748148CB2113EED95CZ/45/_/1781634679/4aa1b04e-b6f9-4ff6-a55b-1dee19955bb4.jpg?format=webp&width=800",
          "https://f.nooncdn.com/p/pzsku/ZD9748148CB2113EED95CZ/45/_/1781634693/cfbc78a3-de06-4477-b3cd-c927c73efea3.jpg?format=webp&width=800"
        ],
        "price": 17.35,
        "price_before_discount": 22.43,
        "discount_percent": 23,
        "currency": "KWD",
        "market": "kw",
        "rating": null,
        "review_count": null,
        "rating_scale": null,
        "placement": "organic",
        "express_delivery": false,
        "global_delivery": false,
        "outlet": false,
        "has_size_variants": true,
        "max_quantity": 5,
        "listing_type": "product"
      },
      {
        "product_id": "Z95972D3F4B7E40BF7A67Z",
        "variant_sku": "Z95972D3F4B7E40BF7A67Z-1",
        "title": "The Sunburst Black Pleat Abaya",
        "brand": "MSquare Fashion",
        "brand_code": "msquare_fashion",
        "url": "https://www.namshi.com/kuwait-en/buy-msquare-fashion-the-sunburst-black-pleat-abaya/Z95972D3F4B7E40BF7A67Z/p/",
        "image": "https://f.nooncdn.com/p/pzsku/Z95972D3F4B7E40BF7A67Z/45/1765664526/28e6bfea-eada-4d48-a6c1-89d0f59053fd.jpg?format=webp&width=800",
        "images": [
          "https://f.nooncdn.com/p/pzsku/Z95972D3F4B7E40BF7A67Z/45/1765664526/28e6bfea-eada-4d48-a6c1-89d0f59053fd.jpg?format=webp&width=800",
          "https://f.nooncdn.com/p/pzsku/Z95972D3F4B7E40BF7A67Z/45/1765664541/975699ab-e8fc-4ab1-b086-931d9da2ee10.jpg?format=webp&width=800",
          "https://f.nooncdn.com/p/pzsku/Z95972D3F4B7E40BF7A67Z/45/1765664557/e4eeaaf8-e25b-4b79-95a2-abe0843e7fdd.jpg?format=webp&width=800"
        ],
        "price": 27.08,
        "price_before_discount": 56.2,
        "discount_percent": 52,
        "currency": "KWD",
        "market": "kw",
        "rating": null,
        "review_count": null,
        "rating_scale": null,
        "placement": "organic",
        "express_delivery": false,
        "global_delivery": false,
        "outlet": true,
        "has_size_variants": true,
        "max_quantity": 10,
        "listing_type": "product"
      }
    ],
    "count": 60,
    "total_results": 4354,
    "total_pages": 73,
    "page": 1,
    "echoed_query": "abaya",
    "department": "all",
    "breadcrumbs": null,
    "filters": [
      {
        "code": "brand_code",
        "name": "Brand",
        "type": "multiselect",
        "options": [
          {
            "code": "aara",
            "name": "Aara",
            "count": 10
          },
          {
            "code": "adidas",
            "name": "Adidas",
            "count": 3
          },
          {
            "code": "al_bent_al_sharqieh",
            "name": "Al Bent Al Sharqieh",
            "count": 135
          }
        ],
        "range": null
      },
      {
        "code": "current_price",
        "name": "Price",
        "type": "range",
        "options": null,
        "range": {
          "min": 0.31,
          "max": 178.25
        }
      }
    ],
    "sorts_available": [
      "Recommended",
      "Discount",
      "New Arrivals"
    ],
    "currency": "KWD",
    "market": "kw",
    "country": "kw",
    "language": "en",
    "redirected": false,
    "landing_path": null,
    "query": "abaya"
  },
  "meta": {}
}
Real response, fetched from the live endpoint with the parameters on the left — trimmed to the first few rows, with seller names left out. Press Try it for the untrimmed response.

Try every endpoint in the playground

Endpoints

What Namshi endpoints does ReefAPI ship?

3 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    1 cr

    Search one namshi storefront by keyword and get the matching products.

    required
    query
    optional
    country, language, page, sort, brand, colour, price_min, price_max, discounted_only, new_arrivals_only, delivery_type
  • category/products

    1 cr

    List one namshi category by its path.

    required
    category
    optional
    country, language, page, sort, brand, colour, price_min, price_max, discounted_only, new_arrivals_only, delivery_type
  • product/detail

    1 cr

    The full namshi product record for one product in one market.

    required
    product_id
    optional
    country, language

Every parameter, every allowed value →

Missing a Namshi endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Namshi API works

Namshi is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /namshi/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

Pick the market first, because the same product is a different price in a different currency

Namshi runs six Gulf storefronts. The same item carries a different figure in each, in that country's own currency, and the number a shopper sees on the page is the one that matters.

01search
POST/namshi/v1/search
{"query": "abaya", "market": "kw"}

1 credit for sixty rows. price is what a Kuwaiti shopper sees, in Kuwaiti dinar, and currency says so on every row. Change market and the figures and the currency change with it.

02search
POST/namshi/v1/search
{"query": "abaya", "market": "ae", "sort": "price_low_to_high"}

1 credit. Sorts are the site's own codes. A sort value Namshi does not know makes it return its whole catalogue, so an unknown sort is refused rather than passed through.

03products
POST/namshi/v1/category/products
{"category": "<path from the search response>", "market": "sa"}

1 credit. A whole department in one market, with the same rows and the same currency rule.

04detail
POST/namshi/v1/product/detail
{"sku": "<from any row>", "market": "ae"}

1 credit. The full product with its size variants. A sold-out size quotes its own stale price, so read availability alongside the figure rather than instead of it.

Six markets you can compare honestly, because each figure is the one that market publishes rather than one converted on our side.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "namshi",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Coverage

Six Gulf markets, six currencies, and a conversion trap that cost three point two times

Measured 2026-09-30 against the live gateway across four markets and 236 rows, then re-checked against the figures Namshi prints. Three of these lines go against us.

Six markets, each in its own currency

The UAE in dirham, Saudi Arabia in riyal, Kuwait in dinar, Bahrain in dinar, Oman in rial and Qatar in riyal. All six were exercised, and across 236 measured rows the currency matched the market on every single one. Arabic is available alongside English on the same storefronts.

The number published is the number Namshi prints, not a converted one

This matters more here than on most sources. Namshi's own store quotes the UAE and Saudi Arabia in their local currencies but quotes Kuwait, Bahrain, Oman and Qatar in US dollars, and the page converts before it prints. Reading the store figure directly and labelling it with the local currency made four of the six markets wrong by roughly three point two times, with every field filled and nothing obviously broken: a Kuwaiti abaya that prints as 15.58 dinar came back as 50.26. The engine now measures the conversion on the page itself and requires it to land on a rate the page publishes, refusing the record rather than guessing when it does not.

Against us: a price band in four of the six markets costs two upstream requests

Namshi filters on the store's own scale, and that scale is only knowable by reading a page first. In the UAE and Saudi Arabia a filtered search is a single request; in Kuwait, Bahrain, Oman and Qatar it is two. You are charged the same either way; the extra cost is ours.

Against us: an unknown sort makes the source return everything

A sort value Namshi does not recognise answers with its entire catalogue of 386,656 rows and a wildcard query, as though that were a result. Unknown sorts are refused with an invalid parameter, and the response echo is checked as a second guard. The same shape of trap as a dropped filter, and it is caught the same way.

A dead product answers with a page, not a 404

Namshi returns a normal HTTP 200 for a product that no longer exists, so a not-found is decided on whether the page is actually complete rather than on its status code. That means a removed product is reported as not found and never as the site blocking us.

Against us: ratings are on a minority of rows

Namshi publishes an aggregate rating for a minority of its catalogue. Across 236 rows, 84 carried one; the rest come back null rather than zero, which would place unrated items below every rated one in a sort. The struck original and the discount were on 205 of 236, because not everything is marked down.

A brand or department keyword redirects, and the redirect is followed once

Searching a brand name answers with a redirect to that brand's own landing page rather than with search results. The engine follows it once and reports that it did, along with where it landed, so a caller can tell a keyword result from a landing page.

Not published, so not returned

No seller, no barcode, no review feed and no size filter. Namshi's size facets are per category and per sizing standard at once, so a single size handle cannot work across the catalogue; the full facet catalogue with its codes and counts is returned instead so a caller can build the filter that fits their category.

Placement is passed through as the source writes it

Across 829 rows on fourteen keywords, every row came back as organic: Namshi's storefront carries no sponsored marker at all. That is reported as the source publishes it rather than inferred from position.

Price

1 credit for a search of sixty rows, a category page or a product record. This engine needs no browser and no residential vantage point; it reads from an ordinary datacentre exit, which is why it is priced at the low end.

Use cases

What people build with Namshi

The jobs this data is most often used for.

01

Pricing teams use Namshi to search one namshi storefront by keyword and get the matching products.

02

Marketplace operators use Namshi to list one namshi category by its path.

03

Catalog enrichment teams use Namshi to get the full namshi product record for one product in one market.

3

endpoints

1

credit per call

Pricing

What Namshi data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Namshi.

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.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-09-30.