Urbania: Search
Search from Urbania as JSON. 1 credit per successful call.
GET /v1/urbania/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
operation | string | Optional | sale, rent, temporary |
property_type | string | Optional | all, apartment, house, land, office, commercial |
location | string | Optional | Up to 200 characters |
price_min | integer | Optional | Any |
price_max | integer | Optional | Any |
currency | string | Optional | PEN, USD |
bedrooms_min | integer | Optional | Any |
bedrooms_max | integer | Optional | Any |
bathrooms_min | integer | Optional | Any |
area_min | integer | Optional | Any |
area_max | integer | Optional | Any |
sort | string | Optional | relevance, price_asc, price_desc, newest, most_viewed, price_drop |
exclude_projects | boolean | Optional | Any |
page | integer | Optional | Any |
Example request
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 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.