# Mubawab Listing API Documentation

<p><strong>Mubawab Listing API</strong> returns one listing: full title and description, price, currency, availability, property type, locality, rooms, bedrooms, bathrooms, area, coordinates, general characteristics, amenities, all photos, the seller name, the reference and the agency (id, name, URL, logo).</p><p>New-build projects return the starting price, badges, photos and one entry per unit in <code>units</code>. Phone numbers and contact forms are never returned. A listing that is gone answers 404. Failed requests are not billed.</p>

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

## 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 |
| --- | --- | --- | --- |
| `url` | string | No | Full Mubawab listing URL from a search item (fr or en, ma or tn). Send this or an id. |
| `id` | integer | No | Listing id from a search item. |
| `kind` | string | No | ad (default) or project. Use project for items with is_project set to true. Only for an id. |
| `country` | string | No | ma (default) or tn. Only for an id. |
| `language` | string | No | fr (default) or en. Only for an id. |

## Example response

```json
{
    "data": {
        "listing": {
            "id": 8437710,
            "url": "https://www.mubawab.ma/fr/a/8437710/bel-appartement-%C3%A0-vendre-%C3%A0-el-manzeh-3-chambres-agr%C3%A9ables-meubl%C3%A9",
            "kind": "ad",
            "price": 1650000,
            "rooms": 3,
            "title": "Bel appartement \u00e0 vendre \u00e0 El Manzeh 3 chambres agr\u00e9ables. Meubl\u00e9",
            "agency": {
                "id": 6145,
                "url": "https://www.mubawab.ma/fr/b/6145/andalousse-home",
                "logo": "https://www.mubawab-media.com/business/6/145F/s/photo_00_62417585.avif",
                "name": "Andalousse home",
                "slug": "andalousse-home"
            },
            "images": [
                "https://www.mubawab-media.com/ad/8/437/710F/h/photo_0_83551083.avif",
                "https://www.mubawab-media.com/ad/8/437/710F/h/photo_1_83551086.avif",
                "https://www.mubawab-media.com/ad/8/437/710F/h/photo_2_83551087.avif"
            ],
            "area_m2": 100,
            "bedrooms": 3,
            "currency": "MAD",
            "features": [
                {
                    "label": "Type de bien",
                    "value": "Appartement"
                },
                {
                    "label": "Etat",
                    "value": "Bon \u00e9tat / habitable"
                },
                {
                    "label": "Ann\u00e9es",
                    "value": "10-20 ans"
                },
                {
                    "label": "\u00c9tage du bien",
                    "value": "1er"
                },
                {
                    "label": "Orientation",
                    "value": "Est"
                },
                {
                    "label": "Type du sol",
                    "value": "Carrelage"
                }
            ],
            "latitude": 33.856328,
            "locality": "Rabat",
            "amenities": [
                "Jardin",
                "Garage",
                "Concierge",
                "Meubl\u00e9",
                "Salon Marocain",
                "Salon europ\u00e9en"
            ],
            "available": true,
            "bathrooms": 2,
            "longitude": -6.850906,
            "reference": "Bassatin El manzeh",
            "is_project": false,
            "description": "Situ\u00e9 dans le quartier paisible \u00e0 Menzeh, ce spacieux appartement de 100 m\u00b2, \u00e2g\u00e9 de 10 \u00e0 20 ans, offre un cadre de vie confortable et moderne. D\u00e8s l'entr\u00e9e, on est accueilli par un salon europ\u00e9en lumineux, agr\u00e9ment\u00e9 de somptueux meubles et d'une climatisation efficace. Le salon marocain, avec ses as...",
            "schema_type": "Apartment",
            "seller_name": "Andalousse home",
            "country_code": "MA"
        }
    },
    "meta": {
        "country": "ma",
        "billable": true,
        "language": "fr",
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The listing does not exist or was removed. 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)