Scrappa is an independent Metrocuadrado API for metrocuadrado.com, one of Colombia's largest property marketplaces. Search apartments, houses, plots, offices and new developments for sale (venta) or rent (arriendo), fetch the full record for any listing, expand a new development into its individual units, resolve Colombian cities and neighbourhoods, and read the property type and deal type vocabularies as structured JSON. Scrappa is not affiliated with or endorsed by metrocuadrado.com.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/metrocuadrado/search?business_type=venta&property_type=1&city=bogota&neighborhood=chapinero" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"{
"success": true,
"source": "mobile",
"total_hits": 770,
"returned": 1,
"page": 1,
"page_size": 48,
"from": 0,
"exceeds_offset_ceiling": false,
"subdivide_by": null,
"results": [
{
"id": "20622-M6020965",
"title": "Apartamento en venta, Chapinero, Bogota",
"url": "https://www.metrocuadrado.com/inmueble/apartamento-venta/chapinero/20622-M6020965",
"image": "https://multimedia.metrocuadrado.com/20622-M6020965/20622-M6020965_1_p.jpg",
"city": "Bogota",
"status": "usado",
"price_sale": 1650000000,
"price_lease": null,
"admin_fee": 1080000,
"area_m2": 380,
"bedrooms": 5,
"bathrooms": 5,
"garages": 4,
"admin_included": true,
"spotlight": false
}
]
}Structured data for real applications. Here are some ideas.
Track new supply in Bogotá, Medellín, Cali and the rest of the country as it is published. Page by city and neighbourhood, filter by price, area and rooms, and alert on what appeared since your last run.
Compare asking prices and price per square metre across neighbourhoods by subdividing a city search, which is the only way to read a large market in full.
Expand a new-build search result into the individual units of its development, with unit price, area and room counts, so a launch can be tracked unit by unit.
Fill a property app or CRM with the full record: description, gallery, features, price split including the administration fee, agency attribution and coordinates.
Feed housing research and dashboards with structured sale and rent inventory by city, neighbourhood, property type and stratum.
Metrocuadrado scraper API
The Metrocuadrado API is built for proptech developers, analysts, and anyone covering the Colombian housing market. Instead of maintaining your own metrocuadrado.com scraper, call Scrappa with an API key to search sale and rent listings, open the full record for a listing, expand a new development into its units, and resolve locations. Search responses return 48 listing cards per page plus the true result total, not a capped count.
Search eleven property types, including apartments, houses, plots, offices, retail, farms and studio apartments, for venta (sale) or arriendo (rent).
Filter by city and neighbourhood, price in Colombian pesos, area in square metres, room counts, stratum, free-text keyword and publisher id.
Run a radius search with latitude, longitude and distance together, or read coordinates from the listing details endpoint.
Get the full listing record by id, including description, gallery, features, the sale or lease price split with its administration fee, and the agency attribution.
Expand a new development into its units so a project with a handful of search entries can be enumerated unit by unit.
Autocomplete Colombian cities and neighbourhoods, and resolve the exact tokens your filters need — with the caveat that this vocabulary is capped and cannot enumerate a city.
Test the Metrocuadrado API with 500 free monthly Scrappa credits before scaling production traffic.
Search by business type, property type, city and neighbourhood, then narrow with price, area, rooms and stratum. Each card carries the listing id, title, link, image, city, condition, sale or lease price, administration fee, area in square metres, and room counts.
Search cards do not carry coordinates, so use the property endpoint when you need a map pin or a distance calculation. It also returns the description, the gallery and the feature list that search cards omit.
The source answers at most the first 10,000 rows of a cell and does so silently. When a search reports exceeds_offset_ceiling, subdivide it with a lat/long radius grid of 3 km or tighter and run one request per sub-area — inside a radius every returned listing is geo-referenced, so the grid cannot silently drop rows it can see. It is still not an exhaustive sweep: radius reaches only the geo-referenced subset, 98.8 percent for the Bogotá apartment cell and 89.9 percent of national sale inventory, so reconcile against the reported total rather than treating any sweep as complete. Do not build the partition from the locations vocabulary: its neighbourhood list is capped at 100 rows and covers only about 56 percent of Bogota.
Everything you need in one API.
/api/metrocuadrado/search
Search sale and rent listings by property type, city, neighbourhood, price, area, rooms, radius and sort order
/api/metrocuadrado/property
Get the full record for one listing id with description, gallery, features, price split and coordinates
/api/metrocuadrado/project
Expand a new development into its individual units with price, area and room counts
/api/metrocuadrado/locations
Autocomplete Colombian cities and neighbourhoods, and resolve location tokens for your filters
/api/metrocuadrado/types
List the property type and deal type vocabularies accepted by the search endpoint
Add Spanish, Italian, Portuguese and French property search and listing details to the same pipeline when your coverage spans Europe.
Add rental-focused search, price statistics and property imagery for Spanish and Portuguese rental markets.
Add Australian property search, agent profiles and suburb-level data when your real estate coverage is multi-region.
See how Scrappa compares to the official API.
| Feature | Scrappa | Generic scraping APIs |
|---|---|---|
| Dedicated metrocuadrado.com endpoints | ||
| Output format | Structured JSON | Raw HTML |
| Listing detail parsing | Built in | You write the parser |
| New development unit expansion | ||
| Silent truncation past 10,000 rows | Reported explicitly | Invisible |
| Parser maintenance | Handled by Scrappa | Your team |
| Price per 1k requests | From $0.20 | Varies by plan and credit multiplier |
| Free tier | 500 credits/month | Varies by provider |
The Metrocuadrado API is Scrappa's REST API for metrocuadrado.com, a major Colombian property marketplace. It returns listing search results, full listing records, new development units, location matches and the property type vocabulary as structured JSON.
No. Scrappa is an independent service and is not affiliated with or endorsed by metrocuadrado.com. You only need a Scrappa API key to use the five endpoints on this page.
The source answers at most the first 10,000 rows of a filter combination. The API reports this with exceeds_offset_ceiling so a truncated page is never mistaken for a complete one. Subdivide the search into sub-areas and run one request per sub-area — by lat/long radius, which covers the geo-referenced listings and cannot silently drop rows it can see. It is not an exhaustive sweep: radius reaches only the geo-referenced subset, 98.8 percent for the Bogota apartment cell and 89.9 percent of national sale inventory, so reconcile against the reported total rather than treating any sweep as complete, and listings with no coordinates are unreachable by radius. Do not subdivide by neighbourhood: the source's own neighbourhood vocabulary is capped at 100 rows and covers only about 56 percent of Bogota.
No — measured, and it does not work. The platform's own neighbourhood vocabulary returns at most 100 rows, hard-capped, and those rows are an alphabetical slice of a global list rather than one city's neighbourhoods. Summing Bogota's zones covers 56.1 percent of the city's listings, so a neighbourhood sweep silently misses the rest. Subdivide by radius instead: pass latitude, longitude and distance and page the sub-areas. Inside a radius every returned listing is geo-referenced — measured at 100 percent for 2, 3, 5 and 8 km — so a radius grid cannot silently drop rows it can see, which makes it much the better method. That 100 percent is the share of returned rows carrying coordinates, not the share of listings a sweep recovers: radius reaches only the geo-referenced subset, 98.8 percent for the Bogota apartment cell and 89.9 percent of national sale inventory. Start at 3 km or tighter: at 5 km the Bogota apartment cell is already past the row ceiling again, so the grid has to recurse. It is still not a provably exhaustive sweep — listings with no coordinates are unreachable by radius, around 2 percent of sale inventory and 6 percent of rent inventory — so no partition of this source is guaranteed complete. Reconcile against the reported total rather than trusting any sweep. The neighborhood filter itself works fine for targeting one area.
The source does not include coordinates on its search cards even though the underlying index has them for the large majority of listings. Call the listing details endpoint for a listing id to get its latitude and longitude, or use a radius search to filter by location.
Only as attribution. metrocuadrado.com publishes no public agency directory, so an agency appears on a listing as an attribution field and can be used as a search filter with company_id, but cannot be looked up as its own entity.
No. The filters work, but the source does not return facet metadata with the results, so any facet UI has to be built from paginated results rather than from a facets block.
Yes. Every Scrappa account includes 500 free credits per month, so you can test all five Metrocuadrado endpoints before buying credit packs or moving to a subscription.
Each request uses one Scrappa credit, and paid usage starts at $0.20 per 1,000 requests. The free tier includes 500 credits per month to get started with Colombian property data.