# Propiedades.com Listing API Documentation

<p><strong>Propiedades.com Listing API</strong> returns one listing with price, rooms, built area, address, coordinates, the full gallery, the advertiser name and photo, and average prices for the zone. <strong>Best effort:</strong> the listing page is protected and cannot always be loaded. When it cannot, the route answers 503 and the request is not billed; retry shortly. The description can be cut off by the site, see <code>description_truncated</code>. Phone numbers and other contact details are never returned. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/propiedades-com-api/propiedades_com_listing](https://scrappa.co/docs/propiedades-com-api/propiedades_com_listing)
- **API group:** Propiedades.com API
- **Endpoint:** `GET https://scrappa.co/api/propiedades-com/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 | Yes | The listing URL from a search item, a propiedades.com address starting with /inmuebles/. Required. |

## Example response

```json
{
    "data": {
        "id": 31599911,
        "url": "https://propiedades.com/inmuebles/departamento-en-renta-andres-bello-polanco-iv-seccion-df-31599911",
        "floor": 2,
        "price": 110000,
        "title": "Departamento disponible en renta en Andr\u00e9s Bello, Colonia Polanco IV Secci\u00f3n",
        "images": [
            {
                "id": 952870613,
                "url": "https://cdn.propiedades.com/files/600x400/DF-CDMX-Polanco-IV-Seccion-Andres-Bello-Miguel-Hidalgo-0-31599911.png",
                "width": 1200,
                "height": 900,
                "position": 1
            }
        ],
        "address": {
            "city": "Miguel Hidalgo",
            "state": "DF / CDMX",
            "colony": "Polanco IV Secci\u00f3n",
            "street": "Andr\u00e9s Bello",
            "zipcode": "11550"
        },
        "purpose": "Renta",
        "subtype": "Departamento",
        "bedrooms": 3,
        "currency": "MXN",
        "latitude": 19.4303847,
        "age_years": 46,
        "bathrooms": 3,
        "longitude": -99.1868662,
        "advertiser": {
            "name": "Peters&Romero",
            "picture": "https://propiedadescom.s3.amazonaws.com/files/profiles/example.png",
            "last_name": "Bienes Raices"
        },
        "description": "Exclusivo departamento en renta en Polanco\u2026",
        "price_label": "$ 110,000 MXN",
        "built_area_m2": 317,
        "parking_spaces": 2,
        "zone_statistics": {
            "area": "Zona Polanco",
            "average_price": "$54,106",
            "available_listings": 1166
        },
        "description_truncated": true
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | Propiedades.com could not be reached, or the listing page could not be loaded. Listing detail is best effort and can be unavailable for periods. 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)