# Portal Inmobiliario Listing API Documentation

Retrieve the full record of one listing or project by its MLC id: title, price in UF or CLP with the CLP value, bedrooms, bathrooms, area, feature rows (elevator, pets, parking, floor, orientation), address with latitude and longitude, description, photos with the photo count, publisher name and type, and the price per square metre against the zone average. Projects add technical specifications and unit models. The page shows up to five photos; image_count holds the full count. An unknown id is a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/portal-inmobiliario-api/portal_inmobiliario_listing](https://scrappa.co/docs/portal-inmobiliario-api/portal_inmobiliario_listing)
- **API group:** Portal Inmobiliario API
- **Endpoint:** `GET https://scrappa.co/api/portal-inmobiliario/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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Listing id from the search endpoint, e.g. MLC2350827571. The prefix MLC is optional. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/portal-inmobiliario/listing?id=MLC2350827571"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": "MLC2350827571",
            "url": "https://www.portalinmobiliario.com/MLC-2350827571-moderno-2d-2b-en-vaticano-chico-metro-salvador-est-y-bod-_JM",
            "title": "Moderno 2d 2b En Vaticano Chico | Metro Salvador + Est Y Bod",
            "is_project": false,
            "operation": "arriendo",
            "property_type": "Departamentos",
            "condition": "usado",
            "price": {
                "amount": 30,
                "currency": "UF",
                "amount_clp": 1236473
            },
            "bedrooms": 2,
            "bathrooms": 2,
            "area_m2": 68,
            "area_type": "total",
            "features": [
                {
                    "label": "Ascensor",
                    "value": "S\u00ed"
                },
                {
                    "label": "Admite mascotas",
                    "value": "S\u00ed"
                }
            ],
            "address": {
                "text": "Terranova 295, Providencia, Salvador, Providencia, RM (Metropolitana)",
                "latitude": -33.4376438,
                "longitude": -70.6270041
            },
            "image_count": 28,
            "publisher": {
                "name": "Oscar",
                "type": "particular",
                "is_verified": true
            },
            "price_per_m2": {
                "this_property": "0,45 UF/m\u00b2",
                "zone_average": "0,26 UF/m\u00b2"
            }
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter or range is invalid. This response is not billable. |
| 404 | Not Found | The listing id or the location slug is unknown. This response is not billable. |
| 503 | Upstream Unavailable | Portal Inmobiliario blocked every route, did not answer or returned a page the API could not read. Retry shortly. This response is not billable. |

## 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)