# Mubawab Agency API Documentation

<p><strong>Mubawab Agency API</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/mubawab-api/mubawab_agency](https://scrappa.co/docs/mubawab-api/mubawab_agency)
- **API group:** Mubawab API
- **Endpoint:** `GET https://scrappa.co/api/mubawab/agency`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer | Yes | Agency id from the agency.id field of a listing. |
| `country` | string | No | ma (default) or tn. |
| `language` | string | No | fr (default) or en. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The agency does not exist. This response is not billable. |
| 503 | Upstream Unavailable | Mubawab could not be reached or returned data that does not match the request. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)