Aqar: Search
Search from Aqar as JSON. 1 credit per successful call.
GET /v1/aqar/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
listing_type | string | Optional | sale, rent |
property_type | string | Optional | apartment, villa, land, floor, building, shop, rest_house, farm, office, warehouse, room |
category_id | integer | Optional | Any |
city_id | integer | Optional | Any |
district_id | integer | Optional | Any |
min_price | integer | Optional | Any |
max_price | integer | Optional | Any |
min_area | integer | Optional | Any |
max_area | integer | Optional | Any |
min_beds | integer | Optional | Any |
min_baths | integer | Optional | Any |
min_living_rooms | integer | Optional | Any |
min_street_width | integer | Optional | Any |
max_age | integer | Optional | Any |
furnished | boolean | Optional | Any |
rent_period | string | Optional | monthly, yearly |
keyword | string | Optional | Up to 100 characters |
sort | string | Optional | price_asc, price_desc, area_asc, area_desc |
page | integer | Optional | Any |
size | integer | Optional | Any |
Example request
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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.