🏠 Aqar Scraper — Saudi Arabia Property Data & API

Saudi sale and rental listings with prices, GPS, photos, REGA licenses and broker contacts

Collect structured public property listings from Aqar across Riyadh, Jeddah, Makkah, Madinah and other major Saudi cities. Export clean records with SAR prices, area, rooms, coordinates, descriptions, media, seller information and official REGA advertising-license details.

No browser setup, cookies or external API account is required.

---

✨ What you get

Data group	Included fields
💰 Pricing	SAR price, display price, rent period, price per m², declared price, installment value
🏘️ Property	Type, area, deed area, bedrooms, bathrooms, living rooms, age and floor
📍 Location	City and district in English and Arabic, address, direction and GPS coordinates
📞 Leads	Seller or agent name, public phone, brokerage and seller type
✅ REGA	License status, advertising-license number, verification URL and expiry
🖼️ Media	Main image, complete photo list, image count and videos
📝 Content	Full description, specifications, utilities and property features
📈 Activity	Views, favorites, promoted status, published and updated dates
🧾 Advanced	Deed, plan and parcel numbers plus optional original source data

Every row represents one unique Aqar property listing and is ready for JSON, CSV, Excel, XML, webhooks and API integrations.

In pay-per-event runs, every saved row triggers the automatic overview dataset event. Rows successfully enriched with includeDetails: true also trigger one detail-listing enrichment event. Failed detail requests remain overview records and are not charged as detail results.

---

🚀 Start in three steps

1. Select one or more Saudi cities.
2. Choose sale, rent or all listings and optionally select a property type.
3. Set the result limit and click Start.

The default input produces a ready Riyadh dataset with rich details and contact information.

Quick example

{
  "cities": ["riyadh", "jeddah"],
  "listingType": "sale",
  "propertyType": "villa",
  "maxResults": 200,
  "includeDetails": true
}

---

🎯 Use cases

📊 Saudi property market research

Compare asking prices, price per square meter, property supply and listing activity across cities and districts.

📞 Real estate lead generation

Build prospect lists from public seller, responsible employee and brokerage information. Filter or group records by city, property type, agency or REGA status.

💡 Competitive pricing

Benchmark villas, apartments, land and commercial properties with comparable area, rooms, district and listing type.

🏗️ Development opportunity discovery

Analyze land, buildings, farms and commercial inventory using area, frontage, street width, coordinates and planning fields.

✅ Compliance and license review

Collect official advertisement-license numbers, verification links, license expiry dates and declared prices for review workflows.

🔔 Listing monitoring

Schedule recurring runs and compare listing IDs, prices, update times and availability to identify new or changed inventory.

🗺️ Property mapping

Load latitude and longitude into GIS software, maps, BI tools or territory-planning applications.

🤖 PropTech and AI applications

Feed normalized Saudi property data into valuation models, search products, recommendation systems, CRMs and AI agents.

---

📥 Input

Field	Default	Description
cities	Riyadh	One or more supported Saudi cities
customCities	empty	Any Saudi city name in English or Arabic
cityIds	empty	Numeric Aqar city IDs, such as 21 for Riyadh
listingType	all	all, sale or rent
propertyType	all	Residential, commercial, house, chalet, rest house and camp categories
startUrls	empty	Custom Aqar search or individual listing URLs
listingIds	empty	Exact listing IDs for bulk detail collection
maxResults	200	Maximum unique properties; 0 means no result limit
maxPagesPerSearch	10	Search depth; approximately 20 listings per page
includeDetails	true	Full description, photos, contacts, licenses and activity
includeRawData	false	Complete original listing object for advanced users
minPrice / maxPrice	0	Optional SAR price range
minArea / maxArea	0	Optional area range in square meters
regaLicensedOnly	false	Keep only explicitly REGA-licensed listings
minBedrooms / minBathrooms	0	Optional minimum room counts
minLivingRooms	0	Optional minimum living-room count
furnished	any	All, furnished only or unfurnished only
sortBy / sortDirection	newest / descending	Sort by publish/update date, price, area, price per m² or views
maxConcurrency	10	Parallel detail requests
proxyConfiguration	off	Optional proxy for unusual access failures

Supported cities

• Riyadh
• Jeddah
• Makkah
• Madinah
• Dammam
• Al Khobar
• Taif
• Abha
• Tabuk
• Buraydah

Use customCities for any other city in English or Arabic, or cityIds when you already know Aqar's numeric city ID.

Supported property categories

• Apartments
• Villas
• Houses
• Land
• Floors
• Buildings
• Offices
• Stores
• Warehouses
• Farms
• Rooms
• Chalets
• Rest houses
• Camps

Keep All properties selected when maximum result volume is the priority.

---

📤 Output example

