--- title: "Plusvalía API: JSON data, 4 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/plusvalia --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Plusvalía 1 credit per call 4 endpoints 24 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. [Get a free API key](https://perceptlayer.com/signup) Run it below 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 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 | operations object\[\] | has\_plans boolean | has\_whatsapp boolean | status string | is\_development boolean | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 151197868 | 66JRIS | Vendo Departamento Marianitas de Calderon | Departamento · 86m² · 3 Habitaciones · 1 Estacionamiento | https://www.plusvalia.com/propiedades/clasificado/veclapin-vendo-departamento-marianitas-de-calderon-151197868.html | PROPERTY | 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… | {2 fields} | {2 fields} | \[1 item\] | {6 fields} | Progreso | {5 fields} | {6 fields} | \[3 items\] | false | false | 2026-10-08T00:00:00-0400 | false | \[1 item\] | false | true | ONLINE | false | | 2 | 151430908 | 66SGGS | Departamento 3 Dorm. en El 3 Piso Frente Al Estadio Aucas | Departamento · 80m² · 3 Habitaciones | https://www.plusvalia.com/propiedades/clasificado/veclapin-departamento-3-dorm.-en-el-3-piso-frente-al-estadio-151430908.html | PROPERTY | 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 | {2 fields} | {2 fields} | \[1 item\] | {5 fields} | Agustín Miranda & Avenida Rumichaca Ñan | {5 fields} | {6 fields} | \[3 items\] | false | false | 2026-10-23T00:00:00-0400 | true | \[1 item\] | false | true | ONLINE | false | | 3 | 151427845 | 66SD4P | Venta Departamento 3d - San Vicente de La Florida en La Occidental | Departamento · 82m² · 3 Habitaciones · 1 Estacionamiento | https://www.plusvalia.com/propiedades/clasificado/veclapin-venta-departamento-3d-san-vicente-de-la-florida-en-151427845.html | PROPERTY | 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… | {2 fields} | {2 fields} | \[1 item\] | {6 fields} | San Vicente de la Florida | {5 fields} | {6 fields} | \[3 items\] | false | false | 2026-11-05T00:00:00-0500 | true | \[1 item\] | false | true | ONLINE | false | Recorded from our API · 3 items shown · 24 datapoints per item GET /v1/plusvalia/search?operation=sale&type=apartment&location=V1-C-1&min\_bedrooms=3&sort=low\_price&page=2 24 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 - operations object\[\] - has\_plans boolean - has\_whatsapp boolean - is\_development boolean Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/plusvalia/agency`](https://perceptlayer.com/apis/plusvalia/agency) | none +3 optional | 1 credit | | [GET `/v1/plusvalia/listing`](https://perceptlayer.com/apis/plusvalia/listing) | none +2 optional | 1 credit | | [GET `/v1/plusvalia/locations`](https://perceptlayer.com/apis/plusvalia/locations) | `query` +1 optional | 1 credit | | [GET `/v1/plusvalia/search`](https://perceptlayer.com/apis/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 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 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. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)