Search Saudi Arabia's largest electronics and books retailer, then read any product with its stock in every showroom
Jarir Bookstore is the largest electronics, books and office retailer in Saudi Arabia, with storefronts in Kuwait, Qatar, the UAE and Bahrain.
4 active endpoints, on 1, 2 and 3 credit tiers.
- POST/jarir/v1/search
- POST/jarir/v1/product
- POST/jarir/v1/reviews
- POST/jarir/v1/store_stock
What Jarir Bookstore endpoints does ReefAPI ship?
4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Jarir Bookstore API
5 of 4 endpoints, ready to run
iPhone 17 in Saudi Arabia
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the Jarir Bookstore API works
Jarir Bookstore is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 491 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a product word to its price, stock and nearest showroom
Search with Jarir's own filters, read the product that matters, then see which showrooms hold it.
Rows with the price you pay, regular price, discount, in-stock flag and seller. total, brand and product-type facets are Jarir's own.
Online stock quantity, delivery and pickup options, Tabby/Tamara eligibility, spec table, every variant with its own price and stock, rating.
Every showroom in the country with AVAILABLE, LIMITED or OUTOFSTOCK, address, hours and coordinates.
A dated price and availability feed for Jarir in five Gulf countries, down to the individual showroom.
curl -X POST https://api.reefapi.com/jarir/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 17","country":"sa"}'{
"ok": true,
"data": { … },
"meta": {
"api": "jarir",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Jarir field actually contains
Fields that read differently from how they look. Every row was measured against live Jarir pages on 2026-10-14.
| Field | What it holds |
|---|---|
| sku | Jarir's SKU, the number at the end of the product address (…-666789.html). Marketplace offers are JPP-<digits>, a product family with variants is JPM<digits>. SKUs belong to one storefront: the same iPhone is 666789 in Saudi Arabia and 672350 in Kuwait. Search to product returned the same SKU on 14 of 14 rows. |
| price, regular_price | price is what the shopper pays, VAT included. regular_price is the struck-through price and is only set when the product is discounted. Jarir's own search index shows the regular price as the price; this API always returns the catalogue's paid price. price matched the product page on 9 of 9 pages that publish one. |
| discount_pct, source_discount_pct | discount_pct is computed from the two prices with one decimal (a 10 SAR cut on 2,599 SAR is 0.4). source_discount_pct is Jarir's own rounded figure, which says 0 for that case. |
| currency | The storefront's own currency: SAR (Saudi Arabia), KWD (Kuwait, 3 decimals), QAR (Qatar), AED (UAE), BHD (Bahrain, 3 decimals). No conversion is applied. |
| stock.available_qty | Online stock as Jarir's cart reads it. It stops at 100: every first-party product read showed 100, so stock_qty_is_capped is true at 100. Marketplace offers showed real small counts (2, 3, 78). |
| sold_by, seller_name | jarir for Jarir's own stock, marketplace for offers from third-party sellers on Jarir's marketplace, with the seller's registered name. |
| brand (books) | For books Jarir's brand is the publisher (Bloomsbury for Harry Potter). The author is in specs, the ISBN in barcode and mpn. |
| matched_by | keyword when the row matched the search words, semantic when Jarir's search engine added it by meaning. A query with no keyword match at all still returns semantic rows; match_counts and a warning say so. |
Prices and stock did not depend on where the request came from: the same 10 products read from a Saudi connection and from outside the Kingdom gave identical prices, regular prices, stock flags and quantities (10 of 10).
Jarir Bookstore coverage, measured
Every number below was read from live Jarir responses on 2026-10-14, in two runs of 66 calls each; the second answered 66 of 66 as expected.
Saudi Arabia (SAR), Kuwait (KWD), Qatar (QAR), UAE (AED), Bahrain (BHD), each in English and Arabic. "iphone 17": 750 / 551 / 495 / 490 / 458 results.
"laptop" 856 → Lenovo 91, Lenovo or HP 183, 1,000 to 2,000 SAR 47, 8,000 SAR and up 109, product type Laptops 229; an unknown brand gives 0.
On 192 search rows across 8 queries (phones, laptops, books, pens, printers, audio, toys, bags): SKU, name, brand, barcode, part number, price, currency and stock flag 192/192, model 171/192, regular price on the 36 discounted rows.
The price matched the product page on 9 of 9 pages that publish one; search row and product agreed on price, regular price and stock on 14 of 14 SKUs.
67 showrooms in Saudi Arabia per product, each AVAILABLE, LIMITED or OUTOFSTOCK, with address, hours, phone and coordinates.
Online stock quantity stops at 100; SKUs differ per country; no delivery date (it needs a delivery address); no per-product monthly installment amount, only eligibility.
What people build with Jarir Bookstore
The jobs this data is most often used for.
endpoints
credits per call
Track Saudi electronics prices and discounts daily, with the regular price and the discount Jarir shows.
Compare the same product's price across Saudi Arabia, Kuwait, Qatar, the UAE and Bahrain in each local currency.
Check which Jarir showrooms in a city have a product before sending customers there.
Monitor third-party marketplace sellers on Jarir: who sells what, at what price and stock.
What Jarir Bookstore 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.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 491 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
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 -X POST https://api.reefapi.com/jarir/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 17","country":"sa"}'import requests
r = requests.post(
"https://api.reefapi.com/jarir/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 17",
"country": "sa"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Jarir Bookstore.
Get a free key →Which countries are covered?▾
All five Jarir storefronts: Saudi Arabia (default), Kuwait, Qatar, the UAE and Bahrain, each with its own catalogue, SKUs and currency. "iphone 17" on 2026-10-14: 750 results in Saudi Arabia, 551 in Kuwait, 495 in Qatar, 490 in the UAE, 458 in Bahrain.
Can I get the data in Arabic?▾
Yes. lang=ar returns Jarir's Arabic catalogue: Arabic names, spec labels and showroom names. Arabic queries work too ("ايفون" matched 2,466 products), and Arabic-Indic digits in prices and SKUs are accepted.
Which filters are there?▾
Brand, product type, price range and price sort. Each was checked against the unfiltered count in the same run: "laptop" 856 → Lenovo 91, Lenovo or HP 183, 1,000 to 2,000 SAR 47, 8,000 SAR and up 109, product type Laptops 229. An unknown brand returns 0 rows rather than everything.
Can I list a whole brand or product type without a keyword?▾
Yes. Call search with only brand or only product_type. Samsung alone listed 1,973 products in Saudi Arabia.
Do you return showroom stock?▾
Yes. store_stock lists every showroom in the country with AVAILABLE, LIMITED or OUTOFSTOCK, plus address, opening hours, phone and coordinates. For an iPhone 17 in Saudi Arabia: 67 showrooms, 61 available, 3 limited, 3 out of stock.
Is Tabby or Tamara available for a product?▾
product returns Jarir's own eligibility flags for Tabby, Tamara, Tamara Plus and Jarir's installment service, plus the full list of payment methods the product accepts. Jarir does not publish a per-product monthly amount, so none is returned.
How deep can I page?▾
Up to 48 rows per page; page until has_more is false. Paging past the end returns an empty page, it never repeats the last one.
Do you return delivery dates?▾
Not yet. Jarir computes the delivery date from a delivery address (city and district); product returns the order cut-off time and whether home delivery and showroom pickup are offered.
What is the Jarir Bookstore API?▾
Jarir Bookstore API is a ReefAPI endpoint group for saudi arabia's largest electronics and books retailer, plus kuwait, qatar, uae and bahrain: price, discount, online and showroom stock, seller, specs and reviews. It returns live JSON through POST requests under /jarir/v1.
Is the Jarir Bookstore API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Jarir Bookstore calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Jarir Bookstore login or account?▾
No login to Jarir Bookstore 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 Jarir Bookstore 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 Jarir Bookstore API use?▾
Jarir Bookstore 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 Jarir Bookstore from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call jarir actions with the same key, credit pool and JSON envelope used by normal REST requests.
231 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Jarir Bookstore, you are one call away from the rest of the category — no second contract, no second integration.
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.
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 490 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-10-14.