Search every Qatar Living marketplace at once, then read any advert in full
Qatar Living is where Qatar buys, rents, hires and goes out, and this API reads all of it as JSON.
8 active endpoints, on 1 and 2 credit tiers.
- POST/qatarliving/v1/search
- POST/qatarliving/v1/listing
- POST/qatarliving/v1/similar
- POST/qatarliving/v1/suggest
- POST/qatarliving/v1/popular_keywords
- POST/qatarliving/v1/facets
- POST/qatarliving/v1/deals_map
- +1 more
What Qatar Living endpoints does ReefAPI ship?
8 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Qatar Living API
8 of 8 endpoints, ready to run
Search or browse any Qatar Living index
// 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 Qatar Living API works
Qatar Living 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 438 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 word to a priced, filtered Qatari market feed
Find out which index the word belongs to, read that index's vocabulary, browse it with real filters for an exact count, then follow any id for the full bilingual advert.
The answer carries vertical_counts for all eight indexes, so you can see the query belongs to vehicles before you commit to it.
The live vocabulary with bucket sizes - Toyota 1,108, Land Cruiser 480, SUV/4x4 4,154, Petrol 4,634 on 2026-10-06. These are the exact strings the filters accept.
A filtered browse returns an exact total (not a relevance estimate) plus rows with price, year, mileage, gearbox, body type, colour and the canonical URL.
The complete advert: full description, every image, the whole attribute set and the Arabic counterpart of each field.
A dated, priced feed of Qatari adverts in QAR with structured vehicle, property and item attributes, English and Arabic text, working canonical URLs and counts you can actually trust.
curl -X POST https://api.reefapi.com/qatarliving/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"land cruiser","vertical":"vehicles","limit":10}'{
"ok": true,
"data": { … },
"meta": {
"api": "qatarliving",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What a Qatar Living field actually contains
Six fields where the obvious reading is the wrong one. Every row was measured against live Qatar Living responses on 2026-10-06.
| Field | What it holds |
|---|---|
| total_matched vs total_reported | total_matched is the number to trust. On deals, news and events a free-text search returns a relevance pool rather than a match count - the deals index answered 500 for every query we tried, including a nonsense string, while a filtered browse of the same index reports 738. When that happens total_is_relevance_pool is true and total_matched falls back to the honest count the source publishes separately (news 'world cup': 1,001 reported, 50 matched). A filter-only browse always carries an exact count. |
| irrelevant_query | True means Qatar Living's own relevance gate refused the query for that vertical, not that nothing matched. Searching camry in the properties index returns zero with this flag set; the same word in vehicles returns real cars. The flag plus the vertical counts in the same response tell you where the query belongs. |
| sub_vertical | The section slug: items, stores, offers, pre-loved, collectibles on classifieds; residential, commercial, agencies, international, schools on property. Pass the slug and the count moves (classifieds 36,670 to 3,061 for stores). Every response also reports all section counts whether you filtered or not. |
| price | A number in QAR, or null. Null means no price was published - normal on ask-for-price services and deals, where 6 of 10 and 5 of 10 sampled rows carried one. A price is never reported as 0, so 'no price' and 'free' stay distinct. |
| title_ar / description_ar | Only on the listing endpoint, and that is where the whole Arabic side lives - up to 17 translated fields per vertical including make_ar, fuel_type_ar, purpose_ar, furnishing_status_ar and offer_type_ar. A search row answers in ONE language: ask for Arabic and the Arabic text arrives in the ordinary title and category fields. |
| images | Classifieds, services, news and events publish full image URLs. Deals, properties and vehicles publish storage-relative paths, and the response says which form you got in image_paths. We do not fabricate an absolute URL for the relative ones - the listing url field always works instead. |
Deliberate gaps, measured: the jobs index is accepted and documented by Qatar Living but currently holds zero documents, and the API says so in a warning rather than pretending. There is no public 'all adverts by one seller' endpoint. Vehicles and deals rows carry no coordinates. Page size is capped at 100 because the source returns 100 even when 200 is requested, and paging past the last page returns zero rows rather than repeating it.
Qatar coverage, measured
Every number below was read from live Qatar Living responses on 2026-10-06; two consecutive runs of 48 calls agreed.
Qatar only, prices in QAR. Eight indexes: classifieds, properties, vehicles, services, deals, news, events and jobs.
Classifieds 36,670 rows (items 31,381, stores 3,061, offers 2,063, pre-loved 85, collectibles 76); properties 29,678 (residential 25,509, commercial 3,860, agencies 216, international 61, schools 33); vehicles 7,340; news 2,318; services 969; deals 738; events 635; jobs 0 - the source's jobs index is empty.
Classifieds: electronics 9,129, furniture and decor 8,942, kids and toys 2,947, phones and tablets 2,927, sports and hobbies 2,593; Apple 1,550 and Samsung 536 by brand. Vehicles: Toyota 1,108, Nissan 581, Mercedes 367; SUV/4x4 4,154, saloon 1,131; automatic 5,234, manual 248. Properties: apartment 19,503, villa 3,266, warehouse 1,302, office 1,270; 23,644 to rent against 5,785 for sale. Deals: 350 discounts, 295 buy-one-get-one, 77 bundles, 16 vouchers.
108 named filters, verified biting against an unfiltered control: vehicles 7,340 unfiltered, 1,163 with make=Toyota, 606 condition=New, 3,389 from 2022, 2,113 under 50,000 km, 1,890 under QAR 30,000; properties 6,713 with 3+ bedrooms, 6,997 over 200 sqm, 3,266 villas; classifieds 8,938 over QAR 1,000, 6,299 in Doha, 264 freebies.
Across 120 sampled rows: id, url, title, image, category and slug 120/120; description 100/100 on the marketplace verticals (news and events publish body and event_details instead); price 30/30 vehicles, 30/30 classifieds, 20/20 properties, 6/10 services, 5/10 deals; coordinates 20-30/30 classifieds, 20/20 properties, 9/10 events, none on vehicles or deals.
Search to detail round-trips on the same id and the same title, 12/12, with identical prices. 25 generated canonical URLs were fetched on the live website: 25 returned HTTP 200.
A filtered browse is exact. A free-text search on deals, news or events returns a relevance pool instead, and the response marks it with total_is_relevance_pool and gives the honest number in total_matched where the source publishes one. Page size caps at 100; paging past the end returns zero rows rather than repeating the last page.
No 'all adverts by one seller' endpoint, no coordinates on vehicles or deals rows, no absolute image URL on deals, properties and vehicles (the source publishes storage-relative paths there and the response says so), and an empty jobs index. Seller name, phone and WhatsApp are withheld unless you ask for personal data.
What people build with Qatar Living
The jobs this data is most often used for.
endpoints
credits per call
Track the Qatari used-car market daily: browse vehicles filtered by make and year, keeping id, price, mileage, gearbox, body type and the canonical URL, then follow any id for the full bilingual advert.
Build a Doha rental index by browsing properties with purpose=Rent and bedroom counts, grouping QAR prices by zone and reading area_sqm, furnishing and amenities straight off each row.
Size a category before you scrape it: one facets call returns every bucket and its live count, so you know there are 9,129 electronics and 2,927 phone listings before paging a single result.
Watch Qatar's demand signal week by week with popular_keywords per vertical, then size each term with the count a real search returns for it.
What Qatar Living 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 438 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/qatarliving/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"land cruiser","vertical":"vehicles","limit":10}'import requests
r = requests.post(
"https://api.reefapi.com/qatarliving/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "land cruiser",
"vertical": "vehicles",
"limit": 10
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Qatar Living.
Get a free key →Do I need an account, a key or a Qatari IP for the Qatar Living API?▾
No. Every endpoint is read without an account, a login or a cookie, and access is handled for you - you call reefapi.com from anywhere.
Which Qatar Living index should I query?▾
You do not have to decide first. Every answer carries vertical_counts for all eight indexes, so a single call tells you that `camry` has 39 hits in vehicles and none in classifieds. The eight are classifieds (36,670 live rows on 2026-10-06), properties (29,678), vehicles (7,340), news (2,318), services (969), deals (738), events (635) and jobs (0 - see below).
Why does the jobs vertical return nothing?▾
Because Qatar Living's jobs search index is empty. The vertical is accepted and listed by the source and the site has a jobs section, but the index behind search held zero documents on 2026-10-06 - on a plain browse and on real queries like `driver`. The API returns a successful response with zero rows and a warning saying so, rather than an error or a padded page.
Can I trust the result count?▾
On classifieds, properties, vehicles and services, yes - and a filter-only browse is exact (vehicles unfiltered 7,340, make=Toyota 1,163, condition=New 606, year from 2022 3,389). On deals, news and events a free-text total is a relevance pool, so the response sets total_is_relevance_pool and gives you the honest number in total_matched where the source publishes one. We publish the distinction instead of hiding it.
How do I find the right filter values?▾
Call facets. It returns the live vocabulary and the bucket size for whatever fields you name - vehicle makes and models, property types and purposes, classifieds categories, brands, conditions, colours and districts, deal categories and merchants. Add filters to it and the counts become conditional, so you can ask how many models Nissan has in stock (27 on 2026-10-06) before you page anything.
Does Arabic search work?▾
Yes, in both directions. Arabic queries return Arabic listings (the Arabic spelling of Nissan returned 471 vehicles, a fridge query 490 classifieds), and setting the language to Arabic returns the Arabic side of every title, category and attribute. The listing endpoint returns both languages at once.
Can I get the seller's phone number?▾
Qatar Living publishes a phone and WhatsApp number on every classifieds advert, and the API returns them when you explicitly ask for personal data. By default the seller's name and numbers are withheld and the row says pii_withheld: true, so nothing personal reaches your logs by accident. Business identity - company name, agency name, verified and showroom flags - is always returned.
What is the map endpoint for?▾
deals_map and merchants_map return the entire matching set as coordinates in one call, with no paging - one pin per branch, so a merchant with four branches becomes four pins. A single unfiltered call returned 1,242 offer pins and 386 merchant pins, which would otherwise be dozens of paged requests.
What is the Qatar Living API?▾
Qatar Living API is a ReefAPI endpoint group for qatar's biggest marketplace in one api: 36,670 classifieds, 29,678 properties, 7,340 vehicles, 969 services, 738 deals, news and events. It returns live JSON through POST requests under /qatarliving/v1.
Is the Qatar Living API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Qatar Living calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Qatar Living login or account?▾
No login to Qatar Living 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 Qatar Living 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 Qatar Living API use?▾
Qatar Living actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Qatar Living from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call qatarliving actions with the same key, credit pool and JSON envelope used by normal REST requests.
99 Classifieds & Second-hand APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Qatar Living, 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 437 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-06.