APIs / Real estate / Plusvalía

1 credit per call4 endpoints24 datapoints

Plusvalía API

Plusvalía API for Ecuador property for sale, rent or transfer, listings, agencies and location lookup as JSON. Four endpoints, 1 credit per successful call.

Plusvalía
GET/v1/plusvalia/search?operation=sale&type=apartment&location=V1-C-1&min_bedrooms=3&sort=low_price&page=2
{
  "success": true,
  "data": {
    "listings": [
      {
        "id": "151197868",
        "posting_code": "66JRIS",
        "title": "Vendo Departamento Marianitas de Calderon",
        "subtitle": "Departamento · 86m² · 3 Habitaciones · 1 Estacionamiento",
        "url": "https://www.plusvalia.com/propiedades/clasificado/veclapin-vendo-departamento-marianitas-de-calderon-151197868.html",
        "posting_type": "PROPERTY",
        "description": "El departamento tiene 86 metros de construcción, 14 años de construcción y está en el segundo piso. Tiene 3 dormitorios, dos baños completos, sala, comedor, cocina con área de máquinas, un parqueadero y secadero. Esta dentro de un condomini…",
        "property_type": {
          "id": "2",
          "name": "Departamentos"
        },
        "operation": {
          "id": "1",
          "name": "Venta"
        },
        "prices": [
          {
            "amount": 45000,
            "formatted_amount": "45.000",
            "currency": "USD",
            "iso_code": "USD"
          }
        ],
        "features": {
          "land_area_m2": 118,
          "built_area_m2": 86,
          "bedrooms": 3,
          "bathrooms": 3,
          "parking": 1,
          "age": 14
        },
        "address": "Progreso",
        "location": {
          "zone": {
            "id": "V1-D-17",
            "name": "Calderón"
          },
          "city": {
            "id": "V1-C-1",
            "name": "Quito"
          },
          "state": {
            "id": "V1-B-629",
            "name": "Pichincha"
          },
          "country": {
            "id": "V1-A-9",
            "name": "Ecuador"
          },
          "location_ids": [
            "V1-D-17",
            "V1-C-1",
            "V1-B-629"
          ]
        },
        "publisher": {
          "id": "50161142",
          "name": "Maria Dolores  Toledo Dominguez",
          "url": "https://www.plusvalia.com/inmobiliarias/maria-dolores-toledo-dominguez_50161142-inmuebles.html",
          "logo": "https://img10.naventcdn.com/empresas/9/00/50/16/11/42/130x70/logo_maria-dolores-toledo-dominguez_0.jpg",
          "type_id": "4",
          "is_premier": false
        },
        "images": [
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/19/78/68/720x532/1633917712.jpg?isFirstImage=true",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/19/78/68/360x266/1633917712.jpg?isFirstImage=true",
            "title": "Departamento de 3 habitaciones, Quito · Vendo Departamento Marianitas de Calderon",
            "order": 1
          },
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/19/78/68/720x532/1633917719.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/19/78/68/360x266/1633917719.jpg",
            "title": "Departamento en Venta de 3 habitaciones Calderón",
            "order": 2
          },
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/19/78/68/720x532/1633917706.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/19/78/68/360x266/1633917706.jpg",
            "title": "El departamento tiene 86 metros de construcción, 14 años de construcción y está ",
            "order": 3
          }
        ],
        "has_videos": false,
        "has_tour": false,
        "modified_at": "2026-10-08T00:00:00-0400",
        "is_premier": false,
        "operations": [
          {
            "id": "1",
            "name": "Venta",
            "prices": [
              "…"
            ]
          }
        ],
        "has_plans": false,
        "has_whatsapp": true,
        "status": "ONLINE",
        "is_development": false
      },
      {
        "id": "151430908",
        "posting_code": "66SGGS",
        "title": "Departamento 3 Dorm. en El 3 Piso Frente Al Estadio Aucas",
        "subtitle": "Departamento · 80m² · 3 Habitaciones",
        "url": "https://www.plusvalia.com/propiedades/clasificado/veclapin-departamento-3-dorm.-en-el-3-piso-frente-al-estadio-151430908.html",
        "posting_type": "PROPERTY",
        "description": "Departamento # 302 de 3 dormitorios en el tercer piso al frente del estadio aucas. Caracteristicas del departamento: 3 dormitorios. sala. comedor. cocina. 2 baños completos. 1 lavanderia",
        "property_type": {
          "id": "2",
          "name": "Departamentos"
        },
        "operation": {
          "id": "1",
          "name": "Venta"
        },
        "prices": [
          {
            "amount": 45000,
            "formatted_amount": "45.000",
            "currency": "USD",
            "iso_code": "USD"
          }
        ],
        "features": {
          "land_area_m2": 86,
          "built_area_m2": 80,
          "bedrooms": 3,
          "bathrooms": 2,
          "age": 17
        },
        "coordinates": {
          "lat": -0.2783285,
          "lon": -78.5473952
        },
        "address": "Agustín Miranda & Avenida Rumichaca Ñan",
        "location": {
          "zone": {
            "id": "V1-D-305006728",
            "name": "Solanda"
          },
          "city": {
            "id": "V1-C-1",
            "name": "Quito"
          },
          "state": {
            "id": "V1-B-629",
            "name": "Pichincha"
          },
          "country": {
            "id": "V1-A-9",
            "name": "Ecuador"
          },
          "location_ids": [
            "V1-D-305006728",
            "V1-C-1",
            "V1-B-629"
          ]
        },
        "publisher": {
          "id": "50237707",
          "name": "RE/MAX ASESORIA INMOBILIARIA",
          "url": "https://www.plusvalia.com/inmobiliarias/re-max-asesoria-inmobiliaria_50237707-inmuebles.html",
          "logo": "https://img10.naventcdn.com/empresas/9/00/50/23/77/07/130x70/logo_re-max-asesoria-inmobiliaria_1787351544902.jpg",
          "type_id": "2",
          "is_premier": true
        },
        "images": [
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/43/09/08/720x532/1639116510.jpg?isFirstImage=true",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/43/09/08/360x266/1639116510.jpg?isFirstImage=true",
            "title": "Departamento de 3 habitaciones, Quito · Departamento 3 Dorm. en El 3 Piso Frente Al Estadio Aucas",
            "order": 1
          },
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/43/09/08/720x532/1639116490.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/43/09/08/360x266/1639116490.jpg",
            "title": "Departamento en Venta de 3 habitaciones Solanda",
            "order": 2
          },
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/43/09/08/720x532/1639116505.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/43/09/08/360x266/1639116505.jpg",
            "title": "DEPARTAMENTO # 302 DE 3 DORMITORIOS EN EL TERCER PISO AL FRENTE DEL ESTADIO AUCA",
            "order": 3
          }
        ],
        "has_videos": false,
        "has_tour": false,
        "modified_at": "2026-10-23T00:00:00-0400",
        "is_premier": true,
        "operations": [
          {
            "id": "1",
            "name": "Venta",
            "prices": [
              "…"
            ]
          }
        ],
        "has_plans": false,
        "has_whatsapp": true,
        "status": "ONLINE",
        "is_development": false
      },
      {
        "id": "151427845",
        "posting_code": "66SD4P",
        "title": "Venta Departamento 3d - San Vicente de La Florida en La Occidental",
        "subtitle": "Departamento · 82m² · 3 Habitaciones · 1 Estacionamiento",
        "url": "https://www.plusvalia.com/propiedades/clasificado/veclapin-venta-departamento-3d-san-vicente-de-la-florida-en-151427845.html",
        "posting_type": "PROPERTY",
        "description": "Venta departamento. sector san vicente de la florida occidental. referencia frente universidad israel de posgrados. características: Año de construcción: 2004. Área de construcción total: 81, 85 mts. distribución: - Conjunto cerrado con gua…",
        "property_type": {
          "id": "2",
          "name": "Departamentos"
        },
        "operation": {
          "id": "1",
          "name": "Venta"
        },
        "prices": [
          {
            "amount": 45000,
            "formatted_amount": "45.000",
            "currency": "USD",
            "iso_code": "USD"
          }
        ],
        "features": {
          "land_area_m2": 82,
          "built_area_m2": 82,
          "bedrooms": 3,
          "bathrooms": 1,
          "parking": 1,
          "age": 22
        },
        "coordinates": {
          "lat": -0.1447812,
          "lon": -78.5071575
        },
        "address": "San Vicente de la Florida",
        "location": {
          "zone": {
            "id": "V1-D-101004601",
            "name": "La Florida"
          },
          "city": {
            "id": "V1-C-1",
            "name": "Quito"
          },
          "state": {
            "id": "V1-B-629",
            "name": "Pichincha"
          },
          "country": {
            "id": "V1-A-9",
            "name": "Ecuador"
          },
          "location_ids": [
            "V1-D-101004601",
            "V1-C-1",
            "V1-B-629"
          ]
        },
        "publisher": {
          "id": "50083027",
          "name": "Grupo Inmobiliario renta-venta- compra",
          "url": "https://www.plusvalia.com/inmobiliarias/grupo-inmobiliario-renta-venta-compra_50083027-inmuebles.html",
          "logo": "https://img10.naventcdn.com/empresas/9/00/50/08/30/27/130x70/logo_grupo-inmobiliario-renta-venta-compra_1771022707890.jpg",
          "type_id": "2",
          "is_premier": true
        },
        "images": [
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/42/78/45/720x532/1639046728.jpg?isFirstImage=true",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/42/78/45/360x266/1639046728.jpg?isFirstImage=true",
            "title": "Departamento en Venta de 3 habitaciones La Florida · Venta Departamento 3d - San Vicente de La Florida en La Occidental",
            "order": 2
          },
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/42/78/45/720x532/1639046730.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/42/78/45/360x266/1639046730.jpg",
            "title": "VENTA DEPARTAMENTO\nSECTOR SAN VICENTE DE LA FLORIDA OCCIDENTAL\nREFERENCIA FRENTE",
            "order": 3
          },
          {
            "url": "https://img10.naventcdn.com/avisos/9/01/51/42/78/45/720x532/1639046734.jpg",
            "thumbnail": "https://img10.naventcdn.com/avisos/9/01/51/42/78/45/360x266/1639046734.jpg",
            "title": "Departamento Venta 82m² de 3 habitaciones",
            "order": 4
          }
        ],
        "has_videos": false,
        "has_tour": false,
        "modified_at": "2026-11-05T00:00:00-0500",
        "is_premier": true,
        "operations": [
          {
            "id": "1",
            "name": "Venta",
            "prices": [
              "…"
            ]
          }
        ],
        "has_plans": false,
        "has_whatsapp": true,
        "status": "ONLINE",
        "expenses": {
          "amount": 40,
          "formatted_amount": "40",
          "currency": "USD"
        },
        "is_development": false
      }
    ],
    "total": 3321,
    "current_page": 2,
    "total_pages": 111,
    "per_page": 30,
    "page_out_of_range": false,
    "filtered_out": 0,
    "applied_filters": {
      "operation": "sale",
      "type": "apartment",
      "location": "V1-C-1",
      "min_bedrooms": 3,
      "sort": "low_price",
      "page": 2
    }
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_3d6501e840d34f0cbb235d6e6f20e275",
    "credits_charged": 1,
    "credits_remaining": 1829
  }
}
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_premierbooleanoperationsobject[]has_plansbooleanhas_whatsappbooleanstatusstringis_developmentboolean
115119786866JRISVendo Departamento Marianitas de CalderonDepartamento · 86m² · 3 Habitaciones · 1 Estacionamientohttps://www.plusvalia.com/propiedades/clasificado/veclapin-vendo-departamento-marianitas-de-calderon-151197868.htmlPROPERTYEl departamento tiene 86 metros de construcción, 14 años de construcción y está en el segundo piso. Tiene 3 dormitorios, dos baños completos, sala, comedor, cocina con área de máquinas, un parqueadero y secadero. Esta dentro de un condomini…{2 fields}{2 fields}[1 item]{6 fields}Progreso{5 fields}{6 fields}[3 items]falsefalse2026-10-08T00:00:00-0400false[1 item]falsetrueONLINEfalse
215143090866SGGSDepartamento 3 Dorm. en El 3 Piso Frente Al Estadio AucasDepartamento · 80m² · 3 Habitacioneshttps://www.plusvalia.com/propiedades/clasificado/veclapin-departamento-3-dorm.-en-el-3-piso-frente-al-estadio-151430908.htmlPROPERTYDepartamento # 302 de 3 dormitorios en el tercer piso al frente del estadio aucas. Caracteristicas del departamento: 3 dormitorios. sala. comedor. cocina. 2 baños completos. 1 lavanderia{2 fields}{2 fields}[1 item]{5 fields}Agustín Miranda & Avenida Rumichaca Ñan{5 fields}{6 fields}[3 items]falsefalse2026-10-23T00:00:00-0400true[1 item]falsetrueONLINEfalse
315142784566SD4PVenta Departamento 3d - San Vicente de La Florida en La OccidentalDepartamento · 82m² · 3 Habitaciones · 1 Estacionamientohttps://www.plusvalia.com/propiedades/clasificado/veclapin-venta-departamento-3d-san-vicente-de-la-florida-en-151427845.htmlPROPERTYVenta departamento. sector san vicente de la florida occidental. referencia frente universidad israel de posgrados. características: Año de construcción: 2004. Área de construcción total: 81, 85 mts. distribución: - Conjunto cerrado con gua…{2 fields}{2 fields}[1 item]{6 fields}San Vicente de la Florida{5 fields}{6 fields}[3 items]falsefalse2026-11-05T00:00:00-0500true[1 item]falsetrueONLINEfalse

