Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Mubawab

1 credit per call5 endpoints19 datapoints

Mubawab API

Mubawab API for apartments, villas, riads and land for sale or rent in Morocco and Tunisia, listings and agencies as JSON. 1 credit per successful call.

Get a free API keyRun it below
Mubawab
GET/v1/mubawab/search?transaction=sale&location=rabat&sort=price_asc&min_price=1000000&max_price=2000000
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 8287523,
        "url": "https://www.mubawab.ma/fr/a/8287523/appartement-avec-terrasse-et-vue-mer",
        "kind": "ad",
        "is_project": false,
        "title": "Appartement avec terrasse et vue mer",
        "title_truncated": false,
        "price": 1000000,
        "currency": "DH",
        "price_on_request": false,
        "location": "L'Ocean, Rabat",
        "area_m2": 126,
        "rooms": 1,
        "bedrooms": 1,
        "bathrooms": 1,
        "amenities": [
          "Terrasse",
          "Garage",
          "Vue sur mer"
        ],
        "description_excerpt": "Nous proposons à la vente un appartement spacieux de 126 m², situé au 4ᵉ étage dans le quartier recherché de L’Océan à Rabat. L’appartement n’est pas entièrement rénové, mais il offre un fort potentiel d’aménagement, idéal pour une résidenc…",
        "images": [
          "https://www.mubawab-media.com/ad/8/287/523F/h/WhatsApp%20Image%202026-01-16%20at%2018.07.21%20%283%29_81796288.avif",
          "https://www.mubawab-media.com/ad/8/287/523F/h/WhatsApp%20Image%202026-01-16%20at%2018.07.21%20%282%29_81796289.avif",
          "https://www.mubawab-media.com/ad/8/287/523F/h/WhatsApp%20Image%202026-01-16%20at%2018.07.21%20%281%29_81796290.avif"
        ],
        "offer_type": "sale",
        "property_type": "apartments"
      },
      {
        "id": 8432965,
        "url": "https://www.mubawab.ma/fr/a/8432965/appartement-r%C3%A9nov%C3%A9-de-80-m%C2%B2-%C3%A0-vendre-%C3%A0-l%E2%80%99oc%C3%A9an",
        "kind": "ad",
        "is_project": false,
        "title": "Appartement rénové de 80 m² à vendre à l’Océan",
        "title_truncated": false,
        "price": 1000000,
        "currency": "DH",
        "price_on_request": false,
        "location": "L'Ocean, Rabat",
        "area_m2": 80,
        "rooms": 3,
        "bedrooms": 2,
        "bathrooms": 2,
        "amenities": [
          "Terrasse",
          "Salon Marocain",
          "Salon européen"
        ],
        "description_excerpt": "Century 21 vous propose à la vente un appartement rénové de 80 m², situé au 3ᵉ étage d’un immeuble dans le quartier de l’Océan à Rabat. Ce bien représente une belle opportunité pour une résidence principale ou un investissement immobilier. …",
        "images": [
          "https://www.mubawab-media.com/ad/8/432/965F/h/WhatsApp_Image_2026-10-12_at_11.21.18_83488548.avif",
          "https://www.mubawab-media.com/ad/8/432/965F/h/WhatsApp_Image_2026-10-12_at_11.21.19__2__83488549.avif",
          "https://www.mubawab-media.com/ad/8/432/965F/h/WhatsApp_Image_2026-10-12_at_11.21.21__2__83488550.avif"
        ],
        "offer_type": "sale",
        "property_type": "apartments"
      },
      {
        "id": 8440705,
        "url": "https://www.mubawab.ma/fr/a/8440705/studio-%C3%A0-vendre-agdal",
        "kind": "ad",
        "is_project": false,
        "title": "Studio à vendre Agdal",
        "title_truncated": false,
        "price": 1000000,
        "currency": "DH",
        "price_on_request": false,
        "location": "Agdal, Rabat",
        "area_m2": 34,
        "rooms": 1,
        "bedrooms": 1,
        "bathrooms": 1,
        "amenities": [
          "Garage",
          "Ascenseur",
          "Concierge"
        ],
        "description_excerpt": "Découvrez des appartements neufs à Agdal, Rabat, avec des finitions haut standing et des superficies à partir de 34 m². Pour votre résidence ou votre projet d’investissement, contactez-nous pour découvrir les plans et les disponibilités. Po…",
        "images": [
          "https://www.mubawab-media.com/ad/8/440/705F/h/Chambre-Agdal-1080x1080__2__83585823.avif",
          "https://www.mubawab-media.com/ad/8/440/705F/h/Studio-Agdal-1080x1080__3__83585820.avif",
          "https://www.mubawab-media.com/ad/8/440/705F/h/Cuisine-Agdal-1080x1080__1__83585821.avif"
        ],
        "offer_type": "sale",
        "property_type": "apartments"
      }
    ],
    "excluded_by_filters": 0,
    "pagination": {
      "page": 1,
      "page_size": 32,
      "total": 67,
      "total_pages": 3,
      "has_next": true
    },
    "filters_applied": {
      "location": "rabat",
      "sort": "price_asc",
      "min_price": 1000000,
      "max_price": 2000000
    }
  },
  "meta": {
    "country": "ma",
    "language": "fr",
    "endpoint_family": "search",
    "request_id": "req_6487d26d8b9e444e80ee5d0f820f8247",
    "credits_charged": 1,
    "credits_remaining": 1843
  }
}
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.

