Mubawab Scraper – Morocco & Tunisia Property Data 🚀

🎉 31 complete listings per page — Morocco AND Tunisia from one actor

Built for Maghreb market analysts, estate agencies and relocation portals working mubawab.ma and mubawab.tn

---

🔎 What is the Mubawab Scraper — and when should you use it?

The Mubawab Scraper turns mubawab.ma and mubawab.tn property adverts from any Moroccan or Tunisian city into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

Use it when you need: Maghreb property adverts as rows: asking price or monthly rent with its currency, MAD in Morocco and TND in Tunisia. Each row also carries the price exactly as the portal prints it, surface in m2, bedroom and bathroom counts, neighbourhood and city, amenities, photos and the advert excerpt. The advert id is Mubawab's own and is stable, so scheduled runs deduplicate cleanly. Switch to Listing Detail and a row gains real GPS coordinates from the advert's own map, the numeric price from the portal's structured data, total room count, the agency behind the advert and its attribute sheet. Apartments are one section of seven: villas, houses, riads, land, shops and offices are inputs too, across sale, long rent and holiday let.

Use something else when: the property is not on Mubawab, or you need a different market. Use Bayut Scraper for the UAE - Dubai, Abu Dhabi and Sharjah - a Gulf portal with its own inventory and no overlap with the Maghreb. Use Encuentra24 Scraper for Central American property across seven countries, on the same row shape. This actor covers the public French edition of mubawab.ma and mubawab.tn - every section the portal publishes, nationwide, with no depth ceiling. It does not cover mubawab.dz, which has no DNS records at all and is not a live site whatever a rival's title claims; the portal's Arabic edition, which uses a different URL grammar; advertiser phone numbers, which Mubawab reveals only through a lead form; or any other Moroccan or Tunisian portal, so a property also advertised on Avito will not be flagged as a cross-post.

🤖 Use with AI agents

Already connected to the Apify MCP server? Just ask for this Actor by name: sian.agency/mubawab-property-scraper

Your agent can pay for its own runs. This Actor is eligible for agentic payments, so an agent can discover it, run it and settle the bill over x402 (USDC on Base) or Skyfire — without an Apify account or API token of its own. Billing is the same either way: per successful row, never for errors.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

I want property adverts from Mubawab, the leading portal in Morocco and Tunisia using the Apify Actor `sian.agency/mubawab-property-scraper`.

Use it when I need: Maghreb property adverts as rows: asking price or monthly rent with its currency, MAD in Morocco and TND in Tunisia. Each row also carries the price exactly as the portal prints it, surface in m2, bedroom and bathroom counts, neighbourhood and city, amenities, photos and the advert excerpt. The advert id is Mubawab's own and is stable, so scheduled runs deduplicate cleanly. Switch to Listing Detail and a row gains real GPS coordinates from the advert's own map, the numeric price from the portal's structured data, total room count, the agency behind the advert and its attribute sheet. Apartments are one section of seven: villas, houses, riads, land, shops and offices are inputs too, across sale, long rent and holiday let.

Don't use it when: the property is not on Mubawab, or you need a different market — use bayut-property-scraper or encuentra24-property-scraper instead.

How to call it: set `market` to `ma` or `tn`, then pick `propertyType` (apartment, villa, house, riad, land, shop, office) and `transaction` (sale, rent, vacation). Add `city` written the way Mubawab writes it, accents included (`casablanca`, `marrakech`, `fès`, `salé`, `tunis`), or leave it empty to sweep the whole country. `minPrice`, `maxPrice`, `minRooms` and `minAreaSqm` narrow the results before you are billed. For coordinates, the agency and the full advert text, switch `operation` to `detail` and pass advert URLs in `listingUrls` as {url} objects.

Start with this input:
{
  "operation": "search",
  "market": "ma",
  "propertyType": "apartment",
  "transaction": "sale",
  "city": "casablanca",
  "minPrice": 1000000,
  "maxPrice": 3000000,
  "maxResults": 100
}

Ask me which country and cities to cover, which section they want (apartments, villas, riads, land, shops or offices, and sale or rent), and whether the coordinates, agency and full advert text are worth switching to Listing Detail, then run the Actor and summarise the results as a table.

Things you can ask your agent for:

• Pull every apartment for sale in Casablanca between 1,000,000 and 3,000,000 MAD and give me the median price per m2 by neighbourhood
• Find riads for sale in Marrakech over 200 m2, then open each one to get its coordinates and the agency behind it
• Compare the Tunis and Casablanca rental markets: run both, and summarise median monthly rent and surface by city

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at apify.com/sian.agency/mubawab-property-scraper.md.

📋 Overview

Mubawab is the property portal people in Morocco and Tunisia actually use. Around 79,000 live adverts across the two countries, and 40,500 brand searches a month in Morocco alone. This actor turns those adverts into rows.

