--- title: "Mubawab API: JSON data, 5 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/mubawab --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Mubawab 1 credit per call 5 endpoints 19 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | url url | kind string | is\_project boolean | title string | title\_truncated boolean | price integer | currency string | price\_on\_request boolean | location string | area\_m2 integer | rooms integer | bedrooms integer | bathrooms integer | amenities string\[\] | description\_excerpt string | images string\[\] | offer\_type string | property\_type string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 8287523 | https://www.mubawab.ma/fr/a/8287523/appartement-avec-terrasse-et-vue-mer | ad | false | Appartement avec terrasse et vue mer | false | 1000000 | DH | false | L'Ocean, Rabat | 126 | 1 | 1 | 1 | \[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\] | sale | apartments | | 2 | 8432965 | 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 | ad | false | Appartement rénové de 80 m² à vendre à l’Océan | false | 1000000 | DH | false | L'Ocean, Rabat | 80 | 3 | 2 | 2 | \[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\] | sale | apartments | | 3 | 8440705 | https://www.mubawab.ma/fr/a/8440705/studio-%C3%A0-vendre-agdal | ad | false | Studio à vendre Agdal | false | 1000000 | DH | false | Agdal, Rabat | 34 | 1 | 1 | 1 | \[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\] | sale | apartments | Recorded from our API · 3 items shown · 19 datapoints per item GET /v1/mubawab/search?transaction=sale&location=rabat&sort=price\_asc&min\_price=1000000&max\_price=2000000 19 datapoints ### Identity - id integer - title string - title\_truncated boolean - offer\_type string - property\_type string ### Contact - url url ### Location - location string - area\_m2 integer ### Reputation - images string\[\] ### Price - price integer - currency string - price\_on\_request boolean ### Other - kind string - is\_project boolean - rooms integer - bedrooms integer - bathrooms integer - amenities string\[\] - description\_excerpt string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/mubawab/agency`](https://perceptlayer.com/apis/mubawab/agency) | `id` +2 optional | 1 credit | | [GET `/v1/mubawab/autocomplete`](https://perceptlayer.com/apis/mubawab/autocomplete) | `query` +2 optional | 1 credit | | [GET `/v1/mubawab/filters`](https://perceptlayer.com/apis/mubawab/filters) | none | 1 credit | | [GET `/v1/mubawab/listing`](https://perceptlayer.com/apis/mubawab/listing) | none +5 optional | 1 credit | | [GET `/v1/mubawab/search`](https://perceptlayer.com/apis/mubawab/search) | none +19 optional | 1 credit | Overview ## About the Mubawab API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)