Mubawab Agency API returns an agency profile: name, address, description, logo and the first page of its listings (about 11 to 13 cards, same item shape as search). Later pages of an agency are not available. Phone numbers and contact forms are never returned. An unknown agency answers 404. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
integer
Required
Agency id from the agency.id field of a listing.
1234567890
string
Optional
ma (default) or tn.
US
string
Optional
fr (default) or en.
en
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"agency": {
"id": 6145,
"logo": "https://www.mubawab-media.com/business/6/145F/s/photo_00_62417585.avif",
"name": "Andalousse home",
"address": "Hay riad rabat",
"listings": [
{
"id": 8441081,
"url": "https://www.mubawab.ma/fr/a/8441081/louez-cet-appartement-%C3%A0-riyad-superficie-110-m%C2%B2-meubl%C3%A9",
"kind": "ad",
"tags": [],
"price": 17000,
"rooms": 3,
"title": "Louez cet appartement \u00e0 Riyad. Superficie 110 m\u00b2. Meubl\u00e9",
"images": [
"https://www.mubawab-media.com/ad/8/441/081F/h/photo_0_83590046.avif",
"https://www.mubawab-media.com/ad/8/441/081F/h/photo_1_83590047.avif"
],
"area_m2": 110,
"bedrooms": 3,
"currency": "DH",
"location": "Riyad, Rabat",
"amenities": [
"Terrasse",
"Garage",
"Ascenseur",
"Concierge"
],
"bathrooms": 2,
"is_project": false,
"offer_type": null,
"units_label": null,
"property_type": null,
"title_truncated": false,
"price_on_request": false,
"description_excerpt": "Cet appartement moderne, situ\u00e9 dans le quartier pris\u00e9 d'Agdal-Riyad \u00e0 Rabat, offre une combinaison parfaite de confort et de commodit\u00e9s. Avec une superficie de 110 m\u00b2, il dispose de trois chambres spacieuses et de deux salles de bain. La r\u00e9sidence, r\u00e9cente de 1 \u00e0 5 ans d'anciennet\u00e9, est \u00e9quip\u00e9e de la climatisation et autorise la pr\u00e9sence d'animaux domestiques, ce qui en fait un choix id\u00e9al pour les familles. L'int\u00e9rieur b\u00e9n\u00e9ficie de sols en marb..."
}
],
"description": "Andalouse homes est une agence immobili\u00e8re ind\u00e9pendante sp\u00e9cialis\u00e9e dans la transaction des biens, votre demande sera trait\u00e9e de mani\u00e8re professionnel ,\n\nnous vous souhaitons le bienvenue.",
"listings_returned": 11
}
},
"meta": {
"country": "ma",
"billable": true,
"language": "fr",
"endpoint_family": "agency"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"id": [
"The id field is required."
]
},
"message": "The request validation failed"
}Not Found
The agency does not exist. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "agency"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}Upstream Unavailable
Mubawab could not be reached or returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "agency"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Mubawab could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.