Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Ciencuadras

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

#idintegercodestringurlstringcanonical_urlurloffer_typestringproperty_typestringpriceintegerprice_is_placeholderbooleancurrencystringrent_priceintegerarea_builtintegerarea_privateintegerarea_cardintegerbedroomsintegerbathroomsintegergaragesintegerstratumintegerantiquitystringaddressstringlocationobjectamenitiesobjectis_offerbooleanfair_housingbooleanrental_policybooleanimageurlhas_matterportbooleanhas_360booleancreated_atstringadvisorobject
1394131515117-42712/inmueble/apartamento-en-arriendo-en-belen-medellin-3941315https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-belen-medellin-3941315rentApartamento2500000falseCOP250000010510510532040CL 31 A 81 53 AP 301{8 fields}{4 fields}falsefalsetruehttps://www-img-cc.s3.amazonaws.com/inmuebles/images/3941315/afcafe__179426007462_plana.jpegfalsefalse2026-11-09T16:34:33.000Z{5 fields}
2394435714967-29009/inmueble/apartamento-en-arriendo-en-la-hondonada-medellin-3944357https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-la-hondonada-medellin-3944357rentApartamento2350000falseCOP235000065656532040CR 82 CL 9 a sur 28{8 fields}{4 fields}falsefalsetruehttps://www-img-cc.s3.amazonaws.com/inmuebles/images/3944357/afcce__179442795552_plana.jpegfalsefalse2026-11-11T15:12:34.000Z{6 fields}
3394436615313-67979986/inmueble/apartamento-en-arriendo-en-loma-de-los-bernal-medellin-3944366https://www.ciencuadras.com/inmueble/apartamento-en-arriendo-en-loma-de-los-bernal-medellin-3944366rentApartamento4400000falseCOP440000090909032155CARRERA 84F 3D- 150{8 fields}{4 fields}falsefalsetruehttps://www-img-cc.s3.amazonaws.com/inmuebles/images/3944366/afcd__179442821623_plana.jpegfalsefalse2026-11-11T15:16:55.000Z{6 fields}

Recorded from our API · 3 items shown · 29 datapoints per itemGET /v1/ciencuadras/search?transaction=rent&department=antioquia&city=medellin&bedrooms[]=3&min_price=1500000&max_price=5000000

29 datapoints

Identity

  • idinteger
  • offer_typestring
  • property_typestring

Contact

  • urlstring
  • canonical_urlurl

Location

  • area_builtinteger
  • area_privateinteger
  • area_cardinteger
  • addressstring
  • locationobject

Reputation

  • imageurl

Price

  • priceinteger
  • price_is_placeholderboolean
  • currencystring
  • rent_priceinteger

Other

  • codestring
  • bedroomsinteger
  • bathroomsinteger
  • garagesinteger
  • stratuminteger
  • antiquitystring
  • amenitiesobject
  • is_offerboolean
  • fair_housingboolean
  • rental_policyboolean
  • has_matterportboolean
  • has_360boolean
  • created_atstring
  • advisorobject

Playground

Run this API

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

EndpointRequired parametersCost
GET/v1/ciencuadras/agency
agency_id+3 optional
1 credit
GET/v1/ciencuadras/autocomplete
q+2 optional
1 credit
GET/v1/ciencuadras/property
url
1 credit
GET/v1/ciencuadras/search
transaction+19 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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