# Metrocuadrado Colombia Real Estate Scraper (`scrapers_lat/metrocuadrado-scraper`) Actor
Scrape Metrocuadrado Colombia real estate listings: price, estrato, bedrooms, bathrooms, area, coordinates, agent contact and photos.
- **URL**: https://apify.com/scrapers\_lat/metrocuadrado-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
[](https://console.apify.com/actors/dhgwGTuad7AGJofUp/input)
## Metrocuadrado Colombia Real Estate Scraper
> Extract real estate listings from Metrocuadrado, Colombia's largest property portal, with socioeconomic stratum (estrato), GPS coordinates and agent contact across 20+ cities
33 fields per record
Colombia coverage
JSON / CSV / Excel output formats
### What you get
Each record is a full property listing with price, location, GPS coordinates, the Colombian socioeconomic stratum (estrato), and seller or agency contact details, ready for market analysis, lead generation or price modeling.
- **imageUrl**: main listing photo
- **title**: listing headline
- **url**: link to the listing on Metrocuadrado
- **id**: Metrocuadrado listing identifier
- **operation**: sale or rent
- **price**: asking price (sale value or monthly rent)
- **currency**: price currency (COP)
- **propertyType**: apartment, house, office, retail, warehouse, lot and more
- **propertyStatus**: new or used
- **estrato**: Colombian socioeconomic stratum, 1 to 6
- **bedrooms**: number of bedrooms
- **bathrooms**: number of bathrooms
- **garages**: number of parking spaces
- **area**: total area in square meters
- **privateArea**: private built area in square meters
- **city**: city name
- **zone**: city zone or sector
- **neighborhood**: neighborhood name
- **latitude**: approximate latitude
- **longitude**: approximate longitude
- **projectName**: development project name for new construction
- **offeredBy**: whether the listing is from an agency or an owner
- **ownerType**: builder, real estate agency or individual seller
- **agencyId**: Metrocuadrado agency identifier
- **agentPhone**: contact phone number
- **whatsapp**: WhatsApp contact number
- **housingType**: VIS, VIP or non subsidized housing classification
- **category**: listing category
- **description**: full listing description text
- **features**: amenities and characteristics map
- **images**: full photo gallery
- **observedAt**: when this listing was last seen by the scraper
### Who is it for
| Use case | Who benefits |
|---|---|
| Track asking prices by city and stratum | Real estate analysts and appraisers |
| Build buyer or seller lead lists with phone and WhatsApp | Agents and brokerages |
| Map inventory by neighborhood with GPS coordinates | PropTech and GIS teams |
| Monitor new construction projects and developers | Investors and builders |
| Feed price and area data into valuation models | Data scientists and lenders |
### Frequently Asked Questions
**Which cities and property types does this cover?**
It covers Metrocuadrado listings across Colombia, including Bogota, Medellin, Cali, Barranquilla, Cartagena and 15 more cities. Property types include apartments, houses, studios, offices, retail spaces, warehouses, lots and country estates, for both sale and rent.
**How many listings can I scrape in one run?**
Each search has tens of thousands of listings and you control the volume with the Max Items setting. A single city and property type query like apartments for sale in Bogota exposes tens of thousands of records that the scraper pages through.
**Can I scrape a specific search I built on the site?**
Yes. Apply your filters on Metrocuadrado, copy the results URL from your browser and paste it into the Search URL field. You can also build a search from scratch using the City, Operation and Property Type dropdowns.
**What is the estrato field and why does it matter?**
Estrato is Colombia's official socioeconomic stratification from 1 to 6, used for utility pricing and as a strong proxy for neighborhood income level. It is included on every residential listing and is one of the most valuable signals for pricing and targeting in the Colombian market.
**What happens with fields that are not always present?**
Fields like private area, project name and housing type only apply to certain listings, such as new construction projects, and are returned empty for resale listings from individual sellers. Contact details, price, area, stratum and coordinates are populated on the vast majority of records.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Bogota Apartments for Sale (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-bogota-apartments-for-sale): Scrape apartments for sale in Bogota from Metrocuadrado. Extract price, area, rooms, bathrooms, neighborhood, photos and listing details.
- [Bogota Apartments for Rent (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-bogota-apartments-for-rent): Scrape apartment rentals (arriendo) in Bogota from Metrocuadrado. Extract monthly rent, area, rooms, bathrooms, zone, photos and links.
- [Bogota Houses for Sale (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-bogota-houses-for-sale): Scrape houses (casas) for sale in Bogota from Metrocuadrado. Extract price, lot and built area, rooms, bathrooms, location and photos.
- [Medellin Apartments for Rent (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-medellin-apartments-for-rent): Scrape apartment rentals (arriendo) in Medellin from Metrocuadrado. Extract monthly rent, area, rooms, bathrooms, barrio, photos and links.
- [Medellin Houses for Sale (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-medellin-houses-for-sale): Scrape houses (casas) for sale in Medellin from Metrocuadrado. Extract price, area, rooms, bathrooms, neighborhood, photos and listing links.
- [Medellin Studios for Rent (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-medellin-studios-for-rent): Scrape studio apartments (apartaestudios) for rent in Medellin from Metrocuadrado. Extract rent, area, bathrooms, zone, photos and links.
- [Cali Apartments for Sale (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-cali-apartments-for-sale): Scrape apartments for sale in Cali from Metrocuadrado. Extract price, area, rooms, bathrooms, neighborhood, photos and listing details.
- [Cali Houses for Rent (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-cali-houses-for-rent): Scrape houses (casas) for rent in Cali from Metrocuadrado. Extract monthly rent, lot and built area, rooms, bathrooms, location and photos.
- [Barranquilla Apartments for Rent (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-barranquilla-apartments-for-rent): Scrape apartment rentals (arriendo) in Barranquilla from Metrocuadrado. Extract rent, area, rooms, bathrooms, zone, photos and links.
- [Barranquilla Apartments for Sale (Metrocuadrado)](https://apify.com/scrapers_lat/metrocuadrado-scraper/examples/metrocuadrado-barranquilla-apartments-for-sale): Scrape apartments for sale in Barranquilla from Metrocuadrado. Extract price, area, rooms, bathrooms, neighborhood, photos and links.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [InfoCasas Real Estate Listings Scraper](https://apify.com/scrapers_lat/infocasas-scraper): Scrape Infocasas real estate listings across Uruguay, Paraguay and more. Extract price, currency...
- [Urbania Peru Property Listings Scraper](https://apify.com/scrapers_lat/urbania-scraper): Scrape Urbania property listings in Peru. Extract price, currency, operation, property type...
- [Adondevivir Peru Property Listings Scraper](https://apify.com/scrapers_lat/adondevivir-scraper): Scrape Adondevivir property listings in Peru. Extract price, currency, operation, property type...
- [MercadoLibre Product Listings Scraper](https://apify.com/scrapers_lat/mercadolibre-scraper): Extract products, prices and seller data from MercadoLibre across 18 LATAM countries. Scrape...
- [Quince Product Scraper](https://apify.com/scrapers_lat/quince-scraper): Extract Quince.com products with prices, traditional retail price, discounts, variants, images and...
- [Rappi Restaurants & Stores Scraper](https://apify.com/scrapers_lat/rappi-scraper): Scrape restaurants and stores from Rappi Colombia! Extract store name, logo, category, rating...
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with Metrocuadrado. It only accesses data that is publicly available on the platform. Use it in accordance with Metrocuadrado's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of listings to collect. Optional.
## `startUrl` (type: `string`):
A Metrocuadrado search/results URL to scrape, e.g. https://www.metrocuadrado.com/apartamentos/venta/bogota/ . Copy it from your browser after applying filters on the site. If provided, it overrides the City / Operation / Property Type fields below.
## `city` (type: `string`):
City to search in. Used only when no Search URL is provided.
## `operation` (type: `string`):
Sale (venta) or rent (arriendo). Used only when no Search URL is provided.
## `propertyType` (type: `string`):
Type of property. Used only when no Search URL is provided.
## `proxyConfiguration` (type: `object`):
Proxy settings. The site works from datacenter IPs, so a proxy is optional. Enable Colombia residential proxies if you hit rate limits on deep pagination.
## Actor input object example
```json
{
"maxItems": 10,
"startUrl": "https://www.metrocuadrado.com/apartamentos/venta/bogota/",
"city": "bogota",
"operation": "venta",
"propertyType": "apartamentos",
"proxyConfiguration": {
"useApifyProxy": false
}
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"startUrl": "https://www.metrocuadrado.com/apartamentos/venta/bogota/"
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/metrocuadrado-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"startUrl": "https://www.metrocuadrado.com/apartamentos/venta/bogota/",
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/metrocuadrado-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"startUrl": "https://www.metrocuadrado.com/apartamentos/venta/bogota/"
}' |
apify call scrapers_lat/metrocuadrado-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/metrocuadrado-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Metrocuadrado Colombia Real Estate Scraper",
"description": "Scrape Metrocuadrado Colombia real estate listings: price, estrato, bedrooms, bathrooms, area, coordinates, agent contact and photos.",
"version": "0.1",
"x-build-id": "EIezW4gW4TcMKJZMU"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~metrocuadrado-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-metrocuadrado-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~metrocuadrado-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-metrocuadrado-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~metrocuadrado-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-metrocuadrado-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of listings to collect. Optional."
},
"startUrl": {
"title": "Search URL",
"type": "string",
"description": "A Metrocuadrado search/results URL to scrape, e.g. https://www.metrocuadrado.com/apartamentos/venta/bogota/ . Copy it from your browser after applying filters on the site. If provided, it overrides the City / Operation / Property Type fields below."
},
"city": {
"title": "City",
"enum": [
"bogota",
"medellin",
"cali",
"barranquilla",
"cartagena",
"bucaramanga",
"pereira",
"manizales",
"cucuta",
"santa-marta",
"ibague",
"villavicencio",
"armenia",
"pasto",
"monteria",
"neiva",
"popayan",
"valledupar",
"chia",
"cajica"
],
"type": "string",
"description": "City to search in. Used only when no Search URL is provided.",
"default": "bogota"
},
"operation": {
"title": "Operation",
"enum": [
"venta",
"arriendo"
],
"type": "string",
"description": "Sale (venta) or rent (arriendo). Used only when no Search URL is provided.",
"default": "venta"
},
"propertyType": {
"title": "Property Type",
"enum": [
"apartamentos",
"casas",
"apartaestudios",
"oficinas",
"locales",
"bodegas",
"lotes",
"fincas",
"consultorios",
"parqueaderos"
],
"type": "string",
"description": "Type of property. Used only when no Search URL is provided.",
"default": "apartamentos"
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Proxy settings. The site works from datacenter IPs, so a proxy is optional. Enable Colombia residential proxies if you hit rate limits on deep pagination.",
"default": {
"useApifyProxy": false
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```