Recorded from our API · 3 items shown · 24 datapoints per itemGET /v1/plusvalia/search?operation=sale&type=apartment&location=V1-C-1&min_bedrooms=3&sort=low_price&page=2

24 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
  • operationsobject[]
  • has_plansboolean
  • has_whatsappboolean
  • is_developmentboolean

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/plusvalia/search?operation=sale&type=apartment&location=V1-C-1&min_bedrooms=3&sort=low_price&page=2" \
  -H "X-API-Key: $API_KEY"

Plusvalía · 4 endpoints

Endpoints

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

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

Overview

About the Plusvalía API

What you can get

The Plusvalía API returns Plusvalía property data as JSON through 4 endpoints.

  • Search: search takes an operation (sale, rent, transfer or temporary) and a type (house, apartment, land, office, shop, farm, building, warehouse, suite, clinic, vacation_house, room, parking, horizontal_development or vertical_development), with location, min_price, max_price, 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 a url or an id.
  • Agencies: agency takes a url or an id, with page.
  • Locations: locations takes a query, with limit.

The recorded search for apartments for sale in location V1-C-1 (Quito) with at least three bedrooms, sorted by low_price (page 2), returns listings with id, posting_code, title, subtitle, url, posting_type, description, property_type, operation, prices, features, address, location, publisher, images, has_videos, has_tour, modified_at, is_premier, status and is_development. It also returns total (3,321), current_page, total_pages, per_page and applied_filters.