{
  "listingId": "6781382",
  "url": "https://sa.aqar.fm/en/flat-for-sale/riyadh/...-6781382",
  "propertyTitle": "Floor for Sale in Riyadh Badr",
  "listingType": "sale",
  "propertyType": "floor",
  "priceSar": 599000,
  "pricePerSqm": 3565.48,
  "areaSqm": 168,
  "bedrooms": 5,
  "bathrooms": 2,
  "city": "Riyadh",
  "cityArabic": "الرياض",
  "district": "Badr",
  "districtArabic": "حي بدر",
  "latitude": 24.501442,
  "longitude": 46.730402,
  "sellerName": "Public listing contact",
  "sellerPhone": "05XXXXXXXX",
  "agencyName": "Public brokerage name",
  "regaLicensed": true,
  "regaLicenseNumber": "7201047375",
  "images": ["https://images.aqar.fm/...jpg"],
  "features": ["Water", "Electricity", "Special Entrance"],
  "views": 1805,
  "publishedAt": "2026-07-19T18:21:19.000Z"
}

Fields appear when the source listing provides them. Private or hidden contact information is never inferred.

---

💼 Ready-made workflows

Collect rentals across three cities

{
  "cities": ["riyadh", "jeddah", "dammam"],
  "listingType": "rent",
  "propertyType": "apartment",
  "maxResults": 1000,
  "includeDetails": true
}

Find REGA-licensed villas for sale

{
  "cities": ["riyadh", "jeddah"],
  "listingType": "sale",
  "propertyType": "villa",
  "regaLicensedOnly": true,
  "minPrice": 1000000,
  "maxPrice": 5000000,
  "maxResults": 500
}

Fast market snapshot without details

{
  "cities": ["riyadh"],
  "listingType": "all",
  "propertyType": "all",
  "maxResults": 200,
  "includeDetails": false
}

Process individual listings

{
  "cities": [],
  "startUrls": [
    { "url": "https://sa.aqar.fm/en/villa-for-sale/riyadh/example-1234567" }
  ],
  "includeDetails": true,
  "maxResults": 10
}

Bulk details from listing IDs

{
  "listingIds": ["6651360", "6781382"],
  "includeDetails": true,
  "maxResults": 100
}

When listingIds is the only location source, the Actor skips city search automatically.

Filter and sort family homes

{
  "customCities": ["Jeddah"],
  "listingType": "rent",
  "propertyType": "house",
  "minBedrooms": 3,
  "minBathrooms": 2,
  "minLivingRooms": 1,
  "furnished": "any",
  "sortBy": "price",
  "sortDirection": "asc",
  "maxResults": 200
}

---

⚡ Speed and cost tips

• Leave concurrency at 10 for the best speed and reliability balance.
• Disable includeRawData unless you need every original field.
• Disable includeDetails for rapid price-and-location market snapshots.
• Keep rich details enabled when contact, description, license and complete media fields matter.
• Use maxResults to control dataset size and spending.
• Avoid enabling a proxy unless direct access starts returning errors.

The Actor uses lightweight HTTP extraction rather than a headless browser, keeping memory and compute costs low.

---

🔌 API usage

Start an Actor run

curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cities": ["riyadh"],
    "listingType": "all",
    "maxResults": 100,
    "includeDetails": true
  }'

Run synchronously and return the dataset

curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"cities":["jeddah"],"listingType":"rent","maxResults":50}'

Results can also be consumed through Python, JavaScript, MCP, Make, Zapier, webhooks and scheduled Apify runs.

---

❓ FAQ

Does it cover both sale and rent?

Yes. Select sale, rent or all listings in the input form.

Does it return contact information?

When publicly included in a listing, the Actor returns the seller, broker or responsible employee name, phone and agency.

Are REGA licenses included?

Yes. Rich-detail mode returns the license status, number, verification URL and expiry when published.

Can I scrape a district not listed in the city menu?

Yes. Open the desired filtered search on Aqar and paste its URL into startUrls.

Why is a field missing?

Aqar listings vary by property type and advertiser. The Actor returns fields that are present without inventing missing values.

Can I export to Excel?

Yes. Apify datasets can be downloaded as JSON, CSV, Excel, XML, RSS and JSONL.

Does it require an external API subscription?

No. It runs entirely inside your Apify account and does not require a separate paid data provider.

---

⚖️ Responsible use

Use the Actor only for lawful purposes and process contact and location data according to Saudi regulations, applicable privacy laws and Aqar's terms. Do not use the results for spam, harassment, discrimination or unauthorized republication.

You are responsible for your collection frequency, retention policy and downstream use of the exported data.

---

💬 Support

If a listing format changes or an expected public field is missing, open an Actor issue with the run ID and a reproducible public URL. Do not include private credentials or non-public personal data.

Choose your cities, click Start, and turn Saudi property listings into a structured dataset in minutes. 🚀