--- title: "Adondevivir API: JSON data, 4 endpoints, 1 credit per call" description: "Adondevivir API for Peruvian homes for sale or rent, listing details, real estate agencies and location lookup as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/adondevivir --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Adondevivir 1 credit per call 4 endpoints 22 datapoints # Adondevivir API Adondevivir API for Peruvian homes for sale or rent, listing details, real estate agencies and location lookup as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Adondevivir GET /v1/adondevivir/search?operation=sale&type=apartment&location=V1-D-119497&min\_bedrooms=2&sort=low\_price&page=2 ``` { "success": true, "data": { "listings": [ { "id": "151355338", "posting_code": "PEPEAL", "title": "Remato Depa en Miraflores", "subtitle": "Departamento · 96m² · 2 Dormitorios · 1 Estacionamiento", "url": "https://www.adondevivir.com/propiedades/clasificado/veclapin-remato-depa-en-miraflores-151355338.html", "posting_type": "PROPERTY", "description": "Importante: venta por acciones Y derechos. solo con recursos propios - no crédito hipotecarios. Departamento de 96m² totalmente remodelado, a dos cuadras del Hotel Hilton y cerca de Larcomar. Ubicado en piso 12, Luminosa y espaciosa sala pe…", "property_type": { "id": "2", "name": "Departamentos" }, "operation": { "id": "1", "name": "Venta" }, "prices": [ { "amount": 499150, "formatted_amount": "499,150", "currency": "S/", "iso_code": "PEN" }, { "amount": 149000, "formatted_amount": "149,000", "currency": "USD", "iso_code": "USD" } ], "features": { "land_area_m2": 96, "built_area_m2": 96, "bedrooms": 2, "bathrooms": 3, "parking": 1, "age": 32 }, "address": "Calle Alcanfores ", "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" ] }, "publisher": { "id": "102229497", "name": "SOCIOS INMOBILIARIOS", "url": "https://www.adondevivir.com/inmobiliarias/socios-inmobiliarios_102229497-inmuebles.html", "logo": "https://img10.naventcdn.com/css/img/placeholder-img.png", "type_id": "4", "is_premier": false }, "images": [ { "url": "https://img10.naventcdn.com/avisos/111/01/51/35/47/52/720x532/1637291425.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true" }, { "url": "https://img10.naventcdn.com/avisos/111/01/51/35/47/52/720x532/1637291419.jpg?rapc=bXZhX2ltYWdl" }, { "url": "https://img10.naventcdn.com/avisos/111/01/51/35/47/52/720x532/1637291413.jpg?rapc=bXZhX2ltYWdl" } ], "has_videos": true, "has_tour": false, "modified_at": "2026-10-27T00:00:00-0400", "is_premier": false, "status": "ONLINE", "expenses": { "amount": 420, "formatted_amount": "420", "currency": "S/" }, "is_development": false }, { "id": "143515933", "posting_code": "LRPR0031", "title": "Vendo Departamentos de 1,2 y 3 Dorm. en Miraflores", "subtitle": "Departamento · 54m² · 2 Dormitorios · 1 Estacionamiento", "url": "https://www.adondevivir.com/propiedades/clasificado/veclapin-vendo-departamentos-de-1-2-y-3-dorm.-en-miraflores-143515933.html", "posting_type": "PROPERTY", "description": "(Cod. lrpr0031) Fecha de entrega: Febrero 2027. Lindo departamento que estará ubicado en Federico Villarreal, entre las avenidas General Mendiburu y Mariscal La Mar - Miraflores, cerca a parques, restaurantes, vía principal( Avenida El Ejer…", "property_type": { "id": "2", "name": "Departamentos" }, "operation": { "id": "1", "name": "Venta" }, "prices": [ { "amount": 512000, "formatted_amount": "512,000", "currency": "S/", "iso_code": "PEN" } ], "features": { "land_area_m2": 54, "built_area_m2": 54, "bedrooms": 2, "bathrooms": 2, "parking": 1 }, "coordinates": { "lat": -12.112104791386361, "lon": -77.04756978240049 }, "address": "Federico Villarreal", "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" ] }, "publisher": { "id": "50025641", "name": "LYRA PROPIEDADES", "url": "https://www.adondevivir.com/inmobiliarias/lyra-propiedades_50025641-inmuebles.html", "logo": "https://img10.naventcdn.com/empresas/111/00/04/06/27/12/130x70/logo_lyra-inmobiliaria_1707777471995.jpg", "type_id": "2", "is_premier": true }, "images": [ { "url": "https://img10.naventcdn.com/avisos/111/01/43/51/49/42/720x532/1460956350.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true" }, { "url": "https://img10.naventcdn.com/avisos/111/01/43/51/49/42/720x532/1460956353.jpg?rapc=bXZhX2ltYWdl" }, { "url": "https://img10.naventcdn.com/avisos/111/01/43/51/49/42/720x532/1460956348.jpg?rapc=bXZhX2ltYWdl" } ], "has_videos": false, "has_tour": false, "modified_at": "2026-11-11T00:00:00-0500", "is_premier": true, "status": "ONLINE", "is_development": false }, { "id": "151555099", "posting_code": "GR 54", "title": "En Venta Departamento de Estreno de 38 m² en Miraflores", "subtitle": "Departamento · 38m² · 2 Dormitorios", "url": "https://www.adondevivir.com/propiedades/clasificado/veclapin-en-venta-departamento-de-estreno-de-38-m-sup2--en-151555099.html", "posting_type": "PROPERTY", "description": "Tu mejor inversión en miraflores. Loft ideal para Airbnb? Se vende departamento de 37. 5 m2 con excelentes áreas comunes. Incluye campana, encimera y horno. Precio: usd 149, 000. no paga alcabala. —- Ubicado a 5 cuadras de Larcomar y 3 cuad…", "property_type": { "id": "2", "name": "Departamentos" }, "operation": { "id": "1", "name": "Venta" }, "prices": [ { "amount": 513000, "formatted_amount": "513,000", "currency": "S/", "iso_code": "PEN" }, { "amount": 149000, "formatted_amount": "149,000", "currency": "USD", "iso_code": "USD" } ], "features": { "land_area_m2": 38, "built_area_m2": 38, "bedrooms": 2, "bathrooms": 2 }, "coordinates": { "lat": -12.118791928599364, "lon": -77.03860980213013 }, "address": "José Pardo Miraflores", "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" ] }, "publisher": { "id": "102573095", "name": "SOLO INMOBILIARIOS", "url": "https://www.adondevivir.com/inmobiliarias/solo-inmobiliarios_102573095-inmuebles.html", "logo": "https://img10.naventcdn.com/empresas/111/01/02/57/30/93/130x70/logo_solo-inmobiliarios_1768484061641.jpg", "type_id": "4", "is_premier": false }, "images": [ { "url": "https://img10.naventcdn.com/avisos/111/01/51/55/50/80/720x532/1641670015.jpg?rapc=bXZhX2ltYWdl?isFirstImage=true" }, { "url": "https://img10.naventcdn.com/avisos/111/01/51/55/50/80/720x532/1641670035.jpg?rapc=bXZhX2ltYWdl" }, { "url": "https://img10.naventcdn.com/avisos/111/01/51/55/50/80/720x532/1641670006.jpg?rapc=bXZhX2ltYWdl" } ], "has_videos": false, "has_tour": false, "modified_at": "2026-11-08T00:00:00-0500", "is_premier": false, "status": "ONLINE", "is_development": false } ], "total": 2228, "current_page": 2, "total_pages": 75, "per_page": 30, "page_out_of_range": false, "filtered_out": 1, "applied_filters": { "operation": "sale", "type": "apartment", "location": "V1-D-119497", "min_bedrooms": "2", "sort": "low_price", "page": 2 } }, "meta": { "endpoint_family": "search", "request_id": "req_4e5a89dca27c496f95171741612ffd3b", "credits_charged": 1, "credits_remaining": 1896 } } ``` 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 string | posting\_code string | title string | subtitle string | url url | posting\_type string | description string | property\_type object | operation object | prices object\[\] | features object | address string | location object | publisher object | images object\[\] | has\_videos boolean | has\_tour boolean | modified\_at string | is\_premier boolean | status string | expenses object | is\_development boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 151355338 | PEPEAL | Remato Depa en Miraflores | Departamento · 96m² · 2 Dormitorios · 1 Estacionamiento | https://www.adondevivir.com/propiedades/clasificado/veclapin-remato-depa-en-miraflores-151355338.html | PROPERTY | Importante: venta por acciones Y derechos. solo con recursos propios - no crédito hipotecarios. Departamento de 96m² totalmente remodelado, a dos cuadras del Hotel Hilton y cerca de Larcomar. Ubicado en piso 12, Luminosa y espaciosa sala pe… | {2 fields} | {2 fields} | \[2 items\] | {6 fields} | Calle Alcanfores | {5 fields} | {6 fields} | \[3 items\] | true | false | 2026-10-27T00:00:00-0400 | false | ONLINE | {3 fields} | false | | 2 | 143515933 | LRPR0031 | Vendo Departamentos de 1,2 y 3 Dorm. en Miraflores | Departamento · 54m² · 2 Dormitorios · 1 Estacionamiento | https://www.adondevivir.com/propiedades/clasificado/veclapin-vendo-departamentos-de-1-2-y-3-dorm.-en-miraflores-143515933.html | PROPERTY | (Cod. lrpr0031) Fecha de entrega: Febrero 2027. Lindo departamento que estará ubicado en Federico Villarreal, entre las avenidas General Mendiburu y Mariscal La Mar - Miraflores, cerca a parques, restaurantes, vía principal( Avenida El Ejer… | {2 fields} | {2 fields} | \[1 item\] | {5 fields} | Federico Villarreal | {5 fields} | {6 fields} | \[3 items\] | false | false | 2026-11-11T00:00:00-0500 | true | ONLINE | — | false | | 3 | 151555099 | GR 54 | En Venta Departamento de Estreno de 38 m² en Miraflores | Departamento · 38m² · 2 Dormitorios | https://www.adondevivir.com/propiedades/clasificado/veclapin-en-venta-departamento-de-estreno-de-38-m-sup2--en-151555099.html | PROPERTY | Tu mejor inversión en miraflores. Loft ideal para Airbnb? Se vende departamento de 37. 5 m2 con excelentes áreas comunes. Incluye campana, encimera y horno. Precio: usd 149, 000. no paga alcabala. —- Ubicado a 5 cuadras de Larcomar y 3 cuad… | {2 fields} | {2 fields} | \[2 items\] | {4 fields} | José Pardo Miraflores | {5 fields} | {6 fields} | \[3 items\] | false | false | 2026-11-08T00:00:00-0500 | false | ONLINE | — | false | Recorded from our API · 3 items shown · 22 datapoints per item GET /v1/adondevivir/search?operation=sale&type=apartment&location=V1-D-119497&min\_bedrooms=2&sort=low\_price&page=2 22 datapoints ### Identity - id string - title string - subtitle string - posting\_type string - property\_type object - status string ### Contact - url url ### Location - address string - location object ### Reputation - images object\[\] ### Price - prices object\[\] ### Other - posting\_code string - description string - operation object - features object - publisher object - has\_videos boolean - has\_tour boolean - modified\_at string - is\_premier boolean - expenses object - is\_development boolean Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/adondevivir/search?operation=sale&type=apartment&location=V1-D-119497&min_bedrooms=2&sort=low_price&page=2" \ -H "X-API-Key: $API_KEY" ``` Adondevivir · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/adondevivir/agency`](https://perceptlayer.com/apis/adondevivir/agency) | none +3 optional | 1 credit | | [GET `/v1/adondevivir/listing`](https://perceptlayer.com/apis/adondevivir/listing) | none +2 optional | 1 credit | | [GET `/v1/adondevivir/locations`](https://perceptlayer.com/apis/adondevivir/locations) | `query` +1 optional | 1 credit | | [GET `/v1/adondevivir/search`](https://perceptlayer.com/apis/adondevivir/search) | none +16 optional | 1 credit | Overview ## About the Adondevivir API ## What you can get The Adondevivir API returns Adondevivir property data for Peru as JSON through 4 endpoints. - **Search:** `search` takes an `operation` (sale, rent, transfer or temporary), `type`, `location`, `min_price`, `max_price`, `currency` (USD or PEN), `min_bedrooms`, `max_bedrooms`, `min_bathrooms`, `min_garages`, `min_area`, `max_area`, `q`, `address`, `sort` (relevance, low\_price, high\_price, more\_recent, most\_visit or most\_lowered\_price) and `page`. - **Listings:** `listing` takes an `id` or a `url`. - **Agencies:** `agency` takes an `id` or a `url`, with `page`. - **Locations:** `locations` takes a `query`, with `limit`. The recorded `search` ( `operation=sale`, `type=apartment`, `location=V1-D-119497`, `min_bedrooms=2`, `sort=low_price`, `page=2`) returns `listings`, each with `id`, `posting_code`, `title`, `url`, `property_type`, `operation`, `prices` (in PEN and USD), `features` ( `built_area_m2`, `bedrooms`, `bathrooms`, `parking`, `age`), `expenses`, `address`, `location`, `publisher`, `images`, `has_videos`, `has_tour` and `modified_at`. It also returns `total` (2,228), `current_page`, `total_pages`, `per_page` and `applied_filters`. ## How a call works Search apartments for sale in Miraflores: `GET /v1/adondevivir/search?operation=sale&type=apartment&location=V1-D-119497&min_bedrooms=2&sort=low_price&page=2` with your key in the `X-API-Key` header. Find a `location` ID such as V1-D-119497 with `locations`. Each listing's `id` goes to `listing`, and its `publisher.id` goes to `agency`. 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) [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) [Batdongsan.com.vn](https://perceptlayer.com/apis/batdongsan) Use cases ### Track apartment prices in Lima districts such as Miraflores, in soles and US dollars `Use the Adondevivir API to track apartment prices in Lima districts such as Miraflores, in soles and US dollars` ### Compare asking prices per square metre of built area across districts `Use the Adondevivir API to compare asking prices per square metre of built area across districts` ### Watch listings whose price has dropped with \`sort=most\_lowered\_price\` `` Use the Adondevivir API to watch listings whose price has dropped with `sort=most_lowered_price` `` ### Look up the agency behind a listing with \`agency\` `` Use the Adondevivir API to look up the agency behind a listing with `agency` `` FAQ ## Questions **Do I need an Adondevivir account?** No. You call this Adondevivir API with your Perceptlayer key in the \`X-API-Key\` header, with no Adondevivir login. **How much does the Adondevivir 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?** Listings carry \`prices\` with an \`iso\_code\` for each currency; the recorded search returns both PEN and USD. \`search\` also takes a \`currency\` of USD or PEN. **Should I build an Adondevivir scraper instead?** You can, but an Adondevivir scraper is code you maintain: page changes break it, requests get blocked, and Adondevivir's terms govern how you collect data. The Adondevivir 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 Adondevivir 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)