Metrocuadrado Scraper

Metrocuadrado Real Estate Listings Scraper

Metrocuadrado Scraper extracts public sale and rental listings rendered on Metrocuadrado.com and saves structured records. No Metrocuadrado login is required; live Free-plan pricing is in the Pricing section.

• Scrape one record per listing, omitting values not published on the page.
• Compare sale and rental inventory by city and property type with price, area, room, stratum, and radius filters.
• Build datasets for Colombian property-market research and listing discovery.
• Analyze coordinates, approximate locations, photos, and published attributes when available.
• Export clean JSON or CSV records ready for spreadsheets, BI tools, or the Apify API.

What you get

Records use data available in rendered Metrocuadrado search results. Unpublished fields are omitted.

Field group	Fields	What they contain	Availability
Identity	id, url, title	Listing ID, detail URL, and title	A valid ID and Metrocuadrado URL are required
Transaction	operationType, propertyType, priceAmount, priceCurrency, pricePerM2	Operation, property type, COP price, currency, and price per square metre	Price requires a usable price; pricePerM2 also requires total area
Area	areaTotalM2, areaCoveredM2, areaPrivateM2	Total, covered, and private area in square metres	Optional and page-dependent
Counts	bedrooms, bathrooms, garages, contactsCount, stratum	Rooms, bathrooms, garages, contacts, and stratum	Optional published values
Location	city, zone, neighborhood, coordinates, approximateLocation, distanceKm	Location names, coordinates, approximate marker, and calculated distance	distanceKm requires radius filtering with coordinates
Property details	propertyState, ownerType, projectName, housingType, badge, category, companyId	Published property, owner, project, housing, badge, category, and company data	Optional published values
Published attributes	features	Feature strings such as kitchen, heating, or room attributes	Included when provided
Media	thumbnail, images, imageCount	Thumbnail, gallery URLs, and image count	Included when image data is available
Run metadata	source, scrapedAt	Source domain and UTC scrape timestamp	Added to each record

Sample output

This real dataset record is shortened to the main listing fields; additional fields from the table above are included when present.

{
  "id": "21477-C0001-03",
  "url": "https://www.metrocuadrado.com/proyecto/dual-101/21477-C0001-03",
  "title": "Apartamento en Venta, RINCON DEL CHICO, Bogotá D.C.",
  "operationType": "Venta",
  "propertyType": "Apartamento",
  "priceAmount": 1470000000,
  "priceCurrency": "COP",
  "pricePerM2": 10652173.91,
  "areaTotalM2": 138,
  "areaCoveredM2": 138,
  "bedrooms": 3,
  "bathrooms": 3,
  "garages": 1,
  "city": "Bogotá D.C.",
  "neighborhood": "RINCON DEL CHICO",
  "stratum": 6,
  "propertyState": "Nuevo",
  "thumbnail": "https://multimedia.metrocuadrado.com/21477-C0001-03/21477-C0001-03_1_V3_p.jpg"
}

Pricing

You pay for the Actor Start and scraped-result events listed below.

Charge event	Billing unit	Free-plan price
apify-actor-start	One Actor Start event	$0.00005 per event on the Free plan
apify-default-dataset-item	One scraped result with all fields	$0.0011 per event on the Free plan

For a run with one Actor Start event and 1,000 dataset items, the listed charges are $0.00005 + (1,000 × $0.0011) = $1.10005 on the Free plan.

For a run with one Actor Start event and 10,000 dataset items, the listed charges are $0.00005 + (10,000 × $0.0011) = $11.00005 on the Free plan.

The Apify Free plan includes $5 of monthly platform usage credit. At these Free-plan rates, the exact result count calculated from that credit is 4,545 dataset items.

Platform usage is separate from the Actor event charges. For this pay-per-event Actor, compute, Apify Proxy traffic including residential traffic, and storage are included in the event prices and paid by the Actor developer. Users are not charged separately for that platform usage.

How to use

1. Choose sale or rent with operationType.
2. Select a supported propertyType and enter a city slug such as bogota, medellin, or cali.
3. Apply optional price, area, bedroom, bathroom, stratum, or radius filters.
4. Provide Metrocuadrado search URLs in startUrls to replace the generated search.
5. Keep the default proxyConfiguration (Apify Proxy, RESIDENTIAL group); a run with useApifyProxy set to false is not verified.
6. Run the Actor and inspect the dataset records.
7. Repeat the run through Apify Schedules; daily is a starting point for listing collection.

{
  "operationType": "sale",
  "propertyType": "apartment",
  "city": "bogota",
  "maxResults": 50,
  "minPrice": 500000000,
  "maxAreaM2": 200,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Export the dataset as JSON or CSV, or read it through the Apify dataset API.

Input parameters

Parameter	What it does	Default
operationType	Searches listings for sale or rent.	sale
propertyType	Selects apartment, house, office, commercial, land, warehouse, ranch, parking, or any.	apartment
city	Uses a city slug in the generated Metrocuadrado search path.	bogota
maxResults	Maximum listings saved across supplied search pages (allowed 1 to 10000); each search page supplies only the listings on that page.	50
minPrice	Keeps listings at or above this COP price.	Not set
maxPrice	Keeps listings at or below this COP price.	Not set
minAreaM2	Keeps listings with at least this total area.	Not set
maxAreaM2	Keeps listings with no more than this total area.	Not set
minRooms	Keeps listings with at least this many bedrooms.	Not set
minBathrooms	Keeps listings with at least this many bathrooms.	Not set
stratum	Keeps listings in the specified Colombian socioeconomic stratum.	Not set
centerLat	Map-center latitude; use with centerLng for radius filtering.	Not set
centerLng	Map-center longitude; use with centerLat for radius filtering.	Not set
radiusKm	Keeps listings within this distance of the map center.	Not set
startUrls	Optional Metrocuadrado search-page objects replacing the generated search.	[]
proxyConfiguration	Apify Proxy settings; the proxy is used when useApifyProxy is true.	useApifyProxy true, group RESIDENTIAL

maxResults is a cap, not a target: it accepts integers from 1 to 10000, but a run saves at most the listings found on the search pages it fetches.

Limits and edge cases

Condition	What you see	What to do
Each search URL is fetched once, with no pagination	One run saves only the listings on that page, even with a high maxResults. Filters are applied after fetching, so they can only reduce that count.	Supply several search-page URLs in startUrls to get more records.
A search has fewer matching listings than maxResults	The dataset has fewer records than requested.	Broaden filters or provide more search pages in startUrls.
Multiple search pages are supplied	One maxResults cap applies across all pages; saved IDs are not duplicated.	Set a combined cap and use distinct pages.
startUrls has no valid Metrocuadrado search URL	A warning is logged and no search page is processed. Valid URLs use http or https and the metrocuadrado.com domain or subdomain.	Supply search-page objects with the required url.
A supplied page has no server-rendered listings result set	The page is skipped and a warning is logged.	Use a search page containing rendered listing result data.
A price, area, room, bathroom, or stratum filter is set but a listing lacks that field	The listing does not match and is not saved.	Remove the filter or use listings that publish the value.
radiusKm is set without both centerLat and centerLng	A warning is logged and processing stops before the search.	Provide both numeric center coordinates.
Radius filtering is active and a listing has no coordinates	The listing is excluded.	Remove the radius filter or use coordinate data.
A listing does not publish an optional field	The field is omitted; empty descriptions, fees, and other unpublished fields are not added.	Use the fields present in each record.
A page fetch encounters an eligible request failure or server error	The fetch path retries up to three attempts. If it still fails, the page is skipped; records already pushed remain.	Review the log and retry.

FAQ

How much does it cost to scrape Metrocuadrado?

On the Free plan, an Actor Start event costs $0.00005 and each dataset item costs $0.0011. A run with one start event and 1,000 results totals $1.10005 on the Free plan.

Why is my result dataset empty?

Possible causes include no matching listings, invalid startUrls, a page without a server-rendered result set, or radius filtering excluding listings without coordinates. Check the URL, loosen filters, or remove the radius filter.

What happens if one of my search pages does not work?

The page is skipped with a warning. Other supplied pages can continue, and records already saved remain in the dataset. Review the run log and verify the Metrocuadrado search URLs.

Is scraping public Metrocuadrado data legal or allowed?

The Actor collects public listing data rendered on Metrocuadrado search pages. Whether a use is legal or allowed depends on Metrocuadrado’s source terms and applicable law for your use case; review those requirements before running it.

Related actors

• FincaRaíz Property Scraper — related property-listing Actor.
• Chaves na Mão Property Listings — related property-listing Actor.
• QuintoAndar Property Listings Scraper — related property-listing Actor.