# Urbania Listing Detail API Documentation

Read one classified listing by the url from /search, or by its numeric id. The answer has the title, full description, all prices in soles and dollars, fees, bedrooms, rooms, bathrooms, parking, covered and total area, age, publication date, address with place hierarchy, coordinates, the amenities by group, every photo, the advertiser and its public WhatsApp number. Fields the page does not show are null. A development project page returns is_project true, the project block (delivery, bank, stages, price and area ranges, unit groups, promotion, videos) and its units; a unit listing has is_project false. An unknown or removed listing is a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/urbania-api/urbania_listing](https://scrappa.co/docs/urbania-api/urbania_listing)
- **API group:** Urbania API
- **Endpoint:** `GET https://scrappa.co/api/urbania/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, for example https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-aurora-miraflores-3-dormitorios-4286342. Use url or id. |
| `id` | integer | No | Numeric listing id such as 4286342. Use url or id. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "data": {
        "id": 4286342,
        "code": "4286342",
        "url": "https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-aurora-miraflores-3-dormitorios-ascensor-4286342",
        "title": "Venta Departamento en Aurora S/ 1,920,800",
        "status": "ONLINE",
        "operation": "sale",
        "prices": [
            {
                "currency": "PEN",
                "amount": 1920800,
                "formatted": "1,920,800",
                "symbol": "S/"
            },
            {
                "currency": "USD",
                "amount": 560000,
                "formatted": "560,000",
                "symbol": "USD"
            }
        ],
        "expenses": {
            "amount": 900,
            "formatted": "900",
            "currency": null
        },
        "property_type": "Apartamento",
        "bedrooms": 3,
        "rooms": 3,
        "bathrooms": 3,
        "parking": 2,
        "area_total": 197,
        "area_covered": 195,
        "age_years": 5,
        "location": {
            "address": "Av. Ernesto Montagne 100",
            "latitude": -12.1207381,
            "longitude": -77.0131268
        },
        "amenities": {
            "Servicios": [
                {
                    "label": "Internet/Wifi",
                    "value": null
                }
            ]
        },
        "images": [
            {
                "url": "https://img10.naventcdn.com/avisos/11/00/64/13/76/79/1200x1200/316110573.jpg"
            }
        ],
        "agent": {
            "id": 1251411,
            "name": "MARTHANS GRUPO INMOBILIARIO",
            "type": "agency"
        },
        "whatsapp": "51 994018405"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A public parameter is missing or invalid, or the location cannot be resolved. The response is not billable. |
| 404 | Resource Not Found | The listing does not exist or was removed. The response is not billable. |
| 503 | Unexpected Upstream Response | Urbania answered with a page in an unexpected format. The response is not billable. |
| 503 | Upstream Unavailable | Urbania 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)