--- title: "Properati API: JSON data, 4 endpoints, 1 credit per call" description: "Properati API for Colombian apartments, houses, offices and parking for sale or rent, listings and agencies as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/properati --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Properati 1 credit per call 4 endpoints 16 datapoints # Properati API Properati API for Colombian apartments, houses, offices and parking for sale or rent, listings and agencies as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Properati GET /v1/properati/search?location=3674954&operation=venta&property\_type=apartamento&bedrooms=3 ``` { "success": true, "data": { "applied_filters": { "location": "3674954", "operation": "venta", "property_type": "apartamento", "bedrooms": "3", "sort": "relevance" }, "pagination": { "page": 1, "page_size": 30, "returned": 30, "total": 8673, "max_page": 167, "capped": true, "has_next_page": true, "post_filtered": 0, "projects_skipped": 2 }, "items": [ { "id": "01a093a9-d7c1-78bb-b5d1-486b76e9cd17", "url": "https://www.properati.com.co/detalle/14032-32-d7e1-486b76e9cd37-1a093c9-b5f1-78db", "title": "Apartamento en Venta en El Poblado", "listing_type": "sale", "property_type": "apartamento", "is_project": false, "price": { "amount": 1200000000, "currency": "COP", "formatted": "$ 1.200.000.000" }, "location": { "text": "El Poblado, Medellín, Antioquia", "address": "Calle 5 Sur, Alejandría, Comuna 14 - El Poblado, Perímetro Urbano Medellín, Medellín, Valle de Aburrá, Antioquia, RAP del Agua y la Montaña, 050022, Colombia", "locality": "Medellín", "region": "Antioquia", "latitude": 6.196686, "longitude": -75.566718 }, "bedrooms": 3, "bathrooms": 3.5, "area": { "value": 143, "unit": "m2" }, "top_amenity": "Piscina", "agency": { "name": "María Cristina Ochoa U.", "logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg", "is_premium": true }, "published_at": "2026-09-12", "published_text": "Publicado 12 sept 2026", "images": [ "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvN2M2OGU5MWZkZThmMDliM2FjMTE4MDZkYmQyOTAwMTNhOTQxMWQ0YmViZDU5YjBhMjNhNGVkMzRjMG…", "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvYmEwMTQxZjI5NTVkZTkyZDE2YmU3ZWVhMjdlNGE0YmYwMTNjZTY3Y2NmYmU0ZDNmY2ZmNTE5MjIyNz…", "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhOS1kN2MxLTc4YmItYjVkMS00ODZiNzZlOWNkMTcvNzczYmE0YmJkN2JiZjliMDlhMmY5MjZjNWRlZGE4MDk4NWViZjIwNWNiMTk1ZGM1MjY2M2M5ODBlOD…" ] }, { "id": "01a0681e-0dc7-711c-99b5-c99fbc9040d8", "url": "https://www.properati.com.co/detalle/14032-32-de7-c99fbc9040f8-1a0683e-99d5-713c", "title": "Apartamento en Venta en El Poblado", "listing_type": "sale", "property_type": "apartamento", "is_project": false, "price": { "amount": 1200000000, "currency": "COP", "formatted": "$ 1.200.000.000" }, "location": { "text": "El Poblado, Medellín, Antioquia", "address": "Carrera 43B, Patio Bonito, Comuna 14 - El Poblado, Perímetro Urbano Medellín, Medellín, Valle de Aburrá, Antioquia, RAP del Agua y la Montaña, 050022, Colombia", "locality": "Medellín", "region": "Antioquia", "latitude": 6.202323, "longitude": -75.573837 }, "bedrooms": 3, "bathrooms": 4.5, "area": { "value": 197, "unit": "m2" }, "top_amenity": "Parqueadero", "agency": { "name": "María Cristina Ochoa U.", "logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg", "is_premium": true }, "published_at": "2026-09-03", "published_text": "Publicado 3 sept 2026", "images": [ "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwNjgxZS0wZGM3LTcxMWMtOTliNS1jOTlmYmM5MDQwZDgvYWQ4ZTBjODljYWEwNDdlYjNmNGRmMjA5NTk1N2NhNWRlN2Y4ZTlmMTlmYjhmZDFkZWM5MTkxZTVjMD…", "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwNjgxZS0wZGM3LTcxMWMtOTliNS1jOTlmYmM5MDQwZDgvMTYzNzZiN2QxOTFhYzk0NWRiZjIwNzA1MTMxMzk1YzcxMzg5NmY5ODMzNjBkYjQ1ZWYyNzc3ODMwNW…", "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwNjgxZS0wZGM3LTcxMWMtOTliNS1jOTlmYmM5MDQwZDgvZjhjNmFmMjUxZmM3YzMyZWU2MGU1ODVmNDVmMDIyOGZjOWQzODVjMWJlOWIwYWI0MWYyOGFlY2NlNT…" ] }, { "id": "01a093aa-5893-7f21-b915-cdf9fd2e7309", "url": "https://www.properati.com.co/detalle/14032-32-58b3-cdf9fd2e7329-1a093ca-b935-7f41", "title": "Apartamento en Venta en El Poblado", "listing_type": "sale", "property_type": "apartamento", "is_project": false, "price": { "amount": 1200000000, "currency": "COP", "formatted": "$ 1.200.000.000" }, "location": { "text": "El Poblado, Medellín, Antioquia", "address": "Calle 5G, La Florida, Comuna 14 - El Poblado, Perímetro Urbano Medellín, Medellín, Valle de Aburrá, Antioquia, RAP del Agua y la Montaña, 050003, Colombia", "locality": "Medellín", "region": "Antioquia", "latitude": 6.204194, "longitude": -75.564051 }, "bedrooms": 3, "bathrooms": 2, "area": { "value": 178, "unit": "m2" }, "top_amenity": "Parqueadero", "agency": { "name": "María Cristina Ochoa U.", "logo_url": "https://images.proppit.com/publisher/01a05dbd-6151-700c-9577-4798f77a51b9/logo.jpeg", "is_premium": true }, "published_at": "2026-09-12", "published_text": "Publicado 12 sept 2026", "images": [ "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhYS01ODkzLTdmMjEtYjkxNS1jZGY5ZmQyZTczMDkvYTE5OTc0YTc3OThmZmI3NDM2NmE4OTM1ZTFiNzE3OTkxMDk5ZTViODU1ZWZmODk5NGZkY2RmYmU0ZW…", "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhYS01ODkzLTdmMjEtYjkxNS1jZGY5ZmQyZTczMDkvODk4NTYzMTQzZDVjYmFjZTA5ZGRkZWRmMDUzYjg5MWVjOTI3YjQ0YWM3OTM4OGZlNzFjYzc3M2JkZG…", "https://img.properati.com/eyJidWNrZXQiOiJwcmQtbGlmdWxsY29ubmVjdC1iYWNrZW5kLWIyYi1pbWFnZXMiLCJrZXkiOiJpbmdlc3Rlci8wMWEwOTNhYS01ODkzLTdmMjEtYjkxNS1jZGY5ZmQyZTczMDkvNzYwODg0ZGI5ZTE5NDc4MTliNTBjNzk5NGE1NDE0ODUyM2VlYjlmYmRmNTQ0MzgxODM0MWYxNTM2Zj…" ] } ] }, "meta": { "endpoint_family": "search", "request_id": "req_540e44c8a93f424287d9d296f32522d7", "credits_charged": 1, "credits_remaining": 1827 } } ``` 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 | url url | title string | listing\_type string | property\_type string | is\_project boolean | price object | location object | bedrooms integer | bathrooms number | area object | top\_amenity string | agency object | published\_at string | published\_text string | images string\[\] | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 01a093a9-d7c1-78bb-b5d1-486b76e9cd17 | https://www.properati.com.co/detalle/14032-32-d7e1-486b76e9cd37-1a093c9-b5f1-78db | Apartamento en Venta en El Poblado | sale | apartamento | false | {3 fields} | {6 fields} | 3 | 3.5 | {2 fields} | Piscina | {3 fields} | 2026-09-12 | Publicado 12 sept 2026 | \[3 items\] | | 2 | 01a0681e-0dc7-711c-99b5-c99fbc9040d8 | https://www.properati.com.co/detalle/14032-32-de7-c99fbc9040f8-1a0683e-99d5-713c | Apartamento en Venta en El Poblado | sale | apartamento | false | {3 fields} | {6 fields} | 3 | 4.5 | {2 fields} | Parqueadero | {3 fields} | 2026-09-03 | Publicado 3 sept 2026 | \[3 items\] | | 3 | 01a093aa-5893-7f21-b915-cdf9fd2e7309 | https://www.properati.com.co/detalle/14032-32-58b3-cdf9fd2e7329-1a093ca-b935-7f41 | Apartamento en Venta en El Poblado | sale | apartamento | false | {3 fields} | {6 fields} | 3 | 2 | {2 fields} | Parqueadero | {3 fields} | 2026-09-12 | Publicado 12 sept 2026 | \[3 items\] | Recorded from our API · 3 items shown · 16 datapoints per item GET /v1/properati/search?location=3674954&operation=venta&property\_type=apartamento&bedrooms=3 16 datapoints ### Identity - id string - title string - listing\_type string - property\_type string ### Contact - url url ### Location - location object - area object ### Reputation - images string\[\] ### Price - price object ### Other - is\_project boolean - bedrooms integer - bathrooms number - top\_amenity string - agency object - published\_at string - published\_text string Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/properati/search?location=3674954&operation=venta&property_type=apartamento&bedrooms=3" \ -H "X-API-Key: $API_KEY" ``` Properati · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/properati/agency`](https://perceptlayer.com/apis/properati/agency) | `id` +2 optional | 1 credit | | [GET `/v1/properati/autocomplete`](https://perceptlayer.com/apis/properati/autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/properati/listing`](https://perceptlayer.com/apis/properati/listing) | `id` | 1 credit | | [GET `/v1/properati/search`](https://perceptlayer.com/apis/properati/search) | `location` +14 optional | 1 credit | Overview ## About the Properati API ## What you can get The Properati API returns Properati property data as JSON through 4 endpoints. - **Search:** `search` takes a `location`, with `operation` (venta, arriendo, sale or rent), `property_type` (apartamento, casa, apartaestudio, oficina, local or parqueadero), `stratum`, `days_since_publication` (1, 7 or 30), `sort` (relevance, published\_on\_desc, price\_asc, price\_desc, surface\_total\_desc or surface\_total\_asc), `page`, `min_price`, `max_price`, `bedrooms`, `bathrooms`, `min_usable_area`, `max_usable_area`, `min_built_area` and `max_built_area`. - **Listings:** `listing` takes an `id`. - **Agencies:** `agency` takes an `id`, with `operation` (venta or arriendo) and `page`. - **Autocomplete:** `autocomplete` takes a `q`, with `limit`. The recorded `search` for three-bedroom apartments for sale in location 3674954 (results in Medellín) returns `items` with `id`, `url`, `title`, `listing_type`, `property_type`, `is_project`, `price`, `location`, `bedrooms`, `bathrooms`, `area`, `top_amenity`, `agency`, `published_at`, `published_text` and `images`. It also returns `pagination` with `page_size`, `max_page`, `capped` and `has_next_page`, and `applied_filters`. ## How a call works Search a city: `GET /v1/properati/search?location=3674954&operation=venta&property_type=apartamento&bedrooms=3` with your key in the `X-API-Key` header. Each item's `id` is what `listing` takes. Page with `page` up to `max_page`. 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 in Medellín or another Colombian city `Use the Properati API to track asking prices for apartments in Medellín or another Colombian city` ### Compare prices by \`stratum\` `` Use the Properati API to compare prices by `stratum` `` ### Watch new listings from the last day, week or month with \`days\_since\_publication\` `` Use the Properati API to watch new listings from the last day, week or month with `days_since_publication` `` ### Separate new projects from resale homes with \`is\_project\` `` Use the Properati API to separate new projects from resale homes with `is_project` `` FAQ ## Questions **Do I need a Properati account?** No. You call this Properati API with your Perceptlayer key in the \`X-API-Key\` header, with no Properati login. **How much does the Properati 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 many results can one search return?** The recorded Medellín search reports a \`max\_page\` of 167 at 30 per page, with \`capped\` set to true. Narrow the price, area, \`stratum\` or \`property\_type\` to go deeper. **Should I build a Properati scraper instead?** You can, but a Properati scraper is code you maintain: page changes break it, requests get blocked, and Properati's terms govern how you collect data. The Properati 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 Properati 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)