Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Aqar

1 credit per call4 endpoints20 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 keyRun 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 OKJSONX-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.

#idintegerurlurllisting_typestringproperty_typestringcategory_idintegerpriceobjectareaintegerbedroomsintegerbathroomsintegerliving_roomsintegerageintegercity_idintegerdistrict_idintegerlocationobjectdescriptionstringdescription_enstringimagesobject[]advertiserobjectcreated_atstringpublishedboolean
16558329https://sa.aqar.fm/ad/6558329saleapartment6{2 fields}182333021684{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:44Ztrue
26535415https://sa.aqar.fm/ad/6535415saleapartment6{2 fields}182331021684{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:29Ztrue
36539953https://sa.aqar.fm/ad/6539953saleapartment6{2 fields}182331021684{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:03Ztrue

Recorded from our API · 3 items shown · 20 datapoints per itemGET /v1/aqar/search?listing_type=sale&property_type=apartment&city_id=21&max_price=900000&min_beds=3&sort=price_asc

20 datapoints

Identity

  • idinteger
  • listing_typestring
  • property_typestring
  • category_idinteger

Contact

  • urlurl

Location

  • areainteger
  • city_idinteger
  • district_idinteger
  • locationobject

Reputation

  • imagesobject[]

Price

  • priceobject

Other

  • bedroomsinteger
  • bathroomsinteger
  • living_roomsinteger
  • ageinteger
  • descriptionstring
  • description_enstring
  • advertiserobject
  • created_atstring
  • publishedboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/aqar/agent
user_id+2 optional
1 credit
GET/v1/aqar/autocomplete
query+3 optional
1 credit
GET/v1/aqar/listing
none+2 optional
1 credit
GET/v1/aqar/search
none+20 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarmapArgenpropathomeBatdongsan.com.vn

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 keyRead the docs