{ "openapi": "3.0.1", "info": { "title": "Metrocuadrado Scraper - Colombia Real Estate Listings", "description": "Extract Colombian listings from metrocuadrado.com with prices, locations, amenities, images, links, and contact data. Filter sales or rentals by location, property type, budget, rooms, area, and radius. Export JSON, CSV, Excel, API, or MCP-ready datasets for market research and lead generation", "version": "0.0", "x-build-id": "RLlljPYu3B5hMOSll" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~metrocuadrado-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-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/igolaizola~metrocuadrado-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-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/igolaizola~metrocuadrado-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-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", "required": [ "maxItems" ], "properties": { "maxItems": { "title": "Maximum listings", "minimum": 0, "type": "integer", "description": "Maximum number of property listings to save. Use 0 for unlimited results.", "default": 100 }, "location": { "title": "Location search", "type": "string", "description": "Enter a city, neighborhood, or zone. Example: Santa Marta." }, "locationType": { "title": "Location type", "enum": [ "", "city", "neighborhood", "zone" ], "type": "string", "description": "Optional category used to filter location suggestions. Leave as Any to select the first suggestion.", "default": "" }, "propertyCodes": { "title": "Property codes", "type": "array", "description": "Optional published property reference codes, for example 1614-C0051. When provided, other search filters are ignored.", "items": { "type": "string" } }, "operation": { "title": "Listing type", "enum": [ "buy", "buy-used", "buy-new", "rent" ], "type": "string", "description": "Select used and new sale listings, used sale listings, new sale listings, or rental listings.", "default": "buy" }, "sort": { "title": "Sort by", "enum": [ "price-asc", "price-desc", "date-asc", "date-desc", "bedrooms-asc", "bedrooms-desc", "area-asc", "area-desc" ], "type": "string", "description": "Choose the listing field and direction used to order matching results." }, "fetchDetails": { "title": "Fetch full listing details", "type": "boolean", "description": "Fetch additional details for every saved listing and place them under _details. This increases runtime and usage.", "default": false }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Choose one or more property types. Leave empty to include all types.", "items": { "type": "string", "enum": [ "apartment", "studio-apartment", "house", "office", "warehouse", "consulting-room", "commercial-property", "land", "farm", "office-building", "apartment-building" ], "enumTitles": [ "Apartment", "Studio apartment", "House", "Office", "Warehouse", "Consulting room", "Commercial property", "Land", "Farm", "Office building", "Apartment building" ] } }, "minPrice": { "title": "Minimum price (COP)", "minimum": 0, "type": "integer", "description": "Lowest sale or monthly rental price in Colombian pesos. Example: 200000000.", "default": 0 }, "maxPrice": { "title": "Maximum price (COP)", "minimum": 0, "type": "integer", "description": "Highest sale or monthly rental price in Colombian pesos. Example: 700000000.", "default": 0 }, "minArea": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Minimum built area in square metres. Example: 70.", "default": 0 }, "maxArea": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Maximum built area in square metres. Example: 180.", "default": 0 }, "bedrooms": { "title": "Bedrooms", "type": "array", "description": "Choose acceptable bedroom counts. The value 5 includes properties with five or more bedrooms.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1", "2", "3", "4", "5+" ] } }, "bathrooms": { "title": "Bathrooms", "type": "array", "description": "Choose acceptable bathroom counts. The value 5 includes properties with five or more bathrooms.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1", "2", "3", "4", "5+" ] } }, "garages": { "title": "Parking spaces", "type": "array", "description": "Choose acceptable parking space counts. The value 5 includes properties with five or more spaces.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1", "2", "3", "4", "5+" ] } }, "stratum": { "title": "Socioeconomic stratum", "type": "array", "description": "Choose one or more Colombian socioeconomic classifications.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8" ], "enumTitles": [ "Stratum 1", "Stratum 2", "Stratum 3", "Stratum 4", "Stratum 5", "Stratum 6", "Commercial", "Rural" ] } }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional feature or description keyword. Example: furnished." }, "buildTime": { "title": "Property age", "enum": [ "0-to-5-years", "5-to-10-years", "10-to-20-years", "over-20-years", "remodeled", "under-construction", "brand-new" ], "type": "string", "description": "Filter by property age or construction stage." }, "amenities": { "title": "Amenities", "type": "array", "description": "Choose one or more desired property or building amenities.", "items": { "type": "string", "enum": [ "security-24-7", "service-room", "gated-community", "storage-room", "pets-allowed", "bbq-area", "pool", "furnished", "elevator", "balcony", "gym" ], "enumTitles": [ "24/7 security", "Service room", "Gated community", "Storage room", "Pets allowed", "BBQ area", "Pool", "Furnished", "Elevator", "Balcony", "Gym" ] } }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Latitude in decimal degrees for a nearby search. Longitude is also required. Example: 4.711." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude in decimal degrees for a nearby search. Latitude is also required. Example: -74.0721." }, "distanceKm": { "title": "Distance (km)", "minimum": 0, "type": "number", "description": "Search radius around the latitude and longitude point, in kilometers. The default is 20. Example: 20.", "default": 20 } } }, "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 } } } } } } } } } }