# Properati Listing API Documentation

<p><strong>Properati Listing API</strong> returns one listing by the <code>id</code> from the search route. It has the price in COP, the administration fee, bedrooms, bathrooms, car spaces, area, stratum, construction year, floor, the full description, facilities (grouped), all photos, exact coordinates, the breadcrumb and the publishing agency with a link to its profile.</p><p>Good to know:</p><ul><li>Colombia only. Rent prices are per month. A number the listing does not show is <code>null</code>, never 0.</li><li>The detail needs two lookups on Properati: the page and the listing data. If the listing data is not available, you still get the page data with bedrooms, bathrooms, car spaces and coordinates set to <code>null</code>, and <code>meta.partial</code> is <code>true</code>.</li><li>An unknown id, an expired listing or a development id returns 404 and is not billed.</li><li>Phone numbers are not returned.</li><li>Failures are never billed.</li></ul>

- **Documentation:** [https://scrappa.co/docs/properati-api/properati_listing](https://scrappa.co/docs/properati-api/properati_listing)
- **API group:** Properati API
- **Endpoint:** `GET https://scrappa.co/api/properati/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 route. Example: 01a093a9-d7c1-78bb-b5d1-486b76e9cd17. |

## Example response

```json
{
    "data": {
        "listing": {
            "id": "01a093a9-d7c1-78bb-b5d1-486b76e9cd17",
            "url": "https://www.properati.com.co/detalle/14032-32-d7e1-486b76e9cd37-1a093c9-b5f1-78db",
            "area": {
                "unit": "m2",
                "value": 143
            },
            "floor": 4,
            "price": {
                "amount": 1200000000,
                "period": null,
                "currency": "COP",
                "formatted": "$ 1.200.000.000"
            },
            "title": "APARTAMENTO EN VENTA MEDELL\u00cdN EL POBLADO 143 M2",
            "agency": {
                "id": "14032-32-6171-4798f77a51d9-1a05ddd-9597-702c",
                "url": "https://www.properati.com.co/inmobiliaria/14032-32-6171-4798f77a51d9-1a05ddd-9597-702c",
                "name": "Mar\u00eda Cristina Ochoa U.",
                "logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg",
                "is_premium": true
            },
            "images": [
                "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvN2M2OGU5MWZkZThmMDliM2FjMTE4MDZkYmQyOTAwMTNhOTQxMWQ0YmViZDU5YjBhMjNhNGVkMzRjMGVlN2M0ZS5qcGVnIiwiYnJhbmQiOiJwcm9wZXJhdGkiLCJlZGl0cyI6eyJyb3RhdGUiOm51bGwsInJlc2l6ZSI6eyJ3aWR0aCI6NjUyLCJoZWlnaHQiOjQ4MCwiZml0IjoiY292ZXIifX19",
                "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvYmEwMTQxZjI5NTVkZTkyZDE2YmU3ZWVhMjdlNGE0YmYwMTNjZTY3Y2NmYmU0ZDNmY2ZmNTE5MjIyNzRjY2RjNC5qcGVnIiwiYnJhbmQiOiJwcm9wZXJhdGkiLCJlZGl0cyI6eyJyb3RhdGUiOm51bGwsInJlc2l6ZSI6eyJ3aWR0aCI6NjUyLCJoZWlnaHQiOjQ4MCwiZml0IjoiY292ZXIifX19"
            ],
            "stratum": 6,
            "bedrooms": 3,
            "location": {
                "text": "El Poblado, Medell\u00edn, Antioquia",
                "is_exact": true,
                "latitude": 6.196686,
                "longitude": -75.566718
            },
            "admin_fee": {
                "amount": 1173000,
                "currency": "COP",
                "formatted": "$ 1.173.000"
            },
            "bathrooms": 3,
            "breadcrumb": [
                {
                    "url": "https://www.properati.com.co/s/venta",
                    "name": "Venta"
                },
                {
                    "url": "https://www.properati.com.co/s/apartamento/venta",
                    "name": "Apartamentos"
                },
                {
                    "url": "https://www.properati.com.co/s/antioquia-colombia/apartamento/venta",
                    "name": "Antioquia"
                },
                {
                    "url": "https://www.properati.com.co/s/medellin-antioquia/apartamento/venta",
                    "name": "Medell\u00edn"
                },
                {
                    "url": "https://www.properati.com.co/s/el-poblado-medellin/apartamento/venta",
                    "name": "El Poblado"
                }
            ],
            "car_spaces": null,
            "facilities": [
                "Balc\u00f3n",
                "Cuarto de servicio",
                "Permite mascotas",
                "Cocina integral",
                "Gas natural",
                "Piscina",
                "Vigilante",
                "Ascensor"
            ],
            "description": "VENDO APARTAMENTO EN MEDELL\u00cdN EN EL POBLADO\nValor: $1200 millones\nArea: 143 m2 construidos \nSi quieres vivir en un apartamento parte baja de El Poblado, con espacios generosos, que puedas salir a caminar, con iglesia cercana, \u00e9sta es tu opo...",
            "image_count": 13,
            "listing_type": "sale",
            "published_at": "2026-09-12",
            "property_type": "apartamento",
            "published_text": "12 sept 2026",
            "publisher_name": "Mar\u00eda Cristina Ochoa U.",
            "facility_groups": [
                {
                    "group": "Caracter\u00edsticas de la propiedad",
                    "items": [
                        "Balc\u00f3n",
                        "Cuarto de servicio",
                        "Permite mascotas",
                        "Cocina integral",
                        "Gas natural"
                    ]
                },
                {
                    "group": "Caracter\u00edsticas del edificio",
                    "items": [
                        "Piscina",
                        "Vigilante",
                        "Ascensor"
                    ]
                }
            ],
            "construction_year": 1996
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The id is missing or has an invalid format. This response is not billable. |
| 404 | Not Found | No listing exists for this id, or the listing expired. This response is not billable. |
| 503 | Upstream Unavailable | Properati could not be reached, or returned a page that does not match the expected shape. 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)