# Ciencuadras Property API Documentation

<p><strong>Ciencuadras Property API</strong> returns one listing or one new-build project. It carries the price, administration fee, built, private and lot area, rooms, address, coordinates, description, all photos, videos, 360 views, features, availability, the advertiser, nearby places and similar listings. Send the <code>url</code> of a search item. <code>status</code> and <code>is_available</code> show whether the listing is still on offer: unavailable listings stay online and are flagged <code>is_available: false</code>. For a project, <code>is_project</code> is true, <code>price</code> is empty and <code>project</code> holds the price range, delivery date and unit types. An unknown listing returns a not found error. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/ciencuadras-api/ciencuadras_property](https://scrappa.co/docs/ciencuadras-api/ciencuadras_property)
- **API group:** Ciencuadras API
- **Endpoint:** `GET https://scrappa.co/api/ciencuadras/property`

## 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 | Yes | Listing path from a search item, such as /inmueble/casa-en-venta-en-la-hacienda-cali-3923674 or /proyecto-de-vivienda/..., or its full https address on the Ciencuadras site. Other addresses are rejected. |

## Example response

```json
{
    "data": {
        "listing": {
            "id": 3923674,
            "url": "/inmueble/casa-en-venta-en-la-hacienda-cali-3923674",
            "code": "1115375-3923674",
            "floor": null,
            "price": 700000000,
            "photos": [
                {
                    "url": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3923674/adcddada_179285781891_plana.jpeg",
                    "type": null,
                    "order": 0
                },
                {
                    "url": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3923674/adcddaccb_179285781875_plana.jpeg",
                    "type": null,
                    "order": 1
                }
            ],
            "status": "4",
            "videos": [],
            "address": "Calle 15 # 69 - 81",
            "advisor": {
                "id": 1115375,
                "name": "Advisor name",
                "email": null,
                "phone": null,
                "type_id": 9,
                "whatsapp": "3000000000"
            },
            "garages": 2,
            "project": null,
            "stratum": 5,
            "area_lot": null,
            "bedrooms": 3,
            "currency": "COP",
            "elevator": false,
            "features": [
                {
                    "code": "WithHospitals",
                    "label": "Hospitales"
                },
                {
                    "code": "WithLight",
                    "label": "Luz Natural por la Ma\u00f1ana"
                },
                {
                    "code": "WithParks",
                    "label": "Parques"
                }
            ],
            "location": {
                "city": "Cali",
                "country": "Colombia",
                "latitude": 3.392984,
                "locality": "Comuna 17",
                "longitude": -76.529691,
                "department": "Valle del Cauca",
                "neighborhood": "La Hacienda"
            },
            "antiquity": "20",
            "bathrooms": 3,
            "lease_fee": null,
            "area_built": 87.85,
            "area_total": null,
            "blueprints": [],
            "is_project": false,
            "matterport": [],
            "offer_type": "Venta",
            "photos_360": [],
            "admin_value": 460000,
            "description": "Casa de tres pisos, en conjunto residencial tranquilo, cocina y area de ropa con instalacion hidraulica y electrica nueva, Aire acondicionado en los tres cuarto...",
            "area_private": 87.85,
            "area_terrace": null,
            "is_available": true,
            "photos_total": 15,
            "published_at": "2026-10-24T11:02:26.000Z",
            "canonical_url": "https://www.ciencuadras.com/inmueble/casa-en-venta-en-la-hacienda-cali-3923674",
            "distributions": [],
            "nearby_places": [],
            "property_type": "Casa",
            "storage_rooms": null,
            "similar_listings": [
                {
                    "id": 3837313,
                    "url": "/inmueble/casa-en-venta-en-la-hacienda-cali-3837313",
                    "city": "Cali",
                    "code": "445123-72134",
                    "image": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3837313/acdeb__17865659619_plana.jpeg",
                    "price": 750000000,
                    "status": "0",
                    "address": "LA HACIENDA,Cali, Valle del Cauca, Colombia",
                    "garages": 2,
                    "bedrooms": 5,
                    "latitude": 3.395687,
                    "bathrooms": 6,
                    "longitude": -76.530037,
                    "offer_type": "Venta",
                    "area_private": 200,
                    "neighborhood": "La Hacienda",
                    "canonical_url": "https://www.ciencuadras.com/inmueble/casa-en-venta-en-la-hacienda-cali-3837313",
                    "property_type": "Casa",
                    "distance_meters": 303
                }
            ],
            "nearby_neighborhoods": [
                "El Ingenio",
                "Caney"
            ],
            "price_is_placeholder": false,
            "market_reference_price": null
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "property"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The requested record does not exist. This response is not billable. |
| 503 | Upstream Unavailable | Ciencuadras 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)