Metrocuadrado Colombia Real Estate Scraper

Here is one real result, with every field the actor returns:

{
  "imageUrl": "https://multimedia.metrocuadrado.com/1654-C0017-05/1654-C0017-05_2_p.jpg",
  "title": "Apartamento en Venta, EL PORVENIR, Bogotá D.C.",
  "url": "https://www.metrocuadrado.com/proyecto/caney-reservado-fontibon/1654-C0017-05",
  "id": "1654-C0017-05",
  "operation": "sale",
  "price": 133200000,
  "currency": "COP",
  "propertyType": "Apartamento",
  "propertyStatus": "Nuevo",
  "estrato": 3,
  "bedrooms": 2,
  "bathrooms": 1,
  "garages": 0,
  "area": 37.92,
  "privateArea": 33.36,
  "pricePerM2": 3512658,
  "city": "Bogotá D.C.",
  "zone": "Occidental",
  "neighborhood": "EL PORVENIR",
  "latitude": 4.6890154,
  "longitude": -74.16353,
  "projectName": "CANEY RESERVADO FONTIBON",
  "offeredBy": "agency",
  "ownerType": "Constructora",
  "agencyId": "609",
  "agentPhone": "3167273693",
  "agencyPhone": null,
  "branchPhone": null,
  "whatsapp": "573167273693",
  "housingType": "VIS",
  "category": "Tradicional",
  "constructedArea": 37.92,
  "contactCount": 15,
  "listedAt": null,
  "nearbyPlaces": [
    { "name": "Fontibon Calle 13", "address": "ac 17 # 128 - 25", "latitude": 4.689962, "longitude": -74.16402 }
  ],
  "description": "El proyecto esta constituido por una torre de 17 pisos con 252 apartamentos con areas desde 29 m2 hasta los 46.99 m2 ... (trimmed)",
  "features": {
    "conTerrazaBalcon": "Ninguno",
    "conZonaLavanderia": "S",
    "nroBanos": "1",
    "nroCuartos": "2",
    "nroGarajes": "0",
    "tipoCocina": "Lineal",
    "tipoComedor": "Sala-comedor",
    "tipoDeposito": "0"
  },
  "images": [
    "https://multimedia.metrocuadrado.com/1654-C0017-05/1654-C0017-05_2_p.jpg",
    "https://multimedia.metrocuadrado.com/1654-C0017-05/1654-C0017-05_3_p.jpg"
  ],
  "observedAt": "2026-08-10T14:17:56.252Z",
  "error": null
}

The most complete Metrocuadrado scraper available. It returns every field the listing exposes, including price and price per square meter, estrato, private and constructed area, geolocation, nearby places, project and owner details, and agent, agency and WhatsApp contacts, so you can build both a Colombian property dataset and a lead list from one run.

Note: nearbyPlaces, images and description above are trimmed for length; live runs return the full set. All values shown are real.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor scrapes Metrocuadrado property listings from a search you build (city, operation, property type) or from a search URL you paste, applies your price, bedroom and area filters, paginates through the results, and writes one normalized record per listing to the run's dataset. Each record carries the property (price, price per square meter, estrato, areas, bedrooms, bathrooms, garages), its geolocation and nearby places, the project and owner details, and the agent, agency and WhatsApp contacts. Missing source values are returned as null.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 10 apartments for sale in Bogota.

{
  "startUrl": "https://www.metrocuadrado.com/apartamentos/venta/bogota/",
  "maxListings": 10
}

Or build the search without a URL: set city, operation and propertyType, then add optional minPrice, maxPrice, minBedrooms and minArea filters.

Input reference

Field	Type	Required	Default	Description
startUrl	string	no	.../apartamentos/venta/bogota/	A Metrocuadrado search/results URL to scrape. Copy it from your browser after applying filters. Overrides the city/operation/property-type fields.
city	enum	no	bogota	City to search (for example bogota, medellin, cali, cartagena). Used only when no startUrl is set.
operation	enum	no	venta	venta (for sale) or arriendo (for rent). Used only when no startUrl is set.
propertyType	enum	no	apartamentos	Property type (for example apartamentos, casas, oficinas, locales, lotes). Used only when no startUrl is set.
minPrice	integer	no	(none)	Only return listings priced at or above this amount (COP).
maxPrice	integer	no	(none)	Only return listings priced at or below this amount (COP).
minBedrooms	integer	no	(none)	Only return listings with at least this many bedrooms.
minArea	integer	no	(none)	Only return listings with at least this much area in square meters.
maxListings	integer	no	10	Maximum listings to collect. Free Apify plans are capped at 10 per run.

Output reference

One dataset item per listing. Types: string, number, object, array, or null when the source value is absent.

Field	Type	Description
imageUrl	string	Primary image URL.
title	string	Listing title.
url	string	Direct link to the listing.
id	string	Metrocuadrado listing identifier.
operation	string	sale or rent.
price	number	Price in Colombian pesos (COP).
currency	string	Currency code, COP.
propertyType	string	Property type, for example Apartamento, Casa.
propertyStatus	string	For example Nuevo, Usado.
estrato	number	Colombian socioeconomic stratum.
bedrooms	number	Number of bedrooms.
bathrooms	number	Number of bathrooms.
garages	number	Number of parking spaces.
area	number	Total area in square meters.
privateArea	number	Private area in square meters.
pricePerM2	number	Price per square meter (COP).
city	string	City.
zone	string	Zone within the city.
neighborhood	string	Neighborhood.
latitude	number	Latitude.
longitude	number	Longitude.
projectName	string	Development/project name, or null.
offeredBy	string	Who offers the listing, for example agency, owner.
ownerType	string	Owner type, for example Constructora.
agencyId	string	Agency identifier, or null.
agentPhone	string	Agent phone number, or null.
agencyPhone	string	Agency phone number, or null.
branchPhone	string	Branch phone number, or null.
whatsapp	string	WhatsApp contact number, or null.
housingType	string	For example VIS, No VIS.
category	string	Listing category.
constructedArea	number	Constructed area in square meters.
contactCount	number	Number of contacts/leads recorded on the listing.
listedAt	string	Listing date when available, else null.
nearbyPlaces	object[]	Nearby places, each with name, address, latitude, longitude.
description	string	Full listing description.
features	object	Structured feature attributes (kitchen type, laundry, deposits, and more).
images	string[]	All image URLs on the listing.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"startUrl": "https://www.metrocuadrado.com/apartamentos/venta/bogota/", "maxListings": 10}):

{
  "title": "Apartamento en Venta, EL PORVENIR, Bogotá D.C.",
  "url": "https://www.metrocuadrado.com/proyecto/caney-reservado-fontibon/1654-C0017-05",
  "id": "1654-C0017-05",
  "operation": "sale",
  "price": 133200000,
  "currency": "COP",
  "propertyType": "Apartamento",
  "propertyStatus": "Nuevo",
  "estrato": 3,
  "bedrooms": 2,
  "bathrooms": 1,
  "area": 37.92,
  "pricePerM2": 3512658,
  "city": "Bogotá D.C.",
  "neighborhood": "EL PORVENIR",
  "latitude": 4.6890154,
  "longitude": -74.16353,
  "projectName": "CANEY RESERVADO FONTIBON",
  "offeredBy": "agency",
  "ownerType": "Constructora",
  "agentPhone": "3167273693",
  "whatsapp": "573167273693",
  "housingType": "VIS",
  "contactCount": 15,
  "observedAt": "2026-08-10T14:17:56.252Z",
  "error": null
}

Some fields are omitted here for length; live runs return every field listed above with real values.

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~metrocuadrado-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"city":"medellin","operation":"arriendo","propertyType":"apartamentos","minBedrooms":2,"maxListings":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~metrocuadrado-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrl":"https://www.metrocuadrado.com/casas/venta/cali/","maxPrice":500000000,"maxListings":100}'

Apify CLI:

apify call scrapers_lat/metrocuadrado-scraper \
  --input '{"city":"cartagena","operation":"venta","propertyType":"casas","maxListings":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per record returned (result event). See the pricing tab for the current per-result price.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxListings.

FAQ and troubleshooting

A run returned 0 records. Why? The search or filters matched nothing. Loosen minPrice, maxPrice, minBedrooms or minArea, or try another city or property type. Zero-result runs are not charged.

Should I use startUrl or the search builder? Either. Paste a startUrl copied from the site after applying filters for full control, or set city, operation and propertyType to build the search. When startUrl is set, the builder fields are ignored.

How do I get contact phone numbers? Records include agentPhone, agencyPhone, branchPhone and whatsapp when the listing exposes them. Missing values are returned as null, never invented.

How do I get rentals instead of sales? Set operation to arriendo, or use a rental startUrl.

Is this an official Metrocuadrado tool? No. This actor is independent and has no affiliation with Metrocuadrado. It reads only data that is publicly available on the site.

Related scrapers

• Fincaraiz Scraper: Colombian property listings on Fincaraiz.
• Adondevivir Scraper: Property listings across Latin America.
• InfoCasas Scraper: Property listings on InfoCasas.
• Compreoalquile Scraper: Panama property listings.
• Encuentra24 Scraper: Central American classifieds and property.
• Carroya Colombia Scraper: Colombian vehicle listings.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Metrocuadrado. Accesses only publicly available data.