How a call works

Search a city: GET /v1/plusvalia/search?operation=sale&type=apartment&location=V1-C-1&min_bedrooms=3&sort=low_price with your key in the X-API-Key header. Each listing's id is what listing takes, and its publisher.id is what agency takes. The location block carries zone, city and state IDs in the same V1 format location accepts. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

Use cases

Track asking prices for apartments and houses in Quito or another Ecuadorian city

Use the Plusvalía API to track asking prices for apartments and houses in Quito or another Ecuadorian city

Watch price drops with `sort=most_lowered_price`

Use the Plusvalía API to watch price drops with `sort=most_lowered_price`

Compare listing supply across zones of a city

Use the Plusvalía API to compare listing supply across zones of a city

Pull an agency's listings with `agency`

Use the Plusvalía API to pull an agency's listings with `agency`

FAQ

Questions

Do I need a Plusvalía account?

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

How much does the Plusvalía 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.

How do I find a location ID?

Call `locations` with a `query`, such as cumbaya. Search results also carry the zone, city and state IDs under `location`.

Should I build a Plusvalía scraper instead?

You can, but a Plusvalía scraper is code you maintain: page changes break it, requests get blocked, and Plusvalía's terms govern how you collect data. The Plusvalía 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 Plusvalía API with 100 free credits

No credit card. Failed calls are never billed.