Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Urbania

1 credit per call4 endpoints31 datapoints

Urbania API

Urbania API for Peruvian homes to buy or rent, prices in soles or dollars, listings, agencies and place lookups as JSON. 1 credit per successful call.

Get a free API keyRun it below
Urbania
GET/v1/urbania/search?operation=sale&property_type=apartment&location=miraflores--lima--lima&price_min=200000&price_max=400000&currency=USD&bedrooms_min=2&exclude_projects=true
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 150002643,
        "code": "YAP7937759",
        "url": "https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-miraflores-lima-2-dormitorios-150002643",
        "title": "Venta Departamento Moderno y Espacio con Balcón Grande en Miraflores",
        "summary": "Departamento · 132m² · 2 Dormitorios · 2 Estacionamientos",
        "description": "Venta departamento moderno Y espacio con balcón grande en mirafloresexperimenta el estilo de vida definitivo de Miraflores en este elegante y moderno Flat de 2 dormitorios en la Calle José González. Con una ubicación perfecta entre el malec…",
        "operation": "sale",
        "prices": [
          {
            "currency": "PEN",
            "amount": 927412,
            "formatted": "927,412",
            "symbol": "S/"
          },
          {
            "currency": "USD",
            "amount": 269000,
            "formatted": "269,000",
            "symbol": "USD"
          }
        ],
        "expenses": {
          "currency": "PEN",
          "amount": 0,
          "symbol": "S/"
        },
        "property_type": "Departamentos",
        "property_type_id": 2,
        "is_project": false,
        "reserved": false,
        "premier": true,
        "bedrooms": 2,
        "bathrooms": 2,
        "half_bathrooms": 1,
        "age_years": 14,
        "parking": 2,
        "area_total": 132,
        "area_covered": 132,
        "features": [
          {
            "label": "Superficie total",
            "value": 132,
            "unit": "m²"
          },
          {
            "label": "Superficie techada",
            "value": 132,
            "unit": "m²"
          },
          {
            "label": "Dormitorios",
            "value": 2
          }
        ],
        "location": {
          "address": "Jose Gonzales al 400",
          "address_visibility": "EXACT",
          "latitude": -12.1286271,
          "longitude": -77.0300706,
          "hierarchy": [
            "…",
            "…",
            "…"
          ]
        },
        "images": [
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/50/00/26/43/720x532/1609280454.jpg?isFirstImage=true",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/50/00/26/43/360x266/1609280454.jpg?isFirstImage=true",
            "width": 1600,
            "height": 1200,
            "caption": "Departamento · 132m² · 2 Dormitorios · 2 Estacionamientos · Venta Departamento Moderno y Espacio con Balcón Grande en Miraflores"
          },
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/50/00/26/43/720x532/1609280444.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/50/00/26/43/360x266/1609280444.jpg",
            "width": 1600,
            "height": 1200,
            "caption": "Departamento de 2 habitaciones, Lima"
          },
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/50/00/26/43/720x532/1609280350.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/50/00/26/43/360x266/1609280350.jpg",
            "width": 1600,
            "height": 1200,
            "caption": "Departamento en Venta de 2 habitaciones Miraflores"
          }
        ],
        "extra_image_count": 15,
        "has_video": true,
        "has_tour": false,
        "has_plans": false,
        "modified_at": "2026-11-12T08:28:40-0500",
        "publisher": {
          "id": 51333152,
          "name": "LARRIEU BELLIDO YVONNE MARIE CLAIRE",
          "url": "https://urbania.pe/inmobiliarias/larrieu-bellido-yvonne-marie-claire_51333152-inmuebles.html",
          "logo": "https://img10.naventcdn.com/empresas/111/00/51/33/31/52/130x70/logo_larrieu-bellido-yvonne-marie-claire_1731008455163.jpg",
          "premier": true,
          "member_since": "2022-09-05T04:00:00.000+00:00"
        },
        "whatsapp": "51 987771568"
      },
      {
        "id": 151596905,
        "code": "LAP13791837",
        "url": "https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-san-antonio-miraflores-2-dormitorios-151596905",
        "title": "Venta Flat Moderno E Iluminado en 28 de Julio, Miraflores",
        "summary": "Departamento · 114m² · 2 Dormitorios · 2 Estacionamientos",
        "description": "114 m² | 2 dormitorios + family room | 2. 5 baños | Piso 5 | 1. 5 años de antigüedad | Estacionamiento dobleCaracterísticas del departamento: - 114 m² en el piso 5, con excelente iluminación natural. - 2 dormitorios + family room, ideal com…",
        "operation": "sale",
        "prices": [
          {
            "currency": "PEN",
            "amount": 920160,
            "formatted": "920,160",
            "symbol": "S/"
          },
          {
            "currency": "USD",
            "amount": 270000,
            "formatted": "270,000",
            "symbol": "USD"
          }
        ],
        "expenses": {
          "currency": "PEN",
          "amount": 700,
          "formatted": "700",
          "symbol": "S/"
        },
        "property_type": "Departamentos",
        "property_type_id": 2,
        "is_project": false,
        "reserved": false,
        "premier": true,
        "bedrooms": 2,
        "bathrooms": 2,
        "half_bathrooms": 1,
        "age_years": 1,
        "parking": 2,
        "area_total": 114,
        "area_covered": 114,
        "features": [
          {
            "label": "Superficie total",
            "value": 114,
            "unit": "m²"
          },
          {
            "label": "Superficie techada",
            "value": 114,
            "unit": "m²"
          },
          {
            "label": "Dormitorios",
            "value": 2
          }
        ],
        "location": {
          "address": "28 de Julio 1365, Miraflores | Cerca a Parque Reducto",
          "address_visibility": "EXACT",
          "latitude": -12.130301,
          "longitude": -77.01937029999999,
          "hierarchy": [
            "…",
            "…",
            "…"
          ]
        },
        "images": [
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/51/59/69/05/720x532/1642565666.jpg?isFirstImage=true",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/51/59/69/05/360x266/1642565666.jpg?isFirstImage=true",
            "width": 1448,
            "height": 1086,
            "caption": "Departamento · 114m² · 2 Dormitorios · 2 Estacionamientos · Venta Flat Moderno E Iluminado en 28 de Julio, Miraflores"
          },
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/51/59/69/05/720x532/1642565659.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/51/59/69/05/360x266/1642565659.jpg",
            "width": 1448,
            "height": 1086,
            "caption": "Departamento de 2 habitaciones, Lima"
          },
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/51/59/69/05/720x532/1642565658.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/51/59/69/05/360x266/1642565658.jpg",
            "width": 1448,
            "height": 1086,
            "caption": "Departamento en Venta de 2 habitaciones Miraflores"
          }
        ],
        "extra_image_count": 23,
        "has_video": true,
        "has_tour": false,
        "has_plans": false,
        "modified_at": "2026-11-11T00:00:00-0500",
        "publisher": {
          "id": 1644876,
          "name": "LIÉN Boutique Inmobiliaria",
          "url": "https://urbania.pe/inmobiliarias/lien-boutique-inmobiliaria_1644876-inmuebles.html",
          "logo": "https://img10.naventcdn.com/empresas/111/00/01/64/48/76/130x70/logo_lien-boutique-inmobiliaria_1752091080025.jpg",
          "type": "agency",
          "premier": true,
          "member_since": "2019-01-09T05:00:00.000+00:00"
        },
        "whatsapp": "51 904095372"
      },
      {
        "id": 151143279,
        "code": "MIRDVINB322::URB-M-150694577",
        "url": "https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-miraflores-lima-2-dormitorios-151143279",
        "title": "Departamento Dúplex de 108 m² con 2 Dorm. en Venta en Miraflores",
        "summary": "Departamento · 81m² · 2 Dormitorios",
        "description": "Duplex Penthouse a 2 cuadras del Malecón | Calle Roma, Mirafloressólo compradores exigentes: Abstenerse quienes buscan proyectos en plano o acabados genéricos de obra rápida. Esto es solo para quienes exigen entrega inmediata y buscan verda…",
        "operation": "sale",
        "prices": [
          {
            "currency": "PEN",
            "amount": 850000,
            "formatted": "850,000",
            "symbol": "S/"
          },
          {
            "currency": "USD",
            "amount": 253000,
            "formatted": "253,000",
            "symbol": "USD"
          }
        ],
        "expenses": {
          "currency": "PEN",
          "amount": 300,
          "formatted": "300",
          "symbol": "S/"
        },
        "property_type": "Departamentos",
        "property_type_id": 2,
        "is_project": false,
        "reserved": false,
        "premier": true,
        "bedrooms": 2,
        "bathrooms": 2,
        "age_years": 1,
        "area_total": 108,
        "area_covered": 81,
        "features": [
          {
            "label": "Superficie total",
            "value": 108,
            "unit": "m²"
          },
          {
            "label": "Superficie techada",
            "value": 81,
            "unit": "m²"
          },
          {
            "label": "Dormitorios",
            "value": 2
          }
        ],
        "location": {
          "address": "Calle Roma 250",
          "address_visibility": "EXACT",
          "latitude": -12.1222712,
          "longitude": -77.037986,
          "hierarchy": [
            "…",
            "…",
            "…"
          ]
        },
        "images": [
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/51/14/32/79/720x532/1632588403.jpg?isFirstImage=true",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/51/14/32/79/360x266/1632588403.jpg?isFirstImage=true",
            "width": 1200,
            "height": 900,
            "caption": "Departamento · 81m² · 2 Dormitorios · Departamento Dúplex de 108 m² con 2 Dorm. en Venta en Miraflores"
          },
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/51/14/32/79/720x532/1632588366.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/51/14/32/79/360x266/1632588366.jpg",
            "width": 1200,
            "height": 900,
            "caption": "Departamento de 2 habitaciones, Lima"
          },
          {
            "url": "https://img10.naventcdn.com/avisos/111/01/51/14/32/79/720x532/1632588309.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/111/01/51/14/32/79/360x266/1632588309.jpg",
            "width": 1200,
            "height": 900,
            "caption": "Departamento en Venta de 2 habitaciones Miraflores"
          }
        ],
        "extra_image_count": 3,
        "has_video": false,
        "has_tour": false,
        "has_plans": false,
        "modified_at": "2026-11-12T08:28:40-0500",
        "publisher": {
          "id": 102509958,
          "name": "INBRUCK BROKERS INMOBILIARIOS",
          "url": "https://urbania.pe/inmobiliarias/inbruck-brokers-inmobiliarios_102509958-inmuebles.html",
          "logo": "https://img10.naventcdn.com/empresas/111/01/02/50/99/58/130x70/logo_inbruck-brokers-inmobiliarios_1792075786269.jpg",
          "type": "agency",
          "premier": true,
          "member_since": "2024-01-24T05:00:00.000+00:00"
        },
        "whatsapp": "51 924119712"
      }
    ],
    "page": 1,
    "per_page": 30,
    "total": 1400,
    "total_pages": 47,
    "has_more": true,
    "excluded": {
      "projects": 15,
      "price_mismatch": 0
    },
    "title": "1,400 Departamentos con más de 2 dormitorios de USD 200,000 a USD 400,000 en venta en Miraflores, Lima",
    "applied_filters": [
      {
        "type": "location",
        "label": "Miraflores"
      },
      {
        "type": "operationType",
        "label": "Comprar"
      },
      {
        "type": "realestateType",
        "label": "Departamento"
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_0901433c65ea4471b251acc99426a385",
    "credits_charged": 1,
    "credits_remaining": 1805
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegercodestringurlurltitlestringsummarystringdescriptionstringoperationstringpricesobject[]expensesobjectproperty_typestringproperty_type_idintegeris_projectbooleanreservedbooleanpremierbooleanbedroomsintegerbathroomsintegerhalf_bathroomsnumberage_yearsintegerparkingnumberarea_totalintegerarea_coveredintegerfeaturesobject[]locationobjectimagesobject[]extra_image_countintegerhas_videobooleanhas_tourbooleanhas_plansbooleanmodified_atstringpublisherobjectwhatsappstring
1150002643YAP7937759https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-miraflores-lima-2-dormitorios-150002643Venta Departamento Moderno y Espacio con Balcón Grande en MirafloresDepartamento · 132m² · 2 Dormitorios · 2 EstacionamientosVenta departamento moderno Y espacio con balcón grande en mirafloresexperimenta el estilo de vida definitivo de Miraflores en este elegante y moderno Flat de 2 dormitorios en la Calle José González. Con una ubicación perfecta entre el malec…sale[2 items]{3 fields}Departamentos2falsefalsetrue221142132132[3 items]{5 fields}[3 items]15truefalsefalse2026-11-12T08:28:40-0500{6 fields}51 987771568
2151596905LAP13791837https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-san-antonio-miraflores-2-dormitorios-151596905Venta Flat Moderno E Iluminado en 28 de Julio, MirafloresDepartamento · 114m² · 2 Dormitorios · 2 Estacionamientos114 m² | 2 dormitorios + family room | 2. 5 baños | Piso 5 | 1. 5 años de antigüedad | Estacionamiento dobleCaracterísticas del departamento: - 114 m² en el piso 5, con excelente iluminación natural. - 2 dormitorios + family room, ideal com…sale[2 items]{4 fields}Departamentos2falsefalsetrue22112114114[3 items]{5 fields}[3 items]23truefalsefalse2026-11-11T00:00:00-0500{7 fields}51 904095372
3151143279MIRDVINB322::URB-M-150694577https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-miraflores-lima-2-dormitorios-151143279Departamento Dúplex de 108 m² con 2 Dorm. en Venta en MirafloresDepartamento · 81m² · 2 DormitoriosDuplex Penthouse a 2 cuadras del Malecón | Calle Roma, Mirafloressólo compradores exigentes: Abstenerse quienes buscan proyectos en plano o acabados genéricos de obra rápida. Esto es solo para quienes exigen entrega inmediata y buscan verda…sale[2 items]{4 fields}Departamentos2falsefalsetrue22—1—10881[3 items]{5 fields}[3 items]3falsefalsefalse2026-11-12T08:28:40-0500{7 fields}51 924119712

Recorded from our API · 3 items shown · 31 datapoints per itemGET /v1/urbania/search?operation=sale&property_type=apartment&location=miraflores--lima--lima&price_min=200000&price_max=400000&currency=USD&bedrooms_min=2&exclude_projects=true

31 datapoints

Identity

  • idinteger
  • titlestring
  • property_typestring
  • property_type_idinteger

Contact

  • urlurl

Location

  • area_totalinteger
  • area_coveredinteger
  • locationobject

Reputation

  • imagesobject[]
  • extra_image_countinteger

Price

  • pricesobject[]

Other

  • codestring
  • summarystring
  • descriptionstring
  • operationstring
  • expensesobject
  • is_projectboolean
  • reservedboolean
  • premierboolean
  • bedroomsinteger
  • bathroomsinteger
  • half_bathroomsnumber
  • age_yearsinteger
  • parkingnumber
  • featuresobject[]
  • has_videoboolean
  • has_tourboolean
  • has_plansboolean
  • modified_atstring
  • publisherobject
  • whatsappstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/urbania/search?operation=sale&property_type=apartment&location=miraflores--lima--lima&price_min=200000&price_max=400000&currency=USD&bedrooms_min=2&exclude_projects=true" \
  -H "X-API-Key: $API_KEY"

Urbania · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/urbania/agency
id+2 optional
1 credit
GET/v1/urbania/autocomplete
q+1 optional
1 credit
GET/v1/urbania/listing
none+2 optional
1 credit
GET/v1/urbania/search
none+14 optional
1 credit

Overview

What you can get

The Urbania API returns Urbania property data as JSON through 4 endpoints.

  • Search: search takes operation (sale, rent or temporary), property_type (all, apartment, house, land, office or commercial), location, price_min, price_max, currency (PEN or USD), bedrooms_min, bedrooms_max, bathrooms_min, area_min, area_max, sort (relevance, price_asc, price_desc, newest, most_viewed or price_drop), exclude_projects and page.
  • Listings: listing takes a url or an id.
  • Agencies: agency takes an id, with slug and page.
  • Autocomplete: autocomplete takes a q, with limit.

The recorded search for apartments for sale in Miraflores, Lima (location=miraflores--lima--lima) between USD 200,000 and 400,000 with bedrooms_min=2 and exclude_projects=true returns a total of 1,400, with per_page (30), total_pages, has_more, and excluded with the number of projects left out. Each item in items carries id, code, url, title, summary, operation, prices, expenses, property_type, is_project, bedrooms, bathrooms, half_bathrooms, age_years, parking, area_total, area_covered, features, location, images, modified_at, publisher and whatsapp.

How a call works

Search a district: GET /v1/urbania/search?operation=sale&property_type=apartment&location=miraflores--lima--lima&price_min=200000&price_max=400000&currency=USD&bedrooms_min=2&exclude_projects=true with your key in the X-API-Key header. Each item's url is what listing takes. Check has_more before asking for the next page. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices for apartments by district in Lima

Use the Urbania API to track asking prices for apartments by district in Lima

Watch price drops with `sort=price_drop`

Use the Urbania API to watch price drops with `sort=price_drop`

Separate resale homes from new projects with `exclude_projects`

Use the Urbania API to separate resale homes from new projects with `exclude_projects`

Compare monthly `expenses` across buildings

Use the Urbania API to compare monthly `expenses` across buildings

FAQ

Questions

Do I need an Urbania account?

No. You call this Urbania API with your Perceptlayer key in the `X-API-Key` header, with no Urbania login.

How much does the Urbania API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Are prices in soles or dollars?

Set `currency` to PEN or USD for the price filters. Each item's `prices` lists every price it has, each with `currency`, `amount` and `formatted`.

Should I build an Urbania scraper instead?

You can, but an Urbania scraper is code you maintain: page changes break it, requests get blocked, and Urbania's terms govern how you collect data. The Urbania API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Urbania API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs