Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Adondevivir

1 credit per call4 endpoints22 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 keyRun 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 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.

#idstringposting_codestringtitlestringsubtitlestringurlurlposting_typestringdescriptionstringproperty_typeobjectoperationobjectpricesobject[]featuresobjectaddressstringlocationobjectpublisherobjectimagesobject[]has_videosbooleanhas_tourbooleanmodified_atstringis_premierbooleanstatusstringexpensesobjectis_developmentboolean
1151355338PEPEALRemato Depa en MirafloresDepartamento · 96m² · 2 Dormitorios · 1 Estacionamientohttps://www.adondevivir.com/propiedades/clasificado/veclapin-remato-depa-en-miraflores-151355338.htmlPROPERTYImportante: 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]truefalse2026-10-27T00:00:00-0400falseONLINE{3 fields}false
2143515933LRPR0031Vendo Departamentos de 1,2 y 3 Dorm. en MirafloresDepartamento · 54m² · 2 Dormitorios · 1 Estacionamientohttps://www.adondevivir.com/propiedades/clasificado/veclapin-vendo-departamentos-de-1-2-y-3-dorm.-en-miraflores-143515933.htmlPROPERTY(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]falsefalse2026-11-11T00:00:00-0500trueONLINE—false
3151555099GR 54En Venta Departamento de Estreno de 38 m² en MirafloresDepartamento · 38m² · 2 Dormitorioshttps://www.adondevivir.com/propiedades/clasificado/veclapin-en-venta-departamento-de-estreno-de-38-m-sup2--en-151555099.htmlPROPERTYTu 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]falsefalse2026-11-08T00:00:00-0500falseONLINE—false

Recorded from our API · 3 items shown · 22 datapoints per itemGET /v1/adondevivir/search?operation=sale&type=apartment&location=V1-D-119497&min_bedrooms=2&sort=low_price&page=2

22 datapoints

Identity

  • idstring
  • titlestring
  • subtitlestring
  • posting_typestring
  • property_typeobject
  • statusstring

Contact

  • urlurl

Location

  • addressstring
  • locationobject

Reputation

  • imagesobject[]

Price

  • pricesobject[]

Other

  • posting_codestring
  • descriptionstring
  • operationobject
  • featuresobject
  • publisherobject
  • has_videosboolean
  • has_tourboolean
  • modified_atstring
  • is_premierboolean
  • expensesobject
  • is_developmentboolean

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/adondevivir/agency
none+3 optional
1 credit
GET/v1/adondevivir/listing
none+2 optional
1 credit
GET/v1/adondevivir/locations
query+1 optional
1 credit
GET/v1/adondevivir/search
none+16 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresApartment ListApartments.comAqarAqarmapArgenpropathomeBatdongsan.com.vn

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 keyRead the docs