# Mudah.my Property Buildings API Documentation

<p><strong>Mudah.my Property Buildings API</strong> searches the building directory by keyword. Each building has the name, developer, address, property type, tenure, location, sale and rent price ranges, listing counts, cover image, facilities, completion year and nearby amenities. Results are paged with 20 buildings per page.</p>

- **Documentation:** [https://scrappa.co/docs/mudah-property-api/mudah_property_buildings](https://scrappa.co/docs/mudah-property-api/mudah_property_buildings)
- **API group:** Mudah.my Property API
- **Endpoint:** `GET https://scrappa.co/api/mudah-property/v1/buildings`

## 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 |
| --- | --- | --- | --- |
| `keyword` | string | Yes | Building or area name, 2 to 100 characters. Example: klcc. |
| `page` | integer | No | One-based page number. 20 buildings per page. Example: 2. |

## Example response

```json
{
    "data": {
        "buildings": [
            {
                "name": "Isola KLCC",
                "size": null,
                "slug": "isola-klcc",
                "units": 140,
                "floors": 52,
                "tenure": "Freehold",
                "address": "Jalan Yap Kwan Seng",
                "prop_id": "f575860b-d45d-4c5d-88d8-f4a60fb734bc",
                "bedrooms": null,
                "location": {
                    "label": "KLCC, Kuala Lumpur",
                    "region": "Kuala Lumpur",
                    "subarea": "KLCC",
                    "region_id": 9,
                    "subarea_id": 379
                },
                "bathrooms": null,
                "developer": "O&C Makok Isola Sdn Bhd",
                "facilities": "Parking, Sauna, Club house, Minimart, Gymnasium, Squash court, Jogging track, Lift, Security guards, Playground, Swimming pool, Tennis court, Barbeque area, Multi purpose hall.",
                "cover_image": "https://cdn.rnudah.com/image_property/plain/2e37514b0f918d6055ee1a962ab1c67f-2848370664484427232.jpg",
                "property_type": {
                    "id": 5,
                    "name": "Service Residence"
                },
                "completion_year": 2024,
                "nearby_amenities": [],
                "rent_price_range": "RM 3 200 - RM 3 600",
                "sale_price_range": "RM 0",
                "rent_listing_count": 7,
                "sale_listing_count": 0
            },
            {
                "name": "Dawn KLCC",
                "size": null,
                "slug": "dawn-klcc",
                "units": 960,
                "floors": 68,
                "tenure": "Freehold",
                "address": "Off Jalan Ampang",
                "prop_id": "985351fc-ac73-11ef-8f5c-4b7a9768102e",
                "bedrooms": null,
                "location": {
                    "label": "KLCC, Kuala Lumpur",
                    "region": "Kuala Lumpur",
                    "subarea": "KLCC",
                    "region_id": 9,
                    "subarea_id": 379
                },
                "bathrooms": null,
                "developer": "Chin Hin Property Development",
                "facilities": "Barbeque area, Security guards, Swimming pool, Sauna, Multi purpose hall, Club house, Minimart, Tennis court, Squash court, Parking, Playground, Gymnasium, Jogging track, Lift.",
                "cover_image": "https://cdn.rnudah.com/image_property/plain/1763850388b9a6938e2f7b62bca861e1-2906954226265560515.jpg",
                "property_type": {
                    "id": 5,
                    "name": "Service Residence"
                },
                "completion_year": 2028,
                "nearby_amenities": [],
                "rent_price_range": "RM 0",
                "sale_price_range": "RM 600 000",
                "rent_listing_count": 0,
                "sale_listing_count": 1
            }
        ],
        "search_metadata": {
            "page": 1,
            "showing": 15,
            "has_next": false,
            "per_page": 20,
            "total_results": 15
        },
        "search_parameters": {
            "page": 1,
            "keyword": "klcc"
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "buildings"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 503 | Upstream Unavailable | Mudah.my could not be reached. This response is not billable and is retryable. |
| 503 | Unexpected Upstream Data | Mudah.my returned data in an unexpected shape. 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)