{ "openapi": "3.0.1", "info": { "title": "Fincaraiz Scraper - Colombia Real Estate Listings", "description": "Search Colombian property listings on fincaraiz.com.co for homes, apartments, rentals, sales and projects by location, coordinates, price, area, rooms, amenities and freshness. Export JSON, CSV, Excel, or connect through the API and MCP for market research, lead generation and investment analysis.", "version": "0.0", "x-build-id": "Jud4Qha5q2j5VQT1Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~fincaraiz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-fincaraiz-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~fincaraiz-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-fincaraiz-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~fincaraiz-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-fincaraiz-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": "Maximum results", "minimum": 0, "type": "integer", "description": "Maximum number of property map points to save. Use 0 to save every point returned for the search.", "default": 100 }, "location": { "title": "Location", "type": "string", "description": "City, province, district, zone, or neighborhood to search. The default Bogotá search is ready to run." }, "locationType": { "title": "Location type", "enum": [ "", "city", "state", "locality", "zone", "neighborhood", "commune" ], "type": "string", "description": "Optionally filter location suggestions by type. Any selects the first suggestion returned.", "default": "" }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Latitude of the center point for coordinate-based search. Use together with longitude; coordinates take precedence over the named location." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Longitude of the center point for coordinate-based search. Use together with latitude." }, "distanceKm": { "title": "Distance (km)", "minimum": 1, "type": "integer", "description": "Search radius around the latitude/longitude point, in kilometers.", "default": 20 }, "operation": { "title": "Listing type", "enum": [ "sale", "rent", "projects" ], "type": "string", "description": "Choose whether to find properties for sale, for rent, or new-development projects.", "default": "sale" }, "sortBy": { "title": "Sort by", "enum": [ "recommended", "newest", "lowest-price", "highest-price", "lowest-price-per-square-meter", "highest-price-per-square-meter" ], "type": "string", "description": "Choose how matching properties are ordered before the item limit is applied.", "default": "recommended" }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Select one or more kinds of property. Leave empty to include any property type.", "items": { "type": "string", "enum": [ "house", "apartment", "studio-apartment", "cabin", "country-house", "house-lot", "farm", "room", "lot", "warehouse", "medical-office", "retail-space", "office", "parking-space", "building" ], "enumTitles": [ "House", "Apartment", "Studio apartment", "Cabin", "Country house", "House with lot", "Farm", "Room", "Vacant lot", "Warehouse", "Medical office", "Retail space", "Office", "Parking space", "Building" ] }, "default": [] }, "keyword": { "title": "Keyword", "type": "string", "description": "Optional text that should appear in matching listings, for example furnished or balcony.", "default": "" }, "minPrice": { "title": "Minimum price (COP)", "minimum": 0, "type": "integer", "description": "Minimum listing price in Colombian pesos. Use 0 for no minimum.", "default": 0 }, "maxPrice": { "title": "Maximum price (COP)", "minimum": 0, "type": "integer", "description": "Maximum listing price in Colombian pesos. Use 0 for no maximum.", "default": 0 }, "minArea": { "title": "Minimum area (m²)", "minimum": 0, "type": "integer", "description": "Minimum property area in square metres. Use 0 for no minimum.", "default": 0 }, "maxArea": { "title": "Maximum area (m²)", "minimum": 0, "type": "integer", "description": "Maximum property area in square metres. Use 0 for no maximum.", "default": 0 }, "areaMeasurement": { "title": "Area measurement", "enum": [ "any", "private", "built" ], "type": "string", "description": "Choose which area measurement the minimum and maximum should use.", "default": "any" }, "bedrooms": { "title": "Bedrooms", "type": "array", "description": "Select the bedroom counts to include.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 bedroom", "2 bedrooms", "3 bedrooms", "4 bedrooms", "5 or more bedrooms" ] }, "default": [] }, "bedroomsExact": { "title": "Match bedroom counts exactly", "type": "boolean", "description": "Match only the selected bedroom counts instead of treating the highest count as “or more”.", "default": false }, "bathrooms": { "title": "Bathrooms", "type": "array", "description": "Select the bathroom counts to include.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "1 bathroom", "2 bathrooms", "3 or more bathrooms" ] }, "default": [] }, "bathroomsExact": { "title": "Match bathroom counts exactly", "type": "boolean", "description": "Match only the selected bathroom counts instead of treating the highest count as “or more”.", "default": false }, "rooms": { "title": "Rooms or work areas", "type": "array", "description": "Select the number of rooms or work areas for supported commercial properties.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6" ], "enumTitles": [ "1 room", "2 rooms", "3 rooms", "4 rooms", "5 rooms", "6 or more rooms" ] }, "default": [] }, "garages": { "title": "Parking spaces", "type": "array", "description": "Select the number of parking spaces.", "items": { "type": "string", "enum": [ "1", "2", "3", "4" ], "enumTitles": [ "1 parking space", "2 parking spaces", "3 parking spaces", "4 or more parking spaces" ] }, "default": [] }, "floorRanges": { "title": "Apartment floors", "type": "array", "description": "Select one or more floor ranges for apartments.", "items": { "type": "string", "enum": [ "first-floor", "floors-2-to-5", "floors-6-to-10", "above-10th-floor", "penthouse" ], "enumTitles": [ "First floor", "2nd–5th floor", "6th–10th floor", "Above the 10th floor", "Penthouse" ] }, "default": [] }, "strataCategories": { "title": "Strata", "type": "array", "description": "Select Colombian residential strata or a non-residential category.", "items": { "type": "string", "enum": [ "stratum-1", "stratum-2", "stratum-3", "stratum-4", "stratum-5", "stratum-6", "commercial", "country" ], "enumTitles": [ "Stratum 1", "Stratum 2", "Stratum 3", "Stratum 4", "Stratum 5", "Stratum 6", "Commercial", "Country" ] }, "default": [] }, "propertyConditions": { "title": "Property condition", "type": "array", "description": "Select one or more construction or availability states.", "items": { "type": "string", "enum": [ "pre-construction", "under-construction", "immediate-delivery", "new", "used" ], "enumTitles": [ "Pre-construction", "Under construction", "Immediate delivery", "New", "Used" ] }, "default": [] }, "amenities": { "title": "Amenities", "type": "array", "description": "Select any amenities that every matching property should have.", "items": { "type": "string", "enum": [ "truck-access", "tractor-trailer-access", "paved-access", "air-conditioning", "evaporative-cooling", "alarm", "fire-alarm", "sewer-connection", "clear-height", "restricted-height", "furnished", "barbecue-grill", "elevator", "private-elevator", "smart-elevator-exterior", "smart-elevator-interior", "communal-elevators", "auditorium", "parking-bays", "exterior-parking-bay", "balcony", "american-style-bar", "auxiliary-bathroom", "shared-bathroom", "service-bathroom", "independent-bathroom", "communal-bathrooms-exterior", "communal-bathrooms-interior", "unisex-bathrooms", "public-restrooms", "gas-pumps", "native-forest", "network-cabling", "boiler-exterior", "boiler-interior", "water-heater", "basketball-court", "soccer-field", "squash-court", "tennis-court", "sports-courts", "workers-house", "near-commercial-area", "near-shopping-center", "near-urban-area", "fireplace", "closed-circuit-tv-exterior", "closed-circuit-tv-interior", "intercom", "closet", "garage", "wood-burning-kitchen", "equipped-kitchen", "fitted-kitchen", "american-style-kitchen", "kitchenette", "schools-universities", "dining-room", "auxiliary-dining-room", "with-administrator", "clubhouse", "prefabricated-house", "electric-fence", "with-housing", "digital-access-control-exterior", "digital-access-control-interior", "acoustic-control-exterior", "acoustic-control-interior", "thermal-control-exterior", "thermal-control-interior", "corrals", "drivers-room", "bodyguards-room-exterior", "bodyguards-room-interior", "service-room", "service-room-2", "covered", "convenient-access-roads", "storage-warehouse", "pantry", "smoke-detection", "metal-detector-interior", "metal-detector-exterior", "wifi-availability", "equipped", "duplex", "smart-building-exterior", "smart-building-interior", "at-home", "in-shopping-center", "in-club", "in-condominium", "in-gated-community", "in-building", "in-commercial-zone", "in-residential-zone", "keys-must-be-left", "emergency-staircase", "escalators-exterior", "escalators-interior", "corner-unit", "stable", "study", "livestock-farm", "agricultural-farm", "poultry-farm", "coffee-farm", "cattle-farm", "outside-shopping-center", "fire-cabinet", "warehouse-shed", "garage-parking", "covered-garage-exterior", "covered-garage-interior", "garages", "gym", "bedroom-hall", "industrial", "gas-installation", "greenhouse", "exterior-gardens", "garden", "golf-cage", "kiosk", "construction-license", "exterior-premises", "interior-premises", "commercial-premises-exterior", "commercial-premises-interior", "loft", "lot-under-construction", "vacant-lot", "mezzanine", "water-springs", "business-office", "administrative-offices", "360-panorama", "panoramic-view-one-side", "industrial-park", "ground-level-parking", "smart-parking-exterior", "smart-parking-interior", "indoor-parking", "underground-parking", "visitor-parking-interior", "visitor-parking-exterior", "nearby-parks", "shopping-arcade", "patio", "internal-patio", "penthouse", "horse-stall", "swimming-pool", "heavy-duty-floor", "carpet-floor", "tile-marble-floor", "concrete-floor", "wood-floor", "power-plant-exterior", "power-plant-interior", "reception-exterior", "reception-interior", "security-gate", "natural-water-well", "security-door", "electric-gate", "ramp-basement", "security-bars", "restaurants", "nearby-river-stream", "water-sprinklers", "internet-room", "community-room", "conference-room", "game-room-exterior", "game-room-interior", "video-conference-room-exterior", "video-conference-room-interior", "sauna-steam-room-jacuzzi-interior", "sauna-steam-room-jacuzzi-exterior", "security", "24-hour-security", "ecological-trails", "motion-sensor", "food-service", "internet-service", "laundry-service", "independent-utilities", "public-utilities", "trash-chute", "on-main-road", "on-secondary-road", "crane-support", "supermarkets-shopping-centers", "irrigation-system", "water-tanks-exterior", "water-tanks-interior", "loading-platform", "smart-cards-exterior", "smart-cards-interior", "magnetic-cards-exterior", "magnetic-cards-interior", "terrace-exterior", "terrace-interior", "all-utilities", "nearby-public-transport", "located-in-building-exterior", "located-in-building-interior", "valet-parking", "natural-ventilation", "surveillance", "24-7-surveillance", "private-surveillance-24-7", "panoramic-view", "semi-detached-home", "multi-family-home", "country-zone", "commercial-zone", "bbq-area", "camping-area", "hammock-area", "laundry-area", "industrial-zone", "children-s-area", "residential-area", "green-areas", "fruit-trees", "rural-area", "urban-area" ], "enumTitles": [ "Truck access", "Tractor-trailer access", "Paved access", "Air conditioning", "Evaporative cooling", "Alarm", "Fire alarm", "Sewer connection", "Clear height", "Restricted height", "Furnished", "Barbecue grill", "Elevator", "Private elevator", "Smart elevator - exterior", "Smart elevator - interior", "Communal elevators", "Auditorium", "Parking bays", "Exterior parking bay", "Balcony", "American-style bar", "Auxiliary bathroom", "Shared bathroom", "Service bathroom", "Independent bathroom", "Communal bathrooms - exterior", "Communal bathrooms - interior", "Unisex bathrooms", "Public restrooms", "Gas pumps", "Native forest", "Network cabling", "Boiler - exterior", "Boiler - interior", "Water heater", "Basketball court", "Soccer field", "Squash court", "Tennis court", "Sports courts", "Workers' house", "Near commercial area", "Near shopping center", "Near urban area", "Fireplace", "Closed-circuit TV - exterior", "Closed-circuit TV - interior", "Intercom", "Closet", "Garage", "Wood-burning kitchen", "Equipped kitchen", "Fitted kitchen", "American-style kitchen", "Kitchenette", "Schools / universities", "Dining room", "Auxiliary dining room", "With administrator", "Clubhouse", "Prefabricated house", "Electric fence", "With housing", "Digital access control - exterior", "Digital access control - interior", "Acoustic control - exterior", "Acoustic control - interior", "Thermal control - exterior", "Thermal control - interior", "Corrals", "Drivers' room", "Bodyguards' room - exterior", "Bodyguards' room - interior", "Service room", "Service room - 2", "Covered", "Convenient access roads", "Storage / warehouse", "Pantry", "Smoke detection", "Metal detector - interior", "Metal detector - exterior", "WiFi availability", "Equipped", "Duplex", "Smart building - exterior", "Smart building - interior", "At home", "In shopping center", "In club", "In condominium", "In gated community", "In building", "In commercial zone", "In residential zone", "Keys must be left", "Emergency staircase", "Escalators - exterior", "Escalators - interior", "Corner unit", "Stable", "Study", "Livestock farm", "Agricultural farm", "Poultry farm", "Coffee farm", "Cattle farm", "Outside shopping center", "Fire cabinet", "Warehouse shed", "Garage / parking", "Covered garage - exterior", "Covered garage - interior", "Garages", "Gym", "Bedroom hall", "Industrial", "Gas installation", "Greenhouse", "Exterior gardens", "Garden", "Golf cage", "Kiosk", "Construction license", "Exterior premises", "Interior premises", "Commercial premises - exterior", "Commercial premises - interior", "Loft", "Lot under construction", "Vacant lot", "Mezzanine", "Water springs", "Business office", "Administrative offices", "360 panorama", "Panoramic view - one side", "Industrial park", "Ground-level parking", "Smart parking - exterior", "Smart parking - interior", "Indoor parking", "Underground parking", "Visitor parking - interior", "Visitor parking - exterior", "Nearby parks", "Shopping arcade", "Patio", "Internal patio", "Penthouse", "Horse stall", "Swimming pool", "Heavy-duty floor", "Carpet floor", "Tile / marble floor", "Concrete floor", "Wood floor", "Power plant - exterior", "Power plant - interior", "Reception - exterior", "Reception - interior", "Security gate", "Natural water well", "Security door", "Electric gate", "Ramp / basement", "Security bars", "Restaurants", "Nearby river / stream", "Water sprinklers", "Internet room", "Community room", "Conference room", "Game room - exterior", "Game room - interior", "Video conference room - exterior", "Video conference room - interior", "Sauna / steam room / jacuzzi - interior", "Sauna / steam room / jacuzzi - exterior", "Security", "24-hour security", "Ecological trails", "Motion sensor", "Food service", "Internet service", "Laundry service", "Independent utilities", "Public utilities", "Trash chute", "On main road", "On secondary road", "Crane support", "Supermarkets / shopping centers", "Irrigation system", "Water tanks - exterior", "Water tanks - interior", "Loading platform", "Smart cards - exterior", "Smart cards - interior", "Magnetic cards - exterior", "Magnetic cards - interior", "Terrace - exterior", "Terrace - interior", "All utilities", "Nearby public transport", "Located in building - exterior", "Located in building - interior", "Valet parking", "Natural ventilation", "Surveillance", "24/7 surveillance", "Private surveillance 24/7", "Panoramic view", "Semi-detached home", "Multi-family home", "Country zone", "Commercial zone", "BBQ area", "Camping area", "Hammock area", "Laundry area", "Industrial zone", "Children's area", "Residential area", "Green areas", "Fruit trees", "Rural area", "Urban area" ] }, "default": [] }, "propertyAge": { "title": "Property age", "enum": [ "any-age", "under-1-year", "1-to-8-years", "9-to-15-years", "16-to-30-years", "over-30-years" ], "type": "string", "description": "Choose the age range of the property.", "default": "any-age" }, "publishedWithin": { "title": "Published within", "enum": [ "any-time", "today", "yesterday", "last-7-days", "last-15-days", "last-30-days", "last-40-days" ], "type": "string", "description": "Limit results by when the listing was published.", "default": "any-time" }, "commonExpenses": { "title": "Has common expenses", "type": "boolean", "description": "Return only listings that include common-expense charges.", "default": false }, "season": { "title": "Rental season", "enum": [ "", "first-half-december", "second-half-december", "december", "first-half-january", "second-half-january", "january", "first-half-february", "second-half-february", "february", "new-year", "holy-week", "carnival" ], "type": "string", "description": "Limit rental listings to a seasonal period.", "default": "" }, "availableFrom": { "title": "Available from", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Optional rental availability start date in YYYY-MM-DD format." }, "availableTo": { "title": "Available to", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Optional rental availability end date in YYYY-MM-DD format." }, "minGuests": { "title": "Minimum guests", "minimum": 0, "type": "integer", "description": "Return rental listings that accommodate at least this many guests.", "default": 0 }, "seaDistance": { "title": "Distance to sea", "enum": [ "", "seafront", "under-100m", "around-200m", "around-300m", "around-400m", "around-500m", "under-1000m", "over-1000m" ], "type": "string", "description": "Limit properties by their distance from the sea.", "default": "" }, "dispositions": { "title": "Property disposition", "type": "array", "description": "Select the property orientations or dispositions to include.", "items": { "type": "string", "enum": [ "not-applicable", "front", "back", "interior", "side" ], "enumTitles": [ "Not applicable", "Front", "Back", "Interior", "Side" ] }, "default": [] }, "socialHousing": { "title": "Social housing only", "type": "boolean", "description": "Return only properties marked as social housing.", "default": false }, "privateOwner": { "title": "Private owner only", "type": "boolean", "description": "Return only listings published by a private owner.", "default": false }, "hideSeen": { "title": "Hide previously seen", "type": "boolean", "description": "Ask the search service to hide listings already marked as seen.", "default": 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 } } } } } } } } } }