🏠 MarocAnnonces Real Estate Scraper

Want property ads from MarocAnnonces in a spreadsheet? This scraper makes it easy.

Use structured filters — better for AI agents — or paste an input_url. When input_url is set it overrides the filters.

This actor stays on sale and rent shelves that share the same columns (offer, rooms, bathrooms, surface): apartments, villas, studios, shops, offices, land, farms, and pharmacies. It returns up to 2000 rows per run.

Cars, goods, jobs, and services live in separate actors, because those shelves use different filters and different columns.

💡 Perfect for...

• Agencies: Export MarocAnnonces sale and rent ads with rooms and surface.
• Dashboards: Track asking prices in Casablanca, Rabat, and Marrakech.
• Market research: Slice listings by city, rooms, surface, or price.
• Data analysts: Export structured rows with seller, phone, photos, and the public ad text.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live MarocAnnonces property ads.
• 📚 RAG Systems: Feed titles, cities, and specs into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste any MarocAnnonces property URL, or pick sale or rent, a shelf, and a city. input_url always wins when set.
• 🎯 Website-Matched Filters: Offer, shelf, city, keyword, price, surface, rooms, and bathrooms.
• 🌐 Full property ads: Rooms, bathrooms, surface, photos, seller, phone, and description.

📦 What's inside the data?

id, url, title, category, offer_type, price, price_text, currency, city, country, posted, views, image, images, description, seller, phone, rooms, bathrooms, area_m2

🚀 Quick start

Option A: paste https://www.marocannonces.com/categorie/315/Vente-immobilier/Appartements.html. Option B: pick sale or rent, a shelf, and a city, then set max_results.

Input Example (filters):

{
  "offer": "vente",
  "category": "appartements",
  "city": "Marrakech",
  "rooms": 2,
  "max_results": 100
}

Input Example (URL):

{
  "input_url": "https://www.marocannonces.com/categorie/321/Location-immobilier/Appartements.html",
  "max_results": 100
}

Output Example:

{
  "id": "10474037",
  "url": "https://www.marocannonces.com/categorie/315/Appartements/annonce/10474037/Appartement-à-vendre-résidence-Coralia-Marrakech.html",
  "title": "Appartement à vendre résidence Coralia Marrakech",
  "category": "Appartements",
  "offer_type": "Sale",
  "price": 2200000,
  "price_text": "2 200 000 DH",
  "currency": "MAD",
  "city": "Marrakech",
  "country": "Morocco",
  "posted": "15 Oct-23:01",
  "views": 5,
  "rooms": 2,
  "bathrooms": 2,
  "area_m2": 94,
  "seller": "Othmane El Qasah",
  "phone": "061-857-9487",
  "description": "Appartement à vendre dans une résidence fermée et sécurisée avec piscine",
  "image": "https://www.marocannonces.com/user_images/315/2171558.jpg"
}

Output fields:

Field	Description
id	MarocAnnonces ad id.
url	Public ad page.
title	Ad title.
category	Property shelf, such as Appartements or Villas et Riads.
offer_type	Sale or Rent.
price	Numeric price in dirhams when stated.
price_text	Formatted price string from the card.
currency	MAD when a price is shown.
city / country	City, and Morocco.
posted	Date and time shown on the ad. The site prints the day and time without a year.
views	View count on the ad page.
image / images	Cover photo, and the photo gallery.
description	Ad text.
seller / phone	Seller name and phone number shown on the ad.
rooms	Number of rooms.
bathrooms	Number of bathrooms.
area_m2	Surface in square metres.

📋 Input reference

Parameter	Type	Required	Default	Description
input_url	string	No	—	MarocAnnonces property category, search, or ad URL. Overrides every filter.
offer	dropdown	No	vente	For sale or for rent.
category	dropdown	No	appartements	Apartments, villas, studios, shops, offices, land, farms, pharmacies, holiday rentals, or shared housing.
city	string	No	—	City, such as Marrakech.
query	string	No	—	Search keyword.
price_min / price_max	integer	No	—	Price range in Moroccan dirhams.
surface_min / surface_max	integer	No	—	Surface in square metres.
rooms	integer	No	—	Number of rooms. 6 or more matches +5.
bathrooms	integer	No	—	Number of bathrooms. 5 or more matches +4.
max_results	integer	No	50	Maximum rows (1–2000).