--- title: "Ciencuadras API: JSON data, 4 endpoints, 1 credit per call" description: "Ciencuadras API for Colombian homes for sale or rent by city, stratum and rooms, with property details and agencies as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/ciencuadras --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Ciencuadras 1 credit per call 4 endpoints 29 datapoints # Ciencuadras API Ciencuadras API for Colombian homes for sale or rent by city, stratum and rooms, with property details and agencies as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Ciencuadras GET /v1/ciencuadras/search?transaction=rent&department=antioquia&city=medellin&bedrooms\[\]=3&min\_price=1500000&max\_price=5000000 ``` { "success": true, "data": { "items": [ { "id": 3941315, "code": "15117-42712", "url": "/inmueble/apartamento-en-arriendo-en-belen-medellin-3941315", "canonical_url": "https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-belen-medellin-3941315", "offer_type": "rent", "property_type": "Apartamento", "price": 2500000, "price_is_placeholder": false, "currency": "COP", "rent_price": 2500000, "area_built": 105, "area_private": 105, "area_card": 105, "bedrooms": 3, "bathrooms": 2, "garages": 0, "stratum": 4, "antiquity": "0", "address": "CL 31 A 81 53 AP 301", "location": { "department": "Antioquia", "city": "Medellín", "locality": "Belén", "neighborhood": "BELEN", "locality_group": "Comuna 4 Aranjuez", "neighborhood_group": "BELEN", "latitude": 6.233714, "longitude": -75.602851 }, "amenities": { "elevator": false, "gym": false, "communal_pool": false, "private_pool": false }, "is_offer": false, "fair_housing": false, "rental_policy": true, "image": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3941315/afcafe__179426007462_plana.jpeg", "has_matterport": false, "has_360": false, "created_at": "2026-11-09T16:34:33.000Z", "advisor": { "id": 15117, "name": "ARRENDAMIENTOS EL CASTILLO S.A.S.", "type": "Inmobiliaria", "whatsapp": "3116962731", "email": "coordinacionpropiedades@arrendamientoselcastillo.co" } }, { "id": 3944357, "code": "14967-29009", "url": "/inmueble/apartamento-en-arriendo-en-la-hondonada-medellin-3944357", "canonical_url": "https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-la-hondonada-medellin-3944357", "offer_type": "rent", "property_type": "Apartamento", "price": 2350000, "price_is_placeholder": false, "currency": "COP", "rent_price": 2350000, "area_built": 65, "area_private": 65, "area_card": 65, "bedrooms": 3, "bathrooms": 2, "garages": 0, "stratum": 4, "antiquity": "0", "address": "CR 82 CL 9 a sur 28", "location": { "department": "Antioquia", "city": "Medellín", "locality": "Belén", "neighborhood": "LA HONDONADA", "locality_group": "Comuna 16 Belén", "neighborhood_group": "Rodeo Alto", "latitude": 6.203634, "longitude": -75.605378 }, "amenities": { "elevator": false, "gym": true, "communal_pool": false, "private_pool": false }, "is_offer": false, "fair_housing": false, "rental_policy": true, "image": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3944357/afcce__179442795552_plana.jpeg", "has_matterport": false, "has_360": false, "created_at": "2026-11-11T15:12:34.000Z", "advisor": { "id": 14967, "name": "BIEN RAIZ S.A.S", "type": "Inmobiliaria", "phone": "3147723737", "whatsapp": "3147723737", "email": "supervisor.contact@bienraiz.co" } }, { "id": 3944366, "code": "15313-67979986", "url": "/inmueble/apartamento-en-arriendo-en-loma-de-los-bernal-medellin-3944366", "canonical_url": "https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-loma-de-los-bernal-medellin-3944366", "offer_type": "rent", "property_type": "Apartamento", "price": 4400000, "price_is_placeholder": false, "currency": "COP", "rent_price": 4400000, "area_built": 90, "area_private": 90, "area_card": 90, "bedrooms": 3, "bathrooms": 2, "garages": 1, "stratum": 5, "antiquity": "5", "address": "CARRERA 84F 3D- 150", "location": { "department": "Antioquia", "city": "Medellín", "locality": "Belén", "neighborhood": "LOMA DE LOS BERNAL", "locality_group": "Comuna 16 Belén", "neighborhood_group": "Loma De Los Bernal", "latitude": 6.21529, "longitude": -75.607834 }, "amenities": { "elevator": false, "gym": false, "communal_pool": false, "private_pool": false }, "is_offer": false, "fair_housing": false, "rental_policy": true, "image": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3944366/afcd__179442821623_plana.jpeg", "has_matterport": false, "has_360": false, "created_at": "2026-11-11T15:16:55.000Z", "advisor": { "id": 15313, "name": "Portada Inmobiliaria", "type": "Inmobiliaria", "phone": "42044873", "whatsapp": "42044873", "email": "admin@portadainmobiliaria.com" } } ], "excluded_by_filters": 0, "pagination": { "page": 1, "per_page": 20, "total": 5393, "total_pages": 270, "has_next": true, "results_capped": false }, "highlights": [ { "id": 3935806, "code": "1222296-1349", "url": "/inmueble/apartamento-en-arriendo-en-simesa-medellin-3935806", "canonical_url": "https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-simesa-medellin-3935806", "offer_type": "rent", "property_type": "Apartamento", "price": 4000000, "price_is_placeholder": false, "currency": "COP", "rent_price": 4000000, "area_built": 70, "area_private": 70, "area_card": 70, "bedrooms": 3, "bathrooms": 2, "garages": 1, "stratum": 5, "antiquity": "11", "address": "Calle 19 # 43G - 155", "location": { "department": "Antioquia", "city": "Medellín", "locality": "El Poblado", "neighborhood": "SIMESA", "locality_group": "Medellín", "neighborhood_group": "SIMESA", "latitude": 6.221918, "longitude": -75.574331 }, "amenities": { "elevator": false, "gym": true, "communal_pool": true, "private_pool": false }, "is_offer": false, "fair_housing": false, "rental_policy": true, "image": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3935806/aecebd__179385777138_plana.jpeg", "has_matterport": false, "has_360": false, "created_at": "2026-11-04T16:31:44.000Z", "advisor": { "id": 1222296, "name": "369 Propiedades", "type": "Inmobiliaria", "phone": "57-3145973479", "whatsapp": "57-3145973479", "email": "comercial@369propiedades.com" } }, { "id": 3940591, "code": "15111-3940591", "url": "/inmueble/apartamento-en-arriendo-en-buenos-aires-medellin-3940591", "canonical_url": "https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-buenos-aires-medellin-3940591", "offer_type": "rent", "property_type": "Apartamento", "price": 1600000, "price_is_placeholder": false, "currency": "COP", "rent_price": 1600000, "area_built": 70, "area_private": 70, "area_card": 70, "bedrooms": 3, "bathrooms": 1, "garages": 0, "stratum": 3, "antiquity": "25", "address": "carrera 31 # 46-15 apto401", "location": { "department": "Antioquia", "city": "Medellín", "locality": "Buenos Aires", "neighborhood": "BUENOS AIRES", "locality_group": "Buenos Aires", "neighborhood_group": "BUENOS AIRES", "latitude": 6.238915, "longitude": -75.554818 }, "amenities": { "elevator": false, "gym": false, "communal_pool": false, "private_pool": false }, "is_offer": false, "fair_housing": false, "rental_policy": true, "image": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3940591/afff_179424263310_plana.jpeg", "has_matterport": false, "has_360": false, "created_at": "2026-11-09T11:42:28.000Z", "advisor": { "id": 15111, "name": "BETA PROPIEDAD RAIZ S.A.S", "type": "Inmobiliaria", "phone": "3127910371", "whatsapp": "3127910371", "email": "betapropiedad@gmail.com" } }, { "id": 3943804, "code": "1005565-3943804", "url": "/inmueble/apartamento-en-arriendo-en-laureles-medellin-3943804", "canonical_url": "https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-laureles-medellin-3943804", "offer_type": "rent", "property_type": "Apartamento", "price": 3650000, "price_is_placeholder": false, "currency": "COP", "rent_price": 3650000, "area_built": 110, "area_private": 110, "area_card": 110, "bedrooms": 3, "bathrooms": 2, "garages": 1, "stratum": 5, "antiquity": "0", "address": "LAURELES", "location": { "department": "Antioquia", "city": "Medellín", "locality": "Laureles - Estadio", "neighborhood": "Laureles", "locality_group": "Laureles - Estadio", "neighborhood_group": "Laureles", "latitude": 6.243426, "longitude": -75.594685 }, "amenities": { "elevator": false, "gym": false, "communal_pool": false, "private_pool": false }, "is_offer": false, "fair_housing": false, "rental_policy": true, "image": "https://www-img-cc.s3.amazonaws.com/inmuebles/images/3943804/afddf_179441177996_plana.jpeg", "has_matterport": false, "has_360": false, "created_at": "2026-11-11T10:31:48.000Z", "advisor": { "id": 1005565, "name": "Jonathan Osorio Propiedad Raiz", "type": "Inmobiliaria", "phone": "3243548323", "whatsapp": "3243548323", "email": "osoriopropiedadraiz@gmail.com" } } ], "applied_filters": { "transaction": "rent", "department": "antioquia", "city": "medellin", "min_price": "1500000", "max_price": "5000000", "bedrooms": [ "3" ] } }, "meta": { "endpoint_family": "search", "request_id": "req_0c81535935b64adab352c5f7264ca83e", "credits_charged": 1, "credits_remaining": 1881 } } ``` 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 integer | code string | url string | canonical\_url url | offer\_type string | property\_type string | price integer | price\_is\_placeholder boolean | currency string | rent\_price integer | area\_built integer | area\_private integer | area\_card integer | bedrooms integer | bathrooms integer | garages integer | stratum integer | antiquity string | address string | location object | amenities object | is\_offer boolean | fair\_housing boolean | rental\_policy boolean | image url | has\_matterport boolean | has\_360 boolean | created\_at string | advisor object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 3941315 | 15117-42712 | /inmueble/apartamento-en-arriendo-en-belen-medellin-3941315 | https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-belen-medellin-3941315 | rent | Apartamento | 2500000 | false | COP | 2500000 | 105 | 105 | 105 | 3 | 2 | 0 | 4 | 0 | CL 31 A 81 53 AP 301 | {8 fields} | {4 fields} | false | false | true | https://www-img-cc.s3.amazonaws.com/inmuebles/images/3941315/afcafe\_\_179426007462\_plana.jpeg | false | false | 2026-11-09T16:34:33.000Z | {5 fields} | | 2 | 3944357 | 14967-29009 | /inmueble/apartamento-en-arriendo-en-la-hondonada-medellin-3944357 | https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-la-hondonada-medellin-3944357 | rent | Apartamento | 2350000 | false | COP | 2350000 | 65 | 65 | 65 | 3 | 2 | 0 | 4 | 0 | CR 82 CL 9 a sur 28 | {8 fields} | {4 fields} | false | false | true | https://www-img-cc.s3.amazonaws.com/inmuebles/images/3944357/afcce\_\_179442795552\_plana.jpeg | false | false | 2026-11-11T15:12:34.000Z | {6 fields} | | 3 | 3944366 | 15313-67979986 | /inmueble/apartamento-en-arriendo-en-loma-de-los-bernal-medellin-3944366 | https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-loma-de-los-bernal-medellin-3944366 | rent | Apartamento | 4400000 | false | COP | 4400000 | 90 | 90 | 90 | 3 | 2 | 1 | 5 | 5 | CARRERA 84F 3D- 150 | {8 fields} | {4 fields} | false | false | true | https://www-img-cc.s3.amazonaws.com/inmuebles/images/3944366/afcd\_\_179442821623\_plana.jpeg | false | false | 2026-11-11T15:16:55.000Z | {6 fields} | Recorded from our API · 3 items shown · 29 datapoints per item GET /v1/ciencuadras/search?transaction=rent&department=antioquia&city=medellin&bedrooms\[\]=3&min\_price=1500000&max\_price=5000000 29 datapoints ### Identity - id integer - offer\_type string - property\_type string ### Contact - url string - canonical\_url url ### Location - area\_built integer - area\_private integer - area\_card integer - address string - location object ### Reputation - image url ### Price - price integer - price\_is\_placeholder boolean - currency string - rent\_price integer ### Other - code string - bedrooms integer - bathrooms integer - garages integer - stratum integer - antiquity string - amenities object - is\_offer boolean - fair\_housing boolean - rental\_policy boolean - has\_matterport boolean - has\_360 boolean - created\_at string - advisor object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/ciencuadras/search?transaction=rent&department=antioquia&city=medellin&bedrooms[]=3&min_price=1500000&max_price=5000000" \ -H "X-API-Key: $API_KEY" ``` Ciencuadras · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/ciencuadras/agency`](https://perceptlayer.com/apis/ciencuadras/agency) | `agency_id` +3 optional | 1 credit | | [GET `/v1/ciencuadras/autocomplete`](https://perceptlayer.com/apis/ciencuadras/autocomplete) | `q` +2 optional | 1 credit | | [GET `/v1/ciencuadras/property`](https://perceptlayer.com/apis/ciencuadras/property) | `url` | 1 credit | | [GET `/v1/ciencuadras/search`](https://perceptlayer.com/apis/ciencuadras/search) | `transaction` +19 optional | 1 credit | Overview ## About the Ciencuadras API ## What you can get The Ciencuadras API returns Ciencuadras property data for Colombia as JSON through 4 endpoints. - **Search:** `search` takes a `transaction` (sale or rent), with `department`, `city`, `locality`, `neighborhood`, repeatable `property_type[]`, `bedrooms[]`, `bathrooms[]`, `garages[]` and `stratum[]`, `min_price`, `max_price`, `min_area`, `max_area`, `project`, `include_map`, `sort` (date, area or price), `order` (asc or desc), `page` and `per_page`. - **Properties:** `property` takes a `url`, such as /inmueble/casa-en-venta-en-la-hacienda-cali-3923674. - **Agencies:** `agency` takes an `agency_id`, with `order` (asc or desc), `page` and `per_page`. - **Autocomplete:** `autocomplete` takes `q`, with `transaction` (sale or rent) and `size`. The recorded `search` ( `transaction=rent`, `department=antioquia`, `city=medellin`, `bedrooms[]=3`, `min_price=1500000`, `max_price=5000000`) returns `items`, each with `id`, `code`, `url`, `canonical_url`, `offer_type`, `property_type`, `price`, `currency`, `area_built`, `area_private`, `bedrooms`, `bathrooms`, `garages`, `stratum`, `antiquity`, `address`, `location` ( `department`, `city`, `locality`, `neighborhood`, `latitude`, `longitude`), `amenities`, `image`, `created_at` and `advisor`, plus a separate `highlights` list. Its `pagination` gives `total` (5,393), `total_pages`, `has_next` and `results_capped`. ## How a call works Search three-bedroom rentals in Medellín: `GET /v1/ciencuadras/search?transaction=rent&department=antioquia&city=medellin&bedrooms[]=3&min_price=1500000&max_price=5000000` with your key in the `X-API-Key` header. Each item's `url` (a path such as /inmueble/apartamento-en-arriendo-en-belen-medellin-3941315) goes to `property` as `url`. 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 rents and sale prices in Colombian pesos for Medellín, Cali and other cities `Use the Ciencuadras API to track rents and sale prices in Colombian pesos for Medellín, Cali and other cities` ### Compare prices by socioeconomic \`stratum\` within a city `` Use the Ciencuadras API to compare prices by socioeconomic `stratum` within a city `` ### Filter by locality and neighbourhood for street-level comparables `Use the Ciencuadras API to filter by locality and neighbourhood for street-level comparables` ### Filter project listings in or out with \`project\` `` Use the Ciencuadras API to filter project listings in or out with `project` `` FAQ ## Questions **Do I need a Ciencuadras account?** No. You call this Ciencuadras API with your Perceptlayer key in the \`X-API-Key\` header, with no Ciencuadras login. **How much does the Ciencuadras 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. **Can I filter by estrato?** Yes. Pass one or more \`stratum\[\]\` values to \`search\`; each item returns its \`stratum\`. **Should I build a Ciencuadras scraper instead?** You can, but a Ciencuadras scraper is code you maintain: page changes break it, requests get blocked, and Ciencuadras's terms govern how you collect data. The Ciencuadras 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 Ciencuadras 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)