OpenSooq API & Scraper
The OpenSooq API returns the classifieds of OpenSooq, one of the largest general marketplaces of the Middle East and North Africa, as clean JSON in three actions, one country site per call.
🤖 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.
It covers 18 sites: Jordan, Saudi Arabia, Kuwait, Iraq, Oman, Qatar, Bahrain, the UAE, Egypt, Libya, Lebanon, Palestine, Syria, Yemen, Sudan, Morocco, Algeria and Tunisia. On 2026-10-14 Jordan carried about 148,600 listings, Oman 94,700, Iraq 88,900, Libya 50,400 and the UAE 28,700. search filters by free text in Arabic or English, category and subcategory, city and neighbourhood, price range, any filter of the category's own form (car make, model, year, mileage, fuel and gearbox; property rooms and area; phone brand and storage) and seller, in OpenSooq's four sort orders. Every response carries OpenSooq's own total and 30 listings a page, each with the listing id, title, price and the currency it is printed in, the currency the seller listed in, the card's attribute chips, category, city and neighbourhood with ids, posting date, promotion status, photo and the seller's name, shop, rating and verification level. listing opens one ad in full: description, every price the listing carries, the labelled attribute table, publication date, all photos, favourites count, AI tags, breadcrumbs and the seller's listings count, member-since date and response time. categories returns each country's categories, cities, neighbourhoods and the full filter form with value ids, so every filter can be built without guessing. Labels come in English or Arabic. One ReefAPI key, the standard { ok, data, meta, error } envelope.
Which price and which currency
On sites that accept several currencies, OpenSooq prints the search card's price converted into the site's display currency. The API keeps both currencies apart; the examples were measured on 2026-10-14.
| Field | What it is | Example |
|---|---|---|
| price + currency | The number the search card prints and the currency it is printed in | 26,825,000 IQD (an Iraqi listing) |
| listing_currency | The currency the seller listed the item in | USD |
| price_converted | true when the card shows OpenSooq's conversion rather than the seller's own figure | true |
| listing_price (listing) | The seller's own price, as the listing page headline shows it | 18,500 USD |
| prices[] (listing) | Every price the listing carries, with currency | IQD 26,825,000 · USD 18,500 |
| price_published | false when the ad shows no price | false (a 2026 Honda City, Jordan) |
Lebanon printed every measured card in LBP while all 30 sellers listed in USD; Iraq, Libya, Palestine, Yemen and Sudan mix currencies the same way. The other 12 sites use a single currency. Read listing_currency and price_converted before comparing prices across ads.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/opensooq/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"country": "jo",
"query": "iphone"
}
}{
"ok": true,
"meta": {
"api": "opensooq",
"endpoint": "search",
"mode": "live",
"latency_ms": 1552.1,
"record_count": 30,
"bytes": 636349,
"cache_hit": false,
"stop_reason": "complete",
"lang": "en",
"charged_credits": 3,
"version": "1.0.0",
"request_id": "3d3f64ccabc44c31",
"fetched_at": "2026-10-14T18:57:29.876Z"
},
"data": {
"rows": [
{
"id": "287227484",
"country": "jo",
"url": "https://jo.opensooq.com/en/search/287227484",
"title": "iPhone 17 Pro Max 256GB Orange دورات الشحن صفر",
"price": 849,
"currency": "JOD",
"price_as_published": "849 JOD",
"price_published": true,
"listing_currency": "JOD",
"price_converted": false,
"highlights": "Apple » iPhone 17 Pro Max » 256 GB",
"attributes_as_published": [
"Apple",
"iPhone 17 Pro Max",
"256 GB"
],
"description_preview": "iPhone 17 Pro Max 256GB Orange عدد دورات الشحن صفر غير مستخدم إذا بدك أحدث iPhone Pro Max بلون مميز وحالة ممتازة هذا الجهاز…",
"category": "Mobile - Tablet",
"category_code": "MobileTablet",
"category_slug": "mobile-phones-tablets",
"subcategory": "Mobiles",
"subcategory_code": "MobilePhones",
"subcategory_slug": "mobile-phones",
"city": "Amman",
"city_id": 59,
"neighborhood": "Al Gardens",
"neighborhood_id": 6759,
"posted_at_as_published": "07-10-2026",
"posted_date": "2026-10-07",
"inserted_date": "2026-09-16",
"expires_as_published": "Yesterday",
"listing_status": "posted",
"promoted": false,
"promotion": null,
"post_badges": [
"add_on_chat"
],
"flags": [
"DeliveryService"
],
"mileage_km": null,
"image_url": "https://opensooq-imagesv2.os-cdn.com/previews/640x480/d8/e2/d8e2e57216aeba9decfc20b664f5d946f93e3a2623412f0afdfe1aa24a097565.jpg.webp",
"image_count": 9,
"has_video": false,
"has_360": false,
"has_phone": true,
"phone_masked": "07888866XX",
"seller": {
"member_id": "38496397",
"name": "iService mobile",
"username": "iservice",
"shop_name": "iService mobile",
"type": "membership",
"badges": [
"[trimmed-depth]"
],
"rating_avg": 3.45,
"rating_count": 142,
"verification_level": 2,
"shop_logo_url": "https://opensooq-imagesv2.os-cdn.com/previews/300x300/c2/49/c249807c45628ccffbb9ae502b7827e28813c0556a8aa5b7c49d4593232955c0.jpg.webp"
}
},
{
"id": "287562686",
"country": "jo",
"url": "https://jo.opensooq.com/en/search/287562686",
"title": "جديد ايفون 17 برو ماكس 256 جيجا AUTO SIM جديد غير مستخدم 17 promax 256GB",
"price": 725,
"currency": "JOD",
"price_as_published": "725 JOD",
"price_published": true,
"listing_currency": "JOD",
"price_converted": false,
"highlights": "Apple » iPhone 17 Pro Max » 256 GB",
"attributes_as_published": [
"Apple",
"iPhone 17 Pro Max",
"256 GB"
],
"description_preview": "جديد ايفون 17 برو ماكس 256 جيجا AUTO SIM جديد غير مستخدم Auto sim 17 pro max 256GB iPhone 17 Pro Max – قوة وأداء بدون حدود إذا…",
"category": "Mobile - Tablet",
"category_code": "MobileTablet",
"category_slug": "mobile-phones-tablets",
"subcategory": "Mobiles",
"subcategory_code": "MobilePhones",
"subcategory_slug": "mobile-phones",
"city": "Amman",
"city_id": 59,
"neighborhood": "Khalda",
"neighborhood_id": 6835,
"posted_at_as_published": "Now",
"posted_date": null,
"inserted_date": "2026-09-22",
"expires_as_published": "22-10-2026",
"listing_status": "reposted",
"promoted": false,
"promotion": null,
"post_badges": [
"add_on_chat"
],
"flags": [
"DeliveryService"
],
"mileage_km": null,
"image_url": "https://opensooq-imagesv2.os-cdn.com/previews/640x480/f4/10/f4108c88462f11da44f4de42e5885eb5b43ab63eb9a8e547ea026a948cb55a51.jpg.webp",
"image_count": 2,
"has_video": false,
"has_360": false,
"has_phone": true,
"phone_masked": "07969992XX",
"seller": {
"member_id": "80607739",
"name": "Trio Mobile",
"username": "member-1770220543.0985384",
"shop_name": "Trio Mobile",
"type": "free",
"badges": [],
"rating_avg": 3.21,
"rating_count": 39,
"verification_level": 1,
"shop_logo_url": "https://opensooq-imagesv2.os-cdn.com/previews/300x300/59/7a/597a05840bbe5f81d3797ca4dab68e1c8eee570349e8027e0df4371f13d9003d.jpg.webp"
}
},
{
"id": "288585544",
"country": "jo",
"url": "https://jo.opensooq.com/en/search/288585544",
"title": "IPhone 17 pro max 256GB جديد بسعر مميز",
"price": 825,
"currency": "JOD",
"price_as_published": "825 JOD",
"price_published": true,
"listing_currency": "JOD",
"price_converted": false,
"highlights": "Apple » iPhone 17 Pro Max » 256 GB",
"attributes_as_published": [
"Apple",
"iPhone 17 Pro Max",
"256 GB"
],
"description_preview": "IPhone 17 pro max 256GB جهاز جديد كليا مش مشحون ولا مره كفالة ل شهر 9-2027. جديد من غير كرتونة وافحص وين ما بدك انا بايع جديد…",
"category": "Mobile - Tablet",
"category_code": "MobileTablet",
"category_slug": "mobile-phones-tablets",
"subcategory": "Mobiles",
"subcategory_code": "MobilePhones",
"subcategory_slug": "mobile-phones",
"city": "Amman",
"city_id": 59,
"neighborhood": "Jabal Amman",
"neighborhood_id": 6831,
"posted_at_as_published": "10 minutes ago",
"posted_date": null,
"inserted_date": "2026-10-13",
"expires_as_published": "12-11-2026",
"listing_status": "reposted",
"promoted": false,
"promotion": null,
"post_badges": [
"add_on_chat"
],
"flags": [
"DeliveryService"
],
"mileage_km": null,
"image_url": "https://opensooq-imagesv2.os-cdn.com/previews/640x480/46/07/4607ed125051bc12fbdfdb9a252def8c83b472cf6601b52b7f85a788bf8f7869.jpg.webp",
"image_count": 9,
"has_video": false,
"has_360": false,
"has_phone": true,
"phone_masked": "07902516XX",
"seller": {
"member_id": "19515478",
"name": "Jordanian Eagle Mobile",
"username": "member-150298788848",
"shop_name": "Jordanian Eagle Mobile",
"type": "membership",
"badges": [
"[trimmed-depth]"
],
"rating_avg": 3.13,
"rating_count": 918,
"verification_level": 0,
"shop_logo_url": "https://opensooq-imagesv2.os-cdn.com/previews/300x300/56/90/56901a649707187aa61bae10f82dce8ced17e421ed1d474fb07886cb4ce459aa.jpg.webp"
}
}
],
"summary": {
"country": "jo",
"lang": "en",
"currency": "JOD",
"total_results": 5117,
"page": 1,
"rows_per_page": 30,
"last_page": 171,
"has_more": true,
"past_last_page": false,
"promoted_on_page": 0,
"filters_applied": {
"query": "iphone",
"sort": "default"
}
}
}
}What the OpenSooq API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the classifieds of ONE OpenSooq country site (Jordan, Saudi Arabia, Kuwait, Iraq, Oman, Qatar, Bahrain, UAE, Egypt, Libya, Lebanon, Palestine, Syria, Yemen, Sudan, Morocco, Algeria, Tunisia) by free text, category and subcategory, city and neighbourhood, price range, any filter of the category's own form (car make / model / year / mileage / fuel, property rooms / area / furnishing, phone brand / storage…), seller, in OpenSooq's four sort orders. Returns the source's own total and 30 listings per page with price and currency, attribute chips, location, posting date, promotion status, photo and the seller. `country` is required; every other parameter is optional. | Price-intelligence teams call search to search the classifieds of ONE OpenSooq country site (Jordan, Saudi Arabia, Kuwait, Iraq, Oman…. | country, query, category, subcategory, city_id, ... |
| listing | One OpenSooq listing by `country` + `id` (both from a search row) or by its URL: full description, price with currency, the labelled attribute table (e.g. make, model, year, mileage, fuel, transmission for cars; rooms, bathrooms, area, furnishing, floor for property; brand, model, storage, condition for phones), category and subcategory, city and neighbourhood, publication date, promotion status and badges, all photos, favourites count, AI tags, breadcrumbs and the seller block (name, shop flag, rating, number of listings, member since, response time, verification level, profile URL). | Classifieds aggregators call listing to get one OpenSooq listing by `country` + `id` (both from a search row) or by its URL. | country, id, url, lang |
| categories | For ONE country site (optionally inside a category / subcategory / city / filter): the categories and subcategories with their slugs and listing counts, the cities with ids, the neighbourhoods of a chosen city, and the full filter form of that scope — every filter key with its label, type (values / range / toggle), range bounds, parent filter and value ids with labels (English and Arabic) and counts. These are the values `search` takes as `category`, `subcategory`, `city_id`, `neighborhood_id` and `filters`. Child values (car models of a make) appear once the parent is given in `filters`. | Resale and arbitrage tools call categories to get for ONE country site (optionally inside a category / subcategory / city / filter). | country, category, subcategory, city_id, filters, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/opensooq/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"country":"jo","query":"iphone"}'import requests
r = requests.post(
"https://api.reefapi.com/opensooq/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"country": "jo",
"query": "iphone"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/opensooq/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"country": "jo",
"query": "iphone"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.opensooq.search with {"country":"jo","query":"iphone"}.Who uses this API and why
- Car dealers and importers in Jordan, Iraq, Saudi Arabia and the Gulf price their stock against live private and dealer ads by make, model, year and mileage.
- Property analysts track asking rents and sale prices per city and neighbourhood across 18 countries.
- Phone and electronics resellers follow used-iPhone and Samsung prices by model and storage size.
- Lead-generation teams find active shops and dealers per category and city with their listing counts and ratings.
- Market researchers measure how many listings each category and country holds and how fast they turn over.
Questions developers ask before integrating
Which countries does the OpenSooq API cover?
18 country sites, one per call: Jordan (jo), Saudi Arabia (sa), Kuwait (kw), Iraq (iq), Oman (om), Qatar (qa), Bahrain (bh), UAE (ae), Egypt (eg), Libya (ly), Lebanon (lb), Palestine (ps), Syria (sy), Yemen (ye), Sudan (sd), Morocco (ma), Algeria (dz) and Tunisia (tn). All 18 answered in both measurement runs on 2026-10-14, from about 720 listings in Tunisia to about 148,600 in Jordan.
Which currency are prices in?
price is the number the search card prints and currency is the currency printed next to it, for example JOD, SAR, AED or EGP. On Iraq, Lebanon, Libya, Palestine, Yemen and Sudan the card can show a converted figure: listing_currency tells you what the seller used, price_converted flags the difference, and the listing action returns the seller's own price and every price of the ad.
Do the filters really filter?
Each was compared with an unfiltered search in the same run. Jordan: iphone 5,127; in Amman 3,356; priced 100 to 500 JOD 2,690 (30 of 30 rows inside the range); with a price only 4,998. Mobile phones 8,613, Apple 4,644, Amman Al Gardens 219. Cars for sale 18,762, model year 2020 to 2022 2,300. One shop's listings 95. Saudi cars for sale 1,985, Toyota 366. A filter OpenSooq does not apply fails the call instead of returning the unfiltered list.
Are titles and descriptions translated?
No. They are the seller's own text, often Arabic. lang=en or lang=ar switches the labels OpenSooq adds itself (cities, categories, attribute names, relative dates).
Do I get the seller's phone number?
OpenSooq shows the number with its last two digits hidden and reveals it only to logged-in users. The API returns it exactly as OpenSooq publishes it, in phone_masked, together with the seller's id, name, shop name, rating and verification level.
How many results can one search return?
30 listings a page with OpenSooq's own total, last_page and has_more. Deep pages are served (page 1,000 of Jordan's whole site answered); a page past the last one returns no rows. Promoted ads are flagged and can fill the first pages of busy categories (90 of the first 90 Jordanian car ads were promoted).
How do I open one ad in full?
Take id and country from a search row and call listing, or pass the ad's opensooq.com URL. A deleted or expired ad, or an id asked on another country's site, returns NOT_FOUND.
How do I find category slugs and filter ids?
Call categories with a country, optionally a category and subcategory. It lists the categories and subcategories with slugs and counts, the cities with ids, the neighbourhoods of a city, and every filter key with its type, range and value ids. Car models appear once a make is given (79 Toyota models in Saudi Arabia).
What is the OpenSooq API?
OpenSooq API is a ReefAPI endpoint group for opensooq classifieds in 18 middle east and north africa countries as json: cars, property, phones and jobs with price, attributes, location and seller. It returns live JSON through POST requests under /opensooq/v1.
Is the OpenSooq API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. OpenSooq calls use the same shared credit balance as every other ReefAPI engine.
Do I need an OpenSooq login or account?
No login to OpenSooq 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 OpenSooq 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 OpenSooq API use?
OpenSooq actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call OpenSooq from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call opensooq actions with the same key, credit pool and JSON envelope used by normal REST requests.