--- title: "Mubawab API: Search | Perceptlayer" description: "Search from Mubawab as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/mubawab/search --- [APIs](https://perceptlayer.com/apis) / [Mubawab](https://perceptlayer.com/apis/mubawab) / Search # Mubawab: Search Search from Mubawab as JSON. 1 credit per successful call. GET `/v1/mubawab/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `country` | string | Optional | ma, tn | | `language` | string | Optional | fr, en | | `transaction` | string | Optional | sale, rent | | `property_type` | string | Optional | apartments, villas, houses, land, offices, premises, riads, all | | `location` | string | Optional | Up to 80 characters | | `sort` | string | Optional | default, newest, price\_asc, price\_desc | | `page` | integer | Optional | Any | | `min_price` | integer | Optional | Any | | `max_price` | integer | Optional | Any | | `min_area` | integer | Optional | Any | | `max_area` | integer | Optional | Any | | `min_rooms` | integer | Optional | Any | | `min_bedrooms` | integer | Optional | Any | | `min_bathrooms` | integer | Optional | Any | | `promotion` | boolean | Optional | Any | | `second_hand` | boolean | Optional | Any | | `pool` | boolean | Optional | Any | | `elevator` | boolean | Optional | Any | | `garden` | boolean | Optional | Any | ## Example request 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. [Run this endpoint in the playground](https://perceptlayer.com/apis/mubawab?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.