Sharaf DG API & Scraper
Sharaf DG is one of the largest electronics retailers in the Gulf, with stores across the UAE, Bahrain and Oman and a marketplace of third-party sellers on the same site.
🤖 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.
This API reads its catalogue as JSON; `country` picks the store (ae, bh, om) and prices come in AED, BHD or OMR exactly as the site prints them (BHD and OMR with three decimals). `search` takes a keyword, a category or a brand, with filters for price range, in stock, in stock at a given store, seller and on sale, three sorts (relevance, lowest price, highest price), and returns up to 100 products per page: product code, model number, title, brand, price, price before discount and the discount, whether it is in stock and in how many stores, the seller (Sharaf DG itself or a marketplace seller), shipping fee, rating and review count, category path and key specs, plus the source's own total and whether that total is exact. `product` returns one product in full: every seller's offer, stock in every store with pickup and delivery flags, the full specification table, description and images. `reviews` returns the product's review feed with the star distribution, `categories` the category tree with live counts, and `stores` the stores that hold stock.
What a Sharaf DG field actually contains
Fields that read differently from how they look. Every row was measured against live responses on 2026-10-15.
| Field | What it holds |
|---|---|
| sku, product_id | sku is the code the site prints as 'Item S600982431'. product_id is the catalogue record id (759456). product accepts either, or a product URL. Search to product returned the same sku, product_id and price on 10 of 10 products in the three countries. |
| price, price_before_discount | price is what the shopper pays now. price_before_discount is the crossed-out price, filled only when the site crosses one out. On some marketplace listings the stored regular price is lower than the selling price; then price_before_discount is null, regular_price keeps the stored number and regular_price_below_price is true. |
| currency | AED in the UAE (two decimals), BHD in Bahrain and OMR in Oman (three decimals: 488.994 BHD is four hundred and eighty-eight dinars, not thousands). |
| seller, offers | seller is the offer the product page shows by default: Sharaf DG itself or a marketplace seller such as Digital Empire or vidaXL. product lists every seller's offer with its own price, regular price, shipping fee and default and best flags. |
| store_stock, stores_in_stock_count | product lists every store the record names with in_stock, store pickup and home delivery flags. stores_in_stock_count is the number of stores holding stock; it is null for products sold only online by a marketplace seller. |
| total, total_is_exact | The source's own count. For category and brand listings it is exact; for keyword searches the source returns an estimate and total_is_exact is false. |
| rating, reviews | rating is out of 5 as the product page prints it. The review feed scores each review out of 10 (score, score_max) and also gives rating out of 5. Reviews include ones collected from other retailers and review sites; source names where each came from. |
Price, price before discount, currency, seller and rating were compared with the product page itself for 10 products in the UAE, Bahrain and Oman: 10 of 10 matched, in two separate runs.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/sharafdg/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "samsung tv",
"country": "ae"
}
}{
"ok": true,
"meta": {
"api": "sharafdg",
"endpoint": "search",
"mode": "live",
"latency_ms": 918.5,
"record_count": 24,
"bytes": 81946,
"cache_hit": false,
"upstream_requests": 1,
"total": 106,
"charged_credits": 2,
"version": "0.1.0",
"request_id": "7e7beb1129e5426c",
"queue_ms": 1.1,
"fetched_at": "2026-10-15T17:02:59.007Z"
},
"data": {
"results": [
{
"sku": "S500930752",
"product_id": "737578",
"item_code": "1364043",
"model_number": "UA55U8000FUXZN",
"title": "Samsung 55\" U8000F 4K UHD Tizen Television (2025 Model) - UA55U8000FUXZN",
"brand": "Samsung",
"url": "https://uae.sharafdg.com/product/samsung-55inch-u8000f-4k-uhd-tizen-television-2025-model-ua55u8000fuxzn/",
"image": "https://pimcdn.sharafdg.com/cdn-cgi/image/width=300,height=300,fit=pad/images/S500930752_1?1786527433",
"country": "ae",
"currency": "AED",
"price": 1249,
"price_before_discount": 1611,
"regular_price": 1611,
"regular_price_below_price": false,
"discount_percent": 22,
"discount_amount": 362,
"discount_label": "Save 9%",
"in_stock": true,
"stores_in_stock_count": 7,
"seller": "SMPT",
"seller_code": "mktp-S00488268",
"marketplace": true,
"offer_count": 4,
"shipping_fee": 13,
"rating": 4.5,
"review_count": 366,
"category": "TVs",
"category_path": "TV, Video & Audio > TVs",
"product_type": "TV",
"tags": [],
"key_specs": {
"OS": "Tizen TV",
"HDMI": "3",
"Type": "UHD",
"Color": "Black",
"USB Slots": "1",
"Resolution": "3840 x 2160",
"Screen Size": "55 in",
"Dimensions (W x H x D) with Stand": "1224.6 x 759.1 x 199 mm"
},
"updated_at": "2026-10-15 20:00:31"
},
{
"sku": "S500928611",
"product_id": "737774",
"item_code": "1362120",
"model_number": "QA75Q7FAAUXZN",
"title": "Samsung 75\" Q7F 4K QLED Smart Television - QA75Q7FAAUXZN (2025 Model)",
"brand": "Samsung",
"url": "https://uae.sharafdg.com/product/samsung-75inch-q7f-4k-qled-smart-television-2025-model-qa75q7faauxzn/",
"image": "https://pimcdn.sharafdg.com/cdn-cgi/image/width=300,height=300,fit=pad/images/S500928611_1?1775135055",
"country": "ae",
"currency": "AED",
"price": 3592,
"price_before_discount": 4420,
"regular_price": 4420,
"regular_price_below_price": false,
"discount_percent": 19,
"discount_amount": 828,
"discount_label": "Save 20%",
"in_stock": true,
"stores_in_stock_count": 1,
"seller": "SMPT",
"seller_code": "mktp-S00488268",
"marketplace": true,
"offer_count": 2,
"shipping_fee": 13,
"rating": 4.7,
"review_count": 230,
"category": "TVs",
"category_path": "TV, Video & Audio > TVs",
"product_type": "TV",
"tags": [],
"key_specs": {
"OS": "Tizen TV",
"HDMI": "3",
"Type": "QLED",
"Color": "Black",
"USB Slots": "1",
"Resolution": "3840 x 2160",
"Screen Size": "75 in",
"Dimensions (W x H x D) with Stand": "1677.5 x 1006.3 x 325 mm"
},
"updated_at": "2026-10-15 21:01:11"
},
{
"sku": "S500938273",
"product_id": "741303",
"item_code": "1370146",
"model_number": "QA65Q8FAAUXZN",
"title": "Samsung 65\" Q8F 4K QLED Smart Television - QA65Q8FAAUXZN (2025 Model)",
"brand": "Samsung",
"url": "https://uae.sharafdg.com/product/samsung-65inch-q8f-4k-qled-smart-television-2025-model-qa65q8faauxzn/",
"image": "https://pimcdn.sharafdg.com/cdn-cgi/image/width=300,height=300,fit=pad/images/S500938273_1?1775135225",
"country": "ae",
"currency": "AED",
"price": 3550,
"price_before_discount": null,
"regular_price": 2766,
"regular_price_below_price": true,
"discount_percent": null,
"discount_amount": 167,
"discount_label": null,
"in_stock": true,
"stores_in_stock_count": 4,
"seller": "Safe Home",
"seller_code": "mktp-S00587704",
"marketplace": true,
"offer_count": 2,
"shipping_fee": 75,
"rating": 4.7,
"review_count": 461,
"category": "TVs",
"category_path": "TV, Video & Audio > TVs",
"product_type": "TV",
"tags": [],
"key_specs": {
"OS": "Tizen TV",
"HDMI": "3",
"Type": "QLED",
"Color": "Black",
"USB Slots": "2",
"Resolution": "3840 x 2160",
"Screen Size": "65 in",
"Dimensions (W x H x D) with Stand": "1450.9 x 890.0 x 270.4 mm"
},
"updated_at": "2026-10-15 16:20:49"
}
],
"country": "ae",
"currency": "AED",
"total": 106,
"total_is_exact": true,
"page": 1,
"page_size": 24,
"last_page": 5,
"has_more": true,
"sort": "relevance",
"beyond_last_page": false
}
}What the Sharaf DG API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the Sharaf DG catalogue (UAE, Bahrain or Oman) by keyword and/or category or brand, with price range, in-stock, store, seller and on-sale filters and three sorts. Each row: sku, product id, model number, title, brand, URL, image, price, price before discount, discount, in-stock flag, number of stores with stock, seller (Sharaf DG or a marketplace seller), offer count, shipping fee, rating, review count, category path, tags, key specs. Plus the source's own total and whether that total is exact. Either `query`, `category` or `brand` is required. | Pricing teams call search to search the Sharaf DG catalogue (UAE, Bahrain or Oman) by keyword and/or category or brand, wi…. | country, query, category, brand, min_price, ... |
| product | Full record of one product in one country: title, brand, sku, product id, model number, price, price before discount, discount, every seller's offer (price, regular price, shipping fee, default / best flags), stock per store with pickup and delivery flags, the full specification table, key specs, description, summary, images, rating and review count, category path, tags. | Marketplace operators call product to get full record of one product in one country. | sku |
| reviews | The review feed the product page shows: user reviews (syndicated from other retailers and Sharaf DG's own) or expert reviews, each with date, title, text, author, score, source and pros/cons for experts, plus the product's overall rating (out of 5), review counts and the 1-5 star distribution. Paged with `cursor`. | Catalog enrichment teams call reviews to get the review feed the product page shows. | sku, country, type, cursor |
| categories | The category tree with the number of in-stock products in each category — the exact values the search `category` filter accepts. Top level by default, or the children of `parent`. | Retail analysts call categories to get the category tree with the number of in-stock products in each category. | country, parent |
| stores | The stores that currently hold stock, with the number of in-stock products each one carries (the values the search `store` filter accepts). | Pricing teams call stores to get the stores that currently hold stock, with the number of in-stock products each one carries (…. | country |
Call search from your stack
curl -X POST https://api.reefapi.com/sharafdg/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"samsung tv","country":"ae"}'import requests
r = requests.post(
"https://api.reefapi.com/sharafdg/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "samsung tv",
"country": "ae"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/sharafdg/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "samsung tv",
"country": "ae"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.sharafdg.search with {"query":"samsung tv","country":"ae"}.Who uses this API and why
- Track Sharaf DG prices and discounts in the UAE, Bahrain and Oman daily.
- Compare Sharaf DG's own price with marketplace sellers' offers on the same product.
- Watch stock in a specific mall store for pickup availability.
- Match Gulf electronics to other retailers by model number and full specifications.
- Monitor review scores and star distributions for a product line.
Questions developers ask before integrating
Which countries are covered?
The UAE (uae.sharafdg.com, AED), Bahrain (bahrain.sharafdg.com, BHD) and Oman (oman.sharafdg.com, OMR). Pass country=ae, bh or om; one call reads one country. Egypt and Qatar are not offered: their online stores were not serving on 2026-10-15.
Do I need an account?
No. Everything is read logged out.
Which filters are there and do they work?
Category, brand, price range, in stock, in stock at a store, seller and on sale. Each was checked against the unfiltered count in the same run: tv in the UAE 431 → Samsung 105, 1,000-3,000 AED 140, in stock at Dubai Mall 100, sold by Sharaf DG 235, on sale 292, including out-of-stock items 760. An unknown brand or category returns 0 rows.
Are out-of-stock products included?
Not by default: like the site's own listings, search returns products in stock. Pass in_stock=false to include out-of-stock products too.
Can I see stock in a specific store?
Yes. product returns stock for every store by name with pickup and delivery flags, and search takes store to keep only products in stock at that store. The stores action lists the store names: 23 in the UAE, 6 in Bahrain and 7 in Oman on 2026-10-15.
What do the price sorts do?
price_asc and price_desc are the site's own sorts, strictly ordered by price. For a keyword they keep only the closest matches, so the total can be smaller than with relevance (iphone: 1,939 by relevance, 110 by highest price).
Are warranty and instalment plans included?
No. The warranty line and the Tabby / Tamara instalment widgets appear on the product page only and are not returned. Instalment amounts are never mixed into price.
How deep can I page?
Up to 100 products per page; last_page and has_more tell you where a result set ends.
What is the Sharaf DG API?
Sharaf DG API is a ReefAPI endpoint group for the gulf electronics chain in the uae, bahrain and oman: prices, struck prices, every seller's offer, stock per store, full specs and reviews. It returns live JSON through POST requests under /sharafdg/v1.
Is the Sharaf DG API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Sharaf DG calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Sharaf DG login or account?
No login to Sharaf DG 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 Sharaf DG 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 Sharaf DG API use?
Sharaf DG actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Sharaf DG from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call sharafdg actions with the same key, credit pool and JSON envelope used by normal REST requests.