--- title: "Aqar API: JSON data, 4 endpoints, 1 credit per call" description: "Aqar API for Saudi apartments, villas, land and shops for sale or rent, listing details, advertisers and autocomplete as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/aqar --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Aqar 1 credit per call 4 endpoints 20 datapoints # Aqar API Aqar API for Saudi apartments, villas, land and shops for sale or rent, listing details, advertisers and autocomplete as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Aqar GET /v1/aqar/search?listing\_type=sale&property\_type=apartment&city\_id=21&max\_price=900000&min\_beds=3&sort=price\_asc ``` { "success": true, "data": { "applied_filters": { "listing_type": "sale", "property_type": "apartment", "category_id": 6, "city_id": "21", "sort": "price_asc", "max_price": "900000", "min_beds": "3" }, "pagination": { "page": 1, "size": 20, "from": 0, "total": 4954, "total_pages": 248, "has_next_page": true }, "items": [ { "id": 6558329, "url": "https://sa.aqar.fm/ad/6558329", "listing_type": "sale", "property_type": "apartment", "category_id": 6, "price": { "value": 380, "currency": "SAR" }, "area": 182, "bedrooms": 3, "bathrooms": 3, "living_rooms": 3, "age": 0, "city_id": 21, "district_id": 684, "location": { "latitude": 24.560798, "longitude": 46.820766 }, "description": "متوفر لدينا عروض بجميع المساحات والتصماميم. \nللبيع شقق تمليك فاخره بالرياض من المالك مباشره ، \nتشطيب راقي واشراف هندسي يوجد جميع الضمانات ،يوجد تأمين ضد العيوب الخفيه ،بنيه تحتية متكاملة:\n\nبدون سعي.. \n\n ندفع الدفعه الاولى والرسوم الادارية…", "description_en": "we have offers available in all sizes and designs.\nfor sale: luxury freehold apartments in riyadh directly from the owner,\nhigh-end finishes with engineering supervision, all warranties available, insurance against hidden defects, complete …", "images": [ { "small": "https://images.aqar.fm/webp/350x0/props/006310568_1769109292405.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310568_1769109292405.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310568_1769109292405.jpg" }, { "small": "https://images.aqar.fm/webp/350x0/props/006310560_1769109292460.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310560_1769109292460.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310560_1769109292460.jpg" }, { "small": "https://images.aqar.fm/webp/350x0/props/006310566_1769109292467.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310566_1769109292467.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310566_1769109292467.jpg" } ], "advertiser": { "id": 631056, "name": "زايد مسعود", "rating": 5, "paid_member": true }, "created_at": "2026-01-22T19:19:44Z", "published": true }, { "id": 6535415, "url": "https://sa.aqar.fm/ad/6535415", "listing_type": "sale", "property_type": "apartment", "category_id": 6, "price": { "value": 380, "currency": "SAR" }, "area": 182, "bedrooms": 3, "bathrooms": 3, "living_rooms": 1, "age": 0, "city_id": 21, "district_id": 684, "location": { "latitude": 24.560798, "longitude": 46.820766 }, "description": "متوفر لدينا عروض بجميع المساحات والتصماميم. \nللبيع شقة تمليك فاخره بالرياض من المالك مباشره ، \nتشطيب راقي واشراف هندسي يوجد جميع الضمانات ،يوجد تأمين ضد العيوب الخفيه ،بنيه تحتية متكاملة:\n\nبدون سعي.. \n ندفع الدفعه الاولى والرسوم الادارية…", "description_en": "we have offers in all sizes and designs.\nfor sale: a luxurious freehold apartment in riyadh, directly from the owner.\nhigh-end finishing with engineering supervision, all warranties available, insurance against hidden defects, and fully int…", "images": [ { "small": "https://images.aqar.fm/webp/350x0/props/006310563_1767647264331.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310563_1767647264331.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310563_1767647264331.jpg" }, { "small": "https://images.aqar.fm/webp/350x0/props/006310561_1767647264337.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310561_1767647264337.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310561_1767647264337.jpg" }, { "small": "https://images.aqar.fm/webp/350x0/props/006310569_1767647264328.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310569_1767647264328.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310569_1767647264328.jpg" } ], "advertiser": { "id": 631056, "name": "زايد مسعود", "rating": 5, "paid_member": true }, "created_at": "2026-01-05T21:21:29Z", "published": true }, { "id": 6539953, "url": "https://sa.aqar.fm/ad/6539953", "listing_type": "sale", "property_type": "apartment", "category_id": 6, "price": { "value": 380, "currency": "SAR" }, "area": 182, "bedrooms": 3, "bathrooms": 3, "living_rooms": 1, "age": 0, "city_id": 21, "district_id": 684, "location": { "latitude": 24.560798, "longitude": 46.820766 }, "description": "متوفر لدينا عروض بجميع المساحات والتصماميم. \nللبيع شقة تمليك فاخره بالرياض من المالك مباشره ، \nتشطيب راقي واشراف هندسي يوجد جميع الضمانات ،يوجد تأمين ضد العيوب الخفيه ،بنيه تحتية متكاملة:\n\nبدون سعي.. \n ندفع الدفعه الاولى والرسوم الادارية…", "description_en": "we have offers available in all sizes and designs.\nfor sale: a luxury freehold apartment in riyadh, directly from the owner.\nhigh-end finishing with engineering supervision, all warranties included, insurance against hidden defects, and ful…", "images": [ { "small": "https://images.aqar.fm/webp/350x0/props/006310569_1767981352991.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310569_1767981352991.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310569_1767981352991.jpg" }, { "small": "https://images.aqar.fm/webp/350x0/props/006310565_1767981353716.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310565_1767981353716.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310565_1767981353716.jpg" }, { "small": "https://images.aqar.fm/webp/350x0/props/006310564_1767981353664.jpg", "medium": "https://images.aqar.fm/webp/750x0/props/006310564_1767981353664.jpg", "large": "https://images.aqar.fm/webp/1200x0/props/006310564_1767981353664.jpg" } ], "advertiser": { "id": 631056, "name": "زايد مسعود", "rating": 5, "paid_member": true }, "created_at": "2026-01-09T18:03:03Z", "published": true } ] }, "meta": { "endpoint_family": "search", "request_id": "req_e4f23fb84f7948259f82586119689001", "credits_charged": 1, "credits_remaining": 1894 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | url url | listing\_type string | property\_type string | category\_id integer | price object | area integer | bedrooms integer | bathrooms integer | living\_rooms integer | age integer | city\_id integer | district\_id integer | location object | description string | description\_en string | images object\[\] | advertiser object | created\_at string | published boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 6558329 | https://sa.aqar.fm/ad/6558329 | sale | apartment | 6 | {2 fields} | 182 | 3 | 3 | 3 | 0 | 21 | 684 | {2 fields} | متوفر لدينا عروض بجميع المساحات والتصماميم. للبيع شقق تمليك فاخره بالرياض من المالك مباشره ، تشطيب راقي واشراف هندسي يوجد جميع الضمانات ،يوجد تأمين ضد العيوب الخفيه ،بنيه تحتية متكاملة: بدون سعي.. ندفع الدفعه الاولى والرسوم الادارية… | we have offers available in all sizes and designs. for sale: luxury freehold apartments in riyadh directly from the owner, high-end finishes with engineering supervision, all warranties available, insurance against hidden defects, complete … | \[3 items\] | {4 fields} | 2026-01-22T19:19:44Z | true | | 2 | 6535415 | https://sa.aqar.fm/ad/6535415 | sale | apartment | 6 | {2 fields} | 182 | 3 | 3 | 1 | 0 | 21 | 684 | {2 fields} | متوفر لدينا عروض بجميع المساحات والتصماميم. للبيع شقة تمليك فاخره بالرياض من المالك مباشره ، تشطيب راقي واشراف هندسي يوجد جميع الضمانات ،يوجد تأمين ضد العيوب الخفيه ،بنيه تحتية متكاملة: بدون سعي.. ندفع الدفعه الاولى والرسوم الادارية… | we have offers in all sizes and designs. for sale: a luxurious freehold apartment in riyadh, directly from the owner. high-end finishing with engineering supervision, all warranties available, insurance against hidden defects, and fully int… | \[3 items\] | {4 fields} | 2026-01-05T21:21:29Z | true | | 3 | 6539953 | https://sa.aqar.fm/ad/6539953 | sale | apartment | 6 | {2 fields} | 182 | 3 | 3 | 1 | 0 | 21 | 684 | {2 fields} | متوفر لدينا عروض بجميع المساحات والتصماميم. للبيع شقة تمليك فاخره بالرياض من المالك مباشره ، تشطيب راقي واشراف هندسي يوجد جميع الضمانات ،يوجد تأمين ضد العيوب الخفيه ،بنيه تحتية متكاملة: بدون سعي.. ندفع الدفعه الاولى والرسوم الادارية… | we have offers available in all sizes and designs. for sale: a luxury freehold apartment in riyadh, directly from the owner. high-end finishing with engineering supervision, all warranties included, insurance against hidden defects, and ful… | \[3 items\] | {4 fields} | 2026-01-09T18:03:03Z | true | Recorded from our API · 3 items shown · 20 datapoints per item GET /v1/aqar/search?listing\_type=sale&property\_type=apartment&city\_id=21&max\_price=900000&min\_beds=3&sort=price\_asc 20 datapoints ### Identity - id integer - listing\_type string - property\_type string - category\_id integer ### Contact - url url ### Location - area integer - city\_id integer - district\_id integer - location object ### Reputation - images object\[\] ### Price - price object ### Other - bedrooms integer - bathrooms integer - living\_rooms integer - age integer - description string - description\_en string - advertiser object - created\_at string - published boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/aqar/search?listing_type=sale&property_type=apartment&city_id=21&max_price=900000&min_beds=3&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` Aqar · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/aqar/agent`](https://perceptlayer.com/apis/aqar/agent) | `user_id` +2 optional | 1 credit | | [GET `/v1/aqar/autocomplete`](https://perceptlayer.com/apis/aqar/autocomplete) | `query` +3 optional | 1 credit | | [GET `/v1/aqar/listing`](https://perceptlayer.com/apis/aqar/listing) | none +2 optional | 1 credit | | [GET `/v1/aqar/search`](https://perceptlayer.com/apis/aqar/search) | none +20 optional | 1 credit | Overview ## About the Aqar API ## What you can get The Aqar API returns Aqar property data for Saudi Arabia as JSON through 4 endpoints. - **Search:** `search` takes a `listing_type` (sale or rent) and a `property_type` (apartment, villa, land, floor, building, shop, rest\_house, farm, office, warehouse or room) or `category_id`, with `city_id`, `district_id`, `min_price`, `max_price`, `min_area`, `max_area`, `min_beds`, `min_baths`, `min_living_rooms`, `min_street_width`, `max_age`, `furnished`, `rent_period` (monthly or yearly), `keyword`, `sort` (price\_asc, price\_desc, area\_asc or area\_desc), `page` and `size`. - **Listings:** `listing` takes an `id` or a `url`. - **Agents:** `agent` takes a `user_id`, with `page` and `size`. - **Autocomplete:** `autocomplete` takes a `query`, with `city_id`, `category_id` and `limit`. The recorded `search` ( `listing_type=sale`, `property_type=apartment`, `city_id=21`, `max_price=900000`, `min_beds=3`, `sort=price_asc`) returns `items`, each with `id`, `url`, `listing_type`, `property_type`, `category_id`, `price` ( `value`, `currency`), `area`, `bedrooms`, `bathrooms`, `living_rooms`, `age`, `city_id`, `district_id`, `location`, `description`, `description_en`, `images`, `advertiser` and `created_at`. It also returns `pagination` with `total` (4,954), `total_pages` and `has_next_page`, and the `applied_filters`. ## How a call works Search apartments for sale: `GET /v1/aqar/search?listing_type=sale&property_type=apartment&city_id=21&max_price=900000&min_beds=3&sort=price_asc` with your key in the `X-API-Key` header. Page with `page` and `size`. Each item's `id` goes to `listing`, and its `city_id` and `district_id` go back into `search` to narrow to one district. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) [Batdongsan.com.vn](https://perceptlayer.com/apis/batdongsan) Use cases ### Track apartment and villa asking prices in Saudi riyals by city and district `Use the Aqar API to track apartment and villa asking prices in Saudi riyals by city and district` ### Compare monthly and yearly rents with \`rent\_period\` `` Use the Aqar API to compare monthly and yearly rents with `rent_period` `` ### Screen land by area and \`min\_street\_width\` `` Use the Aqar API to screen land by area and `min_street_width` `` ### Pull listing descriptions in Arabic, with \`description\_en\` where it is given `` Use the Aqar API to pull listing descriptions in Arabic, with `description_en` where it is given `` FAQ ## Questions **Do I need an Aqar account?** No. You call this Aqar API with your Perceptlayer key in the \`X-API-Key\` header, with no Aqar login. **How much does the Aqar API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Can I search in Arabic?** Yes. \`autocomplete\` takes an Arabic \`query\`; the catalogue example is الر. **Should I build an Aqar scraper instead?** You can, but an Aqar scraper is code you maintain: page changes break it, requests get blocked, and Aqar's terms govern how you collect data. The Aqar API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Aqar API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)