#idintegerurlurlkindstringis_projectbooleantitlestringtitle_truncatedbooleanpriceintegercurrencystringprice_on_requestbooleanlocationstringarea_m2integerroomsintegerbedroomsintegerbathroomsintegeramenitiesstring[]description_excerptstringimagesstring[]offer_typestringproperty_typestring
18287523https://www.mubawab.ma/fr/a/8287523/appartement-avec-terrasse-et-vue-meradfalseAppartement avec terrasse et vue merfalse1000000DHfalseL'Ocean, Rabat126111[3 items]Nous proposons à la vente un appartement spacieux de 126 m², situé au 4ᵉ étage dans le quartier recherché de L’Océan à Rabat. L’appartement n’est pas entièrement rénové, mais il offre un fort potentiel d’aménagement, idéal pour une résidenc…[3 items]saleapartments
28432965https://www.mubawab.ma/fr/a/8432965/appartement-r%C3%A9nov%C3%A9-de-80-m%C2%B2-%C3%A0-vendre-%C3%A0-l%E2%80%99oc%C3%A9anadfalseAppartement rénové de 80 m² à vendre à l’Océanfalse1000000DHfalseL'Ocean, Rabat80322[3 items]Century 21 vous propose à la vente un appartement rénové de 80 m², situé au 3ᵉ étage d’un immeuble dans le quartier de l’Océan à Rabat. Ce bien représente une belle opportunité pour une résidence principale ou un investissement immobilier. …[3 items]saleapartments
38440705https://www.mubawab.ma/fr/a/8440705/studio-%C3%A0-vendre-agdaladfalseStudio à vendre Agdalfalse1000000DHfalseAgdal, Rabat34111[3 items]Découvrez des appartements neufs à Agdal, Rabat, avec des finitions haut standing et des superficies à partir de 34 m². Pour votre résidence ou votre projet d’investissement, contactez-nous pour découvrir les plans et les disponibilités. Po…[3 items]saleapartments

Recorded from our API · 3 items shown · 19 datapoints per itemGET /v1/mubawab/search?transaction=sale&location=rabat&sort=price_asc&min_price=1000000&max_price=2000000

19 datapoints

Identity

  • idinteger
  • titlestring
  • title_truncatedboolean
  • offer_typestring
  • property_typestring

Contact

  • urlurl

Location

  • locationstring
  • area_m2integer

Reputation

  • imagesstring[]

Price

  • priceinteger
  • currencystring
  • price_on_requestboolean

Other

  • kindstring
  • is_projectboolean
  • roomsinteger
  • bedroomsinteger
  • bathroomsinteger
  • amenitiesstring[]
  • description_excerptstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/mubawab/search?transaction=sale&location=rabat&sort=price_asc&min_price=1000000&max_price=2000000" \
  -H "X-API-Key: $API_KEY"

Mubawab · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/mubawab/agency
id+2 optional
1 credit
GET/v1/mubawab/autocomplete
query+2 optional
1 credit
GET/v1/mubawab/filters
none
1 credit
GET/v1/mubawab/listing
none+5 optional
1 credit
GET/v1/mubawab/search
none+19 optional
1 credit

Overview

What you can get

The Mubawab API returns Mubawab property data as JSON through 5 endpoints. search, listing, agency and autocomplete take a country of ma or tn, and all but autocomplete a language of fr or en.

  • Search: search takes a location, with transaction (sale or rent), property_type (apartments, villas, houses, land, offices, premises, riads or all), sort (default, newest, price_asc or price_desc), page, min_price, max_price, min_area, max_area, min_rooms, min_bedrooms, min_bathrooms, and promotion, second_hand, pool, elevator and garden flags.
  • Listings: listing takes an id or a listing url, with kind (ad or project).
  • Agencies: agency takes an id.
  • Lookups: autocomplete takes a query, with limit; filters takes no parameters.

The recorded search for Rabat (for sale, 1,000,000 to 2,000,000, sorted by price_asc) returns a total of 67, with page_size, total_pages and has_next. Each item carries id, url, kind, is_project, title, price, currency, price_on_request, location, area_m2, rooms, bedrooms, bathrooms, amenities, description_excerpt, images, offer_type and property_type.

How a call works

Search a city: GET /v1/mubawab/search?transaction=sale&location=rabat&sort=price_asc&min_price=1000000&max_price=2000000 with your key in the X-API-Key header. Each item's id and kind are what listing takes. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices and rents in Rabat and other Moroccan and Tunisian cities

Use the Mubawab API to track asking prices and rents in Rabat and other Moroccan and Tunisian cities

Find riads and villas with a `pool` or `garden`

Use the Mubawab API to find riads and villas with a `pool` or `garden`

Separate projects from individual ads with `is_project`

Use the Mubawab API to separate projects from individual ads with `is_project`

Compare price against `area_m2` across districts

Use the Mubawab API to compare price against `area_m2` across districts

FAQ

Questions

How much does the Mubawab 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.

Which countries does it cover?

Set `country` to ma or tn for Morocco or Tunisia.

Do I need a Mubawab account?

No. You call this Mubawab API with your Perceptlayer key in the `X-API-Key` header, with no Mubawab login.

Should I build a Mubawab scraper instead?

You can, but a Mubawab scraper is code you maintain: page changes break it, requests get blocked, and Mubawab's terms govern how you collect data. The Mubawab API gives you 5 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 Mubawab API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs