--- title: "Urbania API: JSON data, 4 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/urbania --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Urbania 1 credit per call 4 endpoints 31 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 key](https://perceptlayer.com/signup) Run it below Urbania GET /v1/urbania/search?operation=sale&property\_type=apartment&location=miraflores--lima--lima&price\_min=200000&price\_max=400000¤cy=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 OK JSON X-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. | # | id integer | code string | url url | title string | summary string | description string | operation string | prices object\[\] | expenses object | property\_type string | property\_type\_id integer | is\_project boolean | reserved boolean | premier boolean | bedrooms integer | bathrooms integer | half\_bathrooms number | age\_years integer | parking number | area\_total integer | area\_covered integer | features object\[\] | location object | images object\[\] | extra\_image\_count integer | has\_video boolean | has\_tour boolean | has\_plans boolean | modified\_at string | publisher object | whatsapp string | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 150002643 | YAP7937759 | https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-miraflores-lima-2-dormitorios-150002643 | Venta Departamento Moderno y Espacio con Balcón Grande en Miraflores | Departamento · 132m² · 2 Dormitorios · 2 Estacionamientos | 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… | sale | \[2 items\] | {3 fields} | Departamentos | 2 | false | false | true | 2 | 2 | 1 | 14 | 2 | 132 | 132 | \[3 items\] | {5 fields} | \[3 items\] | 15 | true | false | false | 2026-11-12T08:28:40-0500 | {6 fields} | 51 987771568 | | 2 | 151596905 | LAP13791837 | https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-san-antonio-miraflores-2-dormitorios-151596905 | Venta Flat Moderno E Iluminado en 28 de Julio, Miraflores | Departamento · 114m² · 2 Dormitorios · 2 Estacionamientos | 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… | sale | \[2 items\] | {4 fields} | Departamentos | 2 | false | false | true | 2 | 2 | 1 | 1 | 2 | 114 | 114 | \[3 items\] | {5 fields} | \[3 items\] | 23 | true | false | false | 2026-11-11T00:00:00-0500 | {7 fields} | 51 904095372 | | 3 | 151143279 | MIRDVINB322::URB-M-150694577 | https://urbania.pe/inmueble/clasificado/veclapin-venta-de-departamento-en-miraflores-lima-2-dormitorios-151143279 | Departamento Dúplex de 108 m² con 2 Dorm. en Venta en Miraflores | Departamento · 81m² · 2 Dormitorios | 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… | sale | \[2 items\] | {4 fields} | Departamentos | 2 | false | false | true | 2 | 2 | — | 1 | — | 108 | 81 | \[3 items\] | {5 fields} | \[3 items\] | 3 | false | false | false | 2026-11-12T08:28:40-0500 | {7 fields} | 51 924119712 | Recorded from our API · 3 items shown · 31 datapoints per item GET /v1/urbania/search?operation=sale&property\_type=apartment&location=miraflores--lima--lima&price\_min=200000&price\_max=400000¤cy=USD&bedrooms\_min=2&exclude\_projects=true 31 datapoints ### Identity - id integer - title string - property\_type string - property\_type\_id integer ### Contact - url url ### Location - area\_total integer - area\_covered integer - location object ### Reputation - images object\[\] - extra\_image\_count integer ### Price - prices object\[\] ### Other - code string - summary string - description string - operation string - expenses object - is\_project boolean - reserved boolean - premier boolean - bedrooms integer - bathrooms integer - half\_bathrooms number - age\_years integer - parking number - features object\[\] - has\_video boolean - has\_tour boolean - has\_plans boolean - modified\_at string - publisher object - whatsapp string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/urbania/search?operation=sale&property_type=apartment&location=miraflores--lima--lima&price_min=200000&price_max=400000¤cy=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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/urbania/agency`](https://perceptlayer.com/apis/urbania/agency) | `id` +2 optional | 1 credit | | [GET `/v1/urbania/autocomplete`](https://perceptlayer.com/apis/urbania/autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/urbania/listing`](https://perceptlayer.com/apis/urbania/listing) | none +2 optional | 1 credit | | [GET `/v1/urbania/search`](https://perceptlayer.com/apis/urbania/search) | none +14 optional | 1 credit | Overview ## About the Urbania API ## 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¤cy=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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)