What you get:

• ✅ Two countries, one input: mubawab.ma and mubawab.tn run on the same application and share one listing-id space. Flip market and the same parser reads Tunisia.
• ⚡ 31 listings per page fetch: the portal renders its result pages server-side, so one request already contains 31 complete records. Nothing to wait on.
• 🎯 Seven sections, apartments included: riads, land, shops and offices are inputs in their own right. Morocco alone carries 6,994 land adverts, and Tunisia another 3,510 — inventory most portal scrapers never touch.
• 💰 Filters that bill honestly: price, bedroom and surface bounds are applied before the charge, so a listing you ruled out never reaches your invoice.
• 💎 A detail record no rival carries: exact GPS coordinates, the numeric price from the portal's own structured data, the agency behind the advert, the attribute sheet and the full advert text.
• ✨ Stable listing ids: schedule the run and the rows deduplicate cleanly across days.

---

✨ Features

• 🔍 Listing Search: walk any Mubawab section, country-wide or narrowed to a city, and get one complete row per advert.
• 📄 Listing Detail: open the adverts you name and add coordinates, agency, attribute sheet and complete text.
• 🌍 Morocco and Tunisia: MAD and TND, both parsed and labelled, from one market switch.
• 🏠 Seven property types: apartment, villa, house, riad, land, shop and office, across sale, long rent and holiday let.
• 📍 Real coordinates: latitude and longitude read from the portal's own map fields, so rows drop straight onto a map with no geocoding pass.
• 🎚️ Price, bedroom and surface filters: applied before billing, never after.
• 🖼️ Full photo sets: every image on the advert, with a count.
• 🧾 Honest empty prices: "Prix à consulter" stays a label. price stays null rather than becoming a zero that poisons your averages.
• 📊 The portal's own match count: every row carries how many listings Mubawab says match that search.
• 🔁 Promoted-advert dedup: Mubawab pins its promoted adverts to every page; repeats are dropped before you are charged.

---

🎬 Quick Start

Pick a market, a property type and a transaction. Add a city if you want one. Press Start.

curl -X POST "https://api.apify.com/v2/acts/sian.agency~mubawab-property-scraper/runs?token=YOUR_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"operation":"search","market":"ma","propertyType":"apartment","transaction":"sale","city":"casablanca","maxResults":100}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose the market and the section

Morocco or Tunisia, then the property type and whether you want sale, long rent or holiday let.

Step 2: Narrow it, or don't

Name a city the way Mubawab writes it — casablanca, marrakech, fès, tunis — or leave it empty to sweep the whole country. Add price, bedroom or surface bounds if you have them.

Step 3: Run it

Set maxResults to cap your own spend and start the run.

That's it. In under a minute you'll have:

• One row per advert with price, surface, rooms, neighbourhood and photos
• A JSON or CSV export ready for a sheet, a database or an agent
• A run report showing exactly what you were charged for

---

📥 Input Configuration

Field	Type	Required	Description
operation	string	No	search (default) or detail
market	string	No	ma for Morocco, tn for Tunisia
propertyType	string	No	apartment, villa, house, riad, land, shop, office
transaction	string	No	sale, rent or vacation
city	string	No	A city as Mubawab writes it, accents kept. Empty searches nationwide
minPrice	integer	No	Keep listings at or above this price, in MAD or TND
maxPrice	integer	No	Keep listings at or below this price
minRooms	integer	No	Keep listings with at least this many bedrooms
minAreaSqm	integer	No	Keep listings of at least this surface in m²
maxResults	integer	No	Stop after this many rows (default 100)
listingUrls	array	No	For detail: listing URLs as {"url": "…"} objects

Search example:

{
  "operation": "search",
  "market": "ma",
  "propertyType": "villa",
  "transaction": "sale",
  "city": "marrakech",
  "minPrice": 2000000,
  "maxResults": 200
}

Detail example:

{
  "operation": "detail",
  "listingUrls": [
    { "url": "https://www.mubawab.ma/fr/a/8115280/appartement-neuf-83-m2-a-gueliz" },
    { "url": "https://www.mubawab.tn/fr/a/8308831/appartement-a-vendre-la-marsa" }
  ]
}

Riads are sale-only and a Moroccan format. Holiday lets exist for apartments and villas. Ask for a pairing Mubawab has no section for and the run says so, listing the pairings that section supports, rather than quietly returning a different one.

---

📤 Output

Every row is flat JSON. Export as JSON, CSV or Excel, or read it straight from the API.

Field	Type	Description
listingId	string	Mubawab's own advert id — stable, and what dedup keys on
url	string	The advert's page
market / country	string	ma/tn and Morocco/Tunisia
transaction	string	sale, rent or vacation
propertyType	string	The section, or the portal's own label on a detail row
titleText	string	The advert headline
price	integer	The number, or null when the advert withholds it
currency	string	MAD or TND
priceLabel	string	Exactly as Mubawab prints it, including "Prix à consulter"
pricePerSqm	integer	Derived, and null unless both price and surface are real
areaSqm	integer	Surface in m²
bedrooms / bathrooms / rooms	integer	Counts as advertised
neighbourhood / city	string	Where the property is
latitude / longitude	number	Detail rows: the advert's own map position
agencyName	string	Detail rows: the agency behind the advert
amenities	array	Pool, lift, garage, air conditioning, fitted kitchen…
attributes	object	Detail rows: condition, building age, floor, flooring
descriptionText	string	The advert text
isPromoted	boolean	Whether Mubawab pinned this advert to the top
imageUrl / imageUrls / photoCount	string / array / integer	The full photo set
searchUrl / searchResultCount	string / integer	The page it came from and how many matches Mubawab reports
scrapedAt	string	ISO timestamp of the read

Example row:

{
  "operation": "detail",
  "listingId": "8115280",
  "url": "https://www.mubawab.ma/fr/a/8115280/appartement-neuf-83-m2-a-gueliz",
  "market": "ma",
  "country": "Morocco",
  "propertyType": "Appartement",
  "titleText": "Appartement Neuf 83 m² à Guéliz avec Salle de Sport",
  "price": 1560000,
  "currency": "MAD",
  "priceLabel": "1 560 000 DH",
  "pricePerSqm": 18795,
  "areaSqm": 83,
  "rooms": 3,
  "bedrooms": 2,
  "bathrooms": 1,
  "neighbourhood": "Guéliz",
  "city": "Marrakech",
  "latitude": 31.64594579908345,
  "longitude": -8.011576162757956,
  "agencyName": "Group JNANE NIZAR",
  "amenities": ["Terrasse", "Garage", "Ascenseur", "Piscine", "Climatisation"],
  "attributes": { "Type de bien": "Appartement", "Etat": "Bon état / habitable", "Étage du bien": "1er" },
  "photoCount": 29,
  "scrapedAt": "2026-09-10T02:43:46.744Z"
}

---

🗺️ Coverage

Measured live on 2026-09-10.

Morocco (mubawab.ma) — 57,600 live adverts. Apartments for sale 15,126 · apartments to rent 14,628 · land 6,994 · villas and luxury houses for sale 6,205 · shops and units 4,458 · offices and commercial 3,665 · villas to rent 2,861 · houses 2,201 · riads 1,149 · holiday apartments 967 · holiday villas 149.

Tunisia (mubawab.tn) — 22,164 live adverts across the same sections. Riads are Moroccan and do not exist there.

Cities are whatever the portal itself carries. Casablanca alone holds 4,805 apartments for sale, Marrakech 2,585, Tanger 1,528, Rabat 393, Fès 314, Salé 260, Kénitra 260, Temara 202, Tétouan 197, El Jadida 187. Tunisia adds Tunis, Sousse, Sfax, Ariana, Hammamet, Djerba, Nabeul, La Marsa and Carthage. Leave the city empty and the search runs nationwide.

Mubawab writes its city addresses with the accents in place, so fès, salé, kénitra and béni-mellal are the spellings that work. Type the plain name and the run lower-cases and hyphenates it for you.

---

💼 Use Cases & Examples

1. Maghreb property-market analysts

Track asking prices and price per m² across two countries without reconciling two scrapers.

Input: a city and a section, run on a schedule Output: one row per advert with price, surface, rooms, neighbourhood and the portal's own match count Use: build the Casablanca or Tunis price series the portals themselves only publish in summary

2. Estate agencies and brokers

See how every competing advert on your street is priced.

Input: your city plus the section you list in Output: surface, bedroom count, amenities and asking price for each rival advert Use: price a new instruction against live comparables instead of last quarter's feel

3. Agency lead generation

Build the list of brokers who actually carry stock.

Input: a city section, then Listing Detail on the rows that matter Output: agencyName on every detail row, alongside the advert it belongs to Use: rank agencies by how many live adverts they hold, and approach the ones with volume

4. Diaspora and relocation portals

Fill a Morocco or Tunisia property search with live inventory that maps itself.

Input: the cities your users search Output: rows carrying real latitude and longitude from the advert's own map Use: drop listings onto a map with no geocoding step and no address-matching guesswork

5. Developers and land buyers

Watch plots enter the market at a given size and price.

Input: propertyType: land, a city, and a surface bound Output: every terrain advert with its surface, price and neighbourhood Use: spot land coming to market before it reaches a broker's shortlist

6. Holiday-let and short-stay operators

Read the seasonal section Mubawab keeps apart from long rentals.

Input: transaction: vacation on apartments or villas Output: 967 holiday apartments and 149 holiday villas in Morocco, priced on the nightly market Use: benchmark a coastal let against the stock that is genuinely competing with it

7. Investment and proptech research

Assemble a two-country panel with one field vocabulary.

Input: both markets, the sections you care about, scheduled Output: ~79,000 live adverts with identical field names across Morocco and Tunisia Use: compare the two markets directly instead of normalising two different data shapes

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/mubawab-property-scraper').call({
  operation: 'search',
  market: 'ma',
  propertyType: 'apartment',
  transaction: 'sale',
  city: 'casablanca',
  maxResults: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/mubawab-property-scraper').call(
    run_input={
        'operation': 'search',
        'market': 'tn',
        'propertyType': 'villa',
        'transaction': 'sale',
        'city': 'hammamet',
        'maxResults': 100,
    }
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item['titleText'], item['price'], item['currency'])

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~mubawab-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"operation":"search","market":"ma","propertyType":"riad","transaction":"sale","city":"marrakech","maxResults":50}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: a daily schedule, or a webhook from your own system
2. HTTP Request: call the actor's run endpoint with your input
3. Process: filter the returned rows on price, neighbourhood or agency
4. Action: append to a sheet, upsert to a database, or alert your team on new stock

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• 25 rows per run, with every field and both operations
• No credit card required
• Enough to see what a Casablanca or Tunis sweep actually returns

PAID Tier (Production Ready)

• Unlimited rows per run
• Pay per row returned — a failed advert and a filtered-out one both cost nothing
• A run start fee and a per-row price, both shown live on the Store page

💰 Priced against a two-country record. The row carries surface, bedrooms, bathrooms, neighbourhood, amenities and the advert excerpt. The detail row adds coordinates and the agency. That is a fuller record than a title-and-price scrape, at roughly the same money.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: What does the actor return per listing? A: Search returns one row per advert card: price and currency, the price exactly as the portal prints it, surface in m², bedroom and bathroom counts, neighbourhood and city, amenities, the advert excerpt, the photos and the URL. Detail opens the advert's own page and adds GPS coordinates, the numeric price from the portal's structured data, total room count, the agency, the attribute sheet and the complete text.

Q: Does one actor really cover both Morocco and Tunisia? A: Yes, because Mubawab is one application. The two hosts serve identical code and share one listing-id space — ask the Tunisian host for a Moroccan advert id and it redirects you to the Moroccan page. Buying two scrapers would buy you the same parser twice.

Q: Is Algeria covered? A: No, and not by anyone else either. mubawab.dz does not resolve: its nameservers refuse the query on both Cloudflare and Google DNS, and there is no address record. Mubawab operates in Morocco and Tunisia.

Q: Why is price sometimes empty? A: Because the advert says "Prix à consulter" — price on request. That is common on high-end villas and new-build projects. The row keeps the portal's own wording in priceLabel and leaves price null rather than inventing a number. Set a price filter and those adverts drop out.

Q: Why do the price filters not show up in the Mubawab URL? A: The portal does not put them there. It applies price, bedroom and surface filters through an internal request instead of a link you can bookmark, so the run reads the result pages and keeps only what matches your bounds. Filtering happens before billing.

Q: How deep can a search go? A: As deep as the section does. A Moroccan apartments-for-sale run has more than 15,000 adverts behind it and pagination runs to the last page. maxResults exists so you can cap your own spend, not because the portal stops.

Q: Why does the same advert appear on the first two pages? A: Mubawab pins promoted adverts to the top of every result page. Those rows carry isPromoted: true, and repeats are dropped before counting, so you are never charged twice for one advert.

Q: What output formats are available? A: JSON, CSV and Excel, exported from the dataset or read straight from the API.

---

🐛 Troubleshooting

The run says Mubawab publishes no page for my city

• Write the city as Mubawab writes it, accents included: fès, salé, kénitra, tétouan, béni-mellal. Stripping the accent gives a 404, not a redirect.
• If you are not sure of the spelling, leave City empty and search the whole country.

The run says there is no section for my property type and transaction

• Riads are sale-only and Moroccan. Holiday lets exist for apartments and villas only. The message lists the pairings that section supports.

My filters returned nothing

• Widen the bounds. Remember that adverts marked "Prix à consulter" carry no number and are excluded whenever a price bound is set.

A detail row came back as an error

• The advert was sold, rented or withdrawn. Run a Listing Search over the same neighbourhood to pick up what replaced it. You are not charged for a failed row.

A run says the portal is temporarily unavailable

• It already retried five times. Run the same input again in a few minutes.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

Mubawab is a trademark of its owner. This actor is not affiliated with, endorsed by or sponsored by Mubawab, and reads only pages that are already public.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue on the actor's page
• Check the SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools