Metrocuadrado Scraper

Extract structured real estate listings from Metrocuadrado.com, Colombia's largest property platform. Covers Bogotá, Medellín, Cali and every major Colombian city, for both sale and rent. Filter by price, area, rooms, stratum or a map radius. No API key required.

---

Why this scraper?

🏙️ Full national coverage

Sale (venta) and rent (arriendo) listings across all Colombian cities and property types: apartments, houses, offices, commercial units, land, warehouses, ranches and parking.

📊 55 structured fields per listing

Price, price per m², area breakdowns, rooms, bathrooms, garages, stratum, building age, floor, amenities, GPS coordinates, neighbourhood and zone, photos and full descriptions — every field parsed and typed.

🎯 Precise search filters

Narrow results by minimum and maximum price, area range, minimum rooms and bathrooms, and socioeconomic stratum. All filters combine.

📍 Map-radius search

Provide a latitude, longitude and radius to return only listings within a set distance of any point, each tagged with its distance in kilometres.

🔗 Filter or feed your own URLs

Use the built-in filters, or paste Metrocuadrado search URLs directly.

---

Input parameters

All parameters are optional. Filters combine — set only the ones you need.

Parameter	Type	Default	Description
operationType	string	sale	sale (venta) or rent (arriendo).
propertyType	string	apartment	apartment, house, office, commercial, land, warehouse, ranch, parking or other.
city	string	bogota	City slug, e.g. bogota, medellin, cali, barranquilla, cartagena.
maxItems	integer	5	Maximum number of listings to return.
minPrice	integer	—	Minimum price in Colombian pesos (COP).
maxPrice	integer	—	Maximum price in Colombian pesos (COP).
minAreaM2	integer	—	Minimum total area in square metres.
maxAreaM2	integer	—	Maximum total area in square metres.
minRooms	integer	—	Minimum number of bedrooms.
minBathrooms	integer	—	Minimum number of bathrooms.
stratum	integer	—	Colombian socioeconomic stratum (1–6).
centerLat	number	—	Latitude of the map-radius center.
centerLng	number	—	Longitude of the map-radius center.
radiusKm	number	—	Radius in kilometres. Requires centerLat and centerLng.
startUrls	array	—	Optional Metrocuadrado search URLs to scrape directly. Overrides the filters above.

---

Output schema

Every field below is present on every record. Fields the source does not publish for a given listing are returned as null rather than omitted.

Field	Type	Description
id	string	Unique Metrocuadrado listing ID.
url	string	Canonical listing detail URL.
title	string	Listing title.
operationType	string	venta (sale) or arriendo (rent).
propertyType	string	Property type in Spanish (e.g. apartamento, casa).
priceText	string	Price as displayed, e.g. COP 410.000.000.
priceAmount	number	Numeric price in COP.
priceCurrency	string	Always COP.
pricePerM2	number|null	Price per square metre in COP (null when area is unknown).
adminFee	number|null	Monthly administration fee in COP (null if not published).
adminFeeText	string|null	Administration fee as displayed.
neighborhood	string|null	Neighbourhood (barrio).
zone	string|null	City zone.
city	string	City name.
country	string	Always CO.
bedrooms	number|null	Number of bedrooms.
bathrooms	number|null	Number of bathrooms.
garages	number|null	Number of garages/parking spaces.
surfaceTotal	number|null	Total area in m².
surfaceCovered	number|null	Covered (built) area in m².
surfacePrivate	number|null	Private area in m² (mostly on new-construction listings).
surfaceUnit	string	Always m².
buildingAge	string|null	Age band, e.g. Entre 10 y 20 años.
floorNumber	number|null	Floor number.
stratum	number|null	Socioeconomic stratum (1–6).
propertyState	string|null	Condition, e.g. Nuevo, Usado.
ownerType	string|null	Advertiser type, e.g. Constructora, Inmobiliaria, Persona natural.
projectName	string|null	New-construction project name (null for resale).
housingType	string|null	Housing programme type, e.g. VIS, NOVIS.
badge	string|null	Listing badge, e.g. Proyecto de vivienda.
promoFlags	array	Active promotion tiers on the listing.
hasElevator	boolean|null	Whether the building has an elevator.
gatedCommunity	boolean|null	Whether the property is in a gated community.
hasPool	boolean|null	Whether the property has a pool.
nearPublicTransport	boolean|null	Whether the property is near public transport.
category	string|null	Listing category.
hasWhatsappBot	boolean|null	Whether the advertiser has a WhatsApp bot enabled (aggregate flag, no contact data).
contactsCount	number|null	Number of times the listing has been contacted.
signwall	boolean|null	Whether the listing sits behind a sign-in wall.
locationApproximate	boolean|null	Whether the map location is approximate.
companyId	string|null	Internal advertiser company ID.
orderScore	number|null	Source ranking score.
features	array	Amenity list parsed from the listing.
thumbnail	string|null	Primary photo URL.
imageCount	number	Number of photos.
images	array	All photo URLs.
coordinates	object|null	{ lat, lon } GPS coordinates.
distanceKm	number|null	Distance in km from the map-radius center (null unless a radius search is used).
nearbyPlaces	array	Nearby points of interest, each with name, address and coordinates.
descriptionHtml	null	Always null — the source publishes descriptions as plain text.
descriptionText	string|null	Full listing description, plain text.
descriptionMarkdown	string|null	Full listing description, same text as Markdown.
source	string	Always metrocuadrado.com.
scrapedAt	string	ISO 8601 timestamp of extraction.
contentHash	string	Stable hash of ID + price + rooms for change detection.

Example record

{
  "id": "MC6705726",
  "url": "https://www.metrocuadrado.com/inmueble/venta-apartamento-bogota/mc6705726",
  "title": "Apartamento en Venta, LA SALLE Chapinero Alto, Bogotá D.C.",
  "operationType": "venta",
  "propertyType": "apartamento",
  "priceText": "COP 410.000.000",
  "priceAmount": 410000000,
  "priceCurrency": "COP",
  "pricePerM2": 7663551,
  "adminFee": 380000,
  "adminFeeText": "COP 380.000",
  "neighborhood": "LA SALLE",
  "zone": "Chapinero",
  "city": "Bogotá D.C.",
  "country": "CO",
  "bedrooms": 1,
  "bathrooms": 1,
  "garages": 1,
  "surfaceTotal": 53.5,
  "surfaceCovered": 54.45,
  "surfacePrivate": null,
  "surfaceUnit": "m²",
  "buildingAge": "Entre 10 y 20 años",
  "floorNumber": 4,
  "stratum": 4,
  "propertyState": "Usado",
  "ownerType": "Inmobiliaria",
  "projectName": null,
  "housingType": null,
  "badge": null,
  "promoFlags": ["nitro"],
  "hasElevator": true,
  "gatedCommunity": true,
  "hasPool": false,
  "nearPublicTransport": true,
  "category": "Tradicional",
  "hasWhatsappBot": true,
  "contactsCount": 12,
  "signwall": false,
  "locationApproximate": false,
  "companyId": "9063",
  "orderScore": 0.87,
  "features": ["ascensor", "parqueadero Visitantes", "conjunto Cerrado"],
  "thumbnail": "https://multimedia.metrocuadrado.com/MC6705726/MC6705726_1_p.jpg",
  "imageCount": 12,
  "images": ["https://multimedia.metrocuadrado.com/MC6705726/MC6705726_1_p.jpg"],
  "coordinates": { "lat": 4.64442, "lon": -74.05724 },
  "distanceKm": 0.87,
  "nearbyPlaces": [{ "name": "Parque de la 93", "address": "Calle 93", "latitude": 4.6765, "longitude": -74.0483 }],
  "descriptionHtml": null,
  "descriptionText": "Este amplio y acogedor apartamento (53,5 m² de área privada) cuenta con...",
  "descriptionMarkdown": "Este amplio y acogedor apartamento (53,5 m² de área privada) cuenta con...",
  "source": "metrocuadrado.com",
  "scrapedAt": "2026-07-10T07:22:00.000Z",
  "contentHash": "a1b2c3d4e5f60718"
}

---

Examples

Apartments for sale in Bogotá:

{
  "operationType": "sale",
  "propertyType": "apartment",
  "city": "bogota",
  "maxItems": 100
}

Houses for rent in Medellín, 3+ bedrooms, under 8,000,000 COP:

{
  "operationType": "rent",
  "propertyType": "house",
  "city": "medellin",
  "minRooms": 3,
  "maxPrice": 8000000,
  "maxItems": 100
}

Sale listings within 3 km of a point in Bogotá:

{
  "operationType": "sale",
  "propertyType": "apartment",
  "city": "bogota",
  "centerLat": 4.6486,
  "centerLng": -74.0639,
  "radiusKm": 3,
  "maxItems": 100
}

Scrape a Metrocuadrado search URL directly:

{
  "startUrls": [
    "https://www.metrocuadrado.com/inmuebles/venta/apartamento/bogota/"
  ],
  "maxItems": 100
}

---

💰 Pricing

From $1.49 per 1,000 results — you only pay for listings successfully retrieved. Failed retries are never charged. Volume discounts step the price down to $0.90 per 1,000 at the highest tier.

Results	Cost
100	~$0.15
1,000	~$1.49
10,000	~$14.90
100,000	~$149.00

Flat-rate alternatives typically charge $29–$49/month regardless of usage.

Use the Maximum Results cap in the input to control your spend exactly.

---

Performance

Run size	Typical time
5 results	under 30 seconds
100 results	1–2 minutes
1,000 results	8–15 minutes

---

Known limitations

• Administration fee, private area, project name and building badge are published mainly for new-construction listings and are null on many resale listings.
• Descriptions are plain text at the source, so descriptionHtml is always null.
• The source caps pagination at 10,000 entries per search; narrow with filters to reach listings beyond that.
• Map-radius search filters within the chosen city's result set using each listing's published coordinates; listings without coordinates are excluded from radius results.

---

Technical details

• Source: metrocuadrado.com — Colombian real estate listings
• Push notifications: get new results delivered to Telegram, Discord, Slack, WhatsApp or any webhook the moment a scheduled run finds them
• Coverage: nationwide, filterable by city, price, area, rooms, stratum and map radius
• Retry: automatic retry on network errors with exponential backoff

---

Rate this actor

If this scraper does its job, a short review on the Reviews tab helps other users find it. Something not working? Open an issue on the Issues tab instead — issues get fixed.

---

Need a custom scraper?

Unfenced Group builds Apify actors for any website — for free.

If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio.

Get in touch: www.unfencedgroup.nl