# Adondevivir Listing Detail API Documentation

Read one listing by the url from /search or by its numeric id. The answer has the title, status, prices in soles and dollars, the maintenance fee, bedrooms, bathrooms, rooms, covered and total area, age, address, coordinates, location tree, features by group, the full description, all photos, the publication date and the publisher with id, name, logo and type. Fields the page does not show are null. Phone numbers are never returned. An unknown listing is a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/adondevivir-api/adondevivir_listing](https://scrappa.co/docs/adondevivir-api/adondevivir_listing)
- **API group:** Adondevivir API
- **Endpoint:** `GET https://scrappa.co/api/adondevivir/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 | No | Listing url as returned by /search. Use url or id. |
| `id` | integer | No | Numeric listing id such as 150116537. Use url or id. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "data": {
        "id": "150116537",
        "posting_code": "659Q4H",
        "url": "https://www.adondevivir.com/propiedades/clasificado/alclapin-departamento-de-2-habitaciones-2-balcones-150116537.html",
        "title": "Departamento de 2 Habitaciones + 2 Balcones | Miraflores | 65 m\u00b2",
        "subtitle": "Departamento \u00b7 2 dormitorios",
        "status": "ONLINE",
        "posting_type": "PROPERTY",
        "property_type": {
            "id": "2",
            "name": "Apartamento"
        },
        "operation": {
            "id": "2",
            "name": "alquiler"
        },
        "prices": [
            {
                "amount": 3420,
                "formatted_amount": "3,420",
                "currency": "S/",
                "iso_code": "PEN"
            },
            {
                "amount": 1000,
                "formatted_amount": "1,000",
                "currency": "USD",
                "iso_code": "USD"
            }
        ],
        "price_display": "S/ 3,420",
        "expenses": {
            "amount": 375,
            "formatted_amount": "375",
            "currency": "S/"
        },
        "features": {
            "land_area_m2": 65,
            "built_area_m2": 65,
            "bathrooms": 2,
            "bedrooms": 2,
            "age": 7
        },
        "other_features": [],
        "rooms": 2,
        "general_features": {
            "Caracter\u00edsticas generales": [
                "Piscina",
                "Seguridad",
                "Cerca a Parque (a menos de 2 cdras)"
            ],
            "Servicios": [
                "Video vigilancia",
                "Guardian\u00eda/Seguridad privada",
                "L\u00ednea blanca"
            ]
        },
        "description": "Departamento disponible en alquiler en el distrito de Miraflores, Lima.\n\nPiso 3\n65 m\u00b2\nSala y comedor integrados, una cocina equipada\n2 dormitorios\n2 ba\u00f1os.\nDormitorio principal incluye ba\u00f1o propio, un...",
        "address": "Calle Berl\u00edn 351",
        "address_visibility": "EXACT",
        "coordinates": {
            "lat": -12.1211096,
            "lon": -77.0332573
        },
        "location": {
            "zone": {
                "id": "V1-D-119497",
                "name": "Miraflores"
            },
            "city": {
                "id": "V1-C-3129",
                "name": "Lima"
            },
            "state": {
                "id": "V1-B-368",
                "name": "Lima"
            },
            "country": {
                "id": "V1-A-11",
                "name": "Peru"
            },
            "location_ids": [
                "V1-D-119497",
                "V1-C-3129",
                "V1-B-368",
                "V1-A-11"
            ]
        },
        "publisher": {
            "id": "102500843",
            "name": "Living by Wynwood House",
            "url": "https://www.adondevivir.com/inmobiliarias/living-by-wynwood-house_102500843-inmuebles.html",
            "logo": "https://img10.naventcdn.com/empresas/111/00/50/87/81/53/130x70/logo_living-by-wynwood-house_1749602967265.jpg",
            "type_id": "2",
            "is_premium": false,
            "license": null
        },
        "images": [
            {
                "url": "https://img10.naventcdn.com/avisos/111/01/50/11/62/28/1200x1200/1611485196.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true",
                "thumbnail": "https://img10.naventcdn.com/avisos/111/01/50/11/62/28/360x266/1611485196.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true",
                "order": 1
            },
            {
                "url": "https://img10.naventcdn.com/avisos/111/01/50/11/62/28/1200x1200/1611485191.jpg?rapc=bXZhX2ltYWdl",
                "thumbnail": "https://img10.naventcdn.com/avisos/111/01/50/11/62/28/360x266/1611485191.jpg?rapc=bXZhX2ltYWdl",
                "order": 2
            }
        ],
        "published_at": "2026-06-05T22:32:19Z"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter is missing or invalid. The response is not billable. |
| 404 | Resource Not Found | The requested Adondevivir resource does not exist. The response is not billable. |
| 503 | Unexpected Upstream Response | Adondevivir answered with a body that is not the documented shape. The response is not billable. |
| 503 | Upstream Unavailable | Adondevivir was temporarily unavailable or blocked the request. The response is not billable and the request never answers 429. |

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