# FincaRaiz Colombia Real Estate Scraper (`crawlerbros/fincaraiz-colombia-scraper`) Actor Scrape property listings from FincaRaiz.com.co - Colombia's largest real estate portal with 100K+ active listings. Get apartments, houses, offices, and commercial spaces for sale or rent. Includes price, bedrooms, bathrooms, area, coordinates, agent details, and images. - **URL**: https://apify.com/crawlerbros/fincaraiz-colombia-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Lead generation, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## FincaRaiz Colombia Real Estate Scraper Scrape property listings from **FincaRaiz.com.co** — Colombia's largest real estate portal with 180,000+ active listings. Extract apartments, houses, offices, commercial spaces, warehouses, and land plots for sale or rent across all Colombian cities. ### What You Get Each property listing includes: | Field | Description | |---|---| | `listingId` | Unique FincaRaiz listing ID | | `title` | Property title/name | | `description` | Full description text | | `operationType` | "Venta" (for sale) or "Arriendo" (for rent) | | `propertyType` | Apartment, Casa, Oficina, Local, Bodega, Finca, Lote, etc. | | `price` | Listing price in COP (Colombian Pesos) | | `currencyCode` | COP, USD, or EUR | | `priceUsd` | Price estimate in USD | | `administrationFee` | Monthly administration fee (COP) if applicable | | `city` | City/municipality name | | `neighborhood` | Neighborhood or sector name | | `address` | Full address (when available) | | `latitude` | GPS latitude | | `longitude` | GPS longitude | | `stratum` | Colombian socioeconomic stratum (1–6) | | `bedrooms` | Number of bedrooms | | `bathrooms` | Number of bathrooms | | `garages` | Number of garage spaces | | `areaSqm` | Property area in square meters | | `terrainSqm` | Terrain/lot area (houses and land) | | `floor` | Floor number in building | | `floorsCount` | Total floors in building | | `constructionState` | "Nuevo", "Usado", "Sobre planos", etc. | | `antiquity` | Age of the property | | `isProject` | Whether it's a new construction project | | `amenities` | List of amenities (pool, gym, security, etc.) | | `agent` | Agent/agency name, type, phone, agency URL | | `images` | List of high-resolution image URLs | | `thumbnail` | Cover image URL | | `listingUrl` | Direct URL to the listing on FincaRaiz | | `listedAt` | Date the property was listed | | `updatedAt` | Date the listing was last updated | | `scrapedAt` | UTC timestamp when the record was scraped | ### Input Options | Parameter | Type | Default | Description | |---|---|---|---| | `mode` | select | `searchForSale` | `searchForSale` (Venta) or `searchForRent` (Arriendo) | | `propertyType` | select | all | Filter by property type: Apartamento, Casa, Oficina, Bodega, Lote, etc. | | `city` | text | all | Filter by city name (partial match, e.g. "Bogotá", "Medellín", "Cali") | | `priceMin` | number | — | Minimum price in COP | | `priceMax` | number | — | Maximum price in COP | | `bedroomsMin` | number | — | Minimum number of bedrooms | | `bedroomsMax` | number | — | Maximum number of bedrooms | | `bathroomsMin` | number | — | Minimum number of bathrooms | | `areaMin` | number | — | Minimum area in m² | | `areaMax` | number | — | Maximum area in m² | | `maxItems` | number | 50 | Maximum results to return (1–1000) | ### Example Use Cases #### Apartments for rent in Bogotá ```json { "mode": "searchForRent", "propertyType": "Apartamento", "city": "Bogotá", "maxItems": 100 } ```` #### Houses for sale under 500M COP in Medellín ```json { "mode": "searchForSale", "propertyType": "Casa", "city": "Medellín", "priceMax": 500000000, "maxItems": 50 } ``` #### 2–3 bedroom apartments for sale in Cali ```json { "mode": "searchForSale", "propertyType": "Apartamento", "city": "Cali", "bedroomsMin": 2, "bedroomsMax": 3, "maxItems": 50 } ``` #### Commercial spaces for rent nationwide ```json { "mode": "searchForRent", "propertyType": "Local", "maxItems": 200 } ``` ### Data Source Property data is sourced directly from **FincaRaiz.com.co** — Colombia's leading real estate marketplace operated by InfoCasas Group. The platform provides publicly accessible listing data without requiring authentication. **Coverage:** All Colombian cities and municipalities including Bogotá, Medellín, Cali, Barranquilla, Cartagena, Bucaramanga, Pereira, Manizales, and hundreds more. **No API key or registration required.** ### Frequently Asked Questions **How many listings are available?** FincaRaiz has 180,000+ active sale listings and 100,000+ active rental listings as of 2025. **Can I filter by specific neighborhood?** Use the `city` filter to narrow to a city, then use post-processing to filter by neighborhood. The actor returns `neighborhood` in each record. **Does this require a proxy?** No — FincaRaiz serves public listing data without bot protection that requires proxy or residential IPs. **How fresh is the data?** Each run fetches live data directly from FincaRaiz. The `updatedAt` field shows when the property owner last updated the listing. **What currencies are supported?** Most listings are in COP (Colombian Pesos). Some commercial/luxury properties are listed in USD or UF. The `currencyCode` and `priceUsd` fields always clarify. # Actor input Schema ## `mode` (type: `string`): Type of operation to fetch. ## `propertyType` (type: `string`): Filter by property type. Leave blank for all types. ## `city` (type: `string`): Filter results by city name (partial match, case-insensitive). E.g. 'Bogotá', 'Medellín', 'Cali', 'Barranquilla', 'Cartagena', 'Bucaramanga', 'Pereira'. ## `priceMin` (type: `integer`): Minimum listing price in Colombian Pesos (COP). Leave blank for no minimum. ## `priceMax` (type: `integer`): Maximum listing price in Colombian Pesos (COP). Leave blank for no maximum. ## `bedroomsMin` (type: `integer`): Minimum number of bedrooms. Leave blank for no minimum. ## `bedroomsMax` (type: `integer`): Maximum number of bedrooms. Leave blank for no maximum. ## `bathroomsMin` (type: `integer`): Minimum number of bathrooms. Leave blank for no minimum. ## `areaMin` (type: `integer`): Minimum property area in square meters. Leave blank for no minimum. ## `areaMax` (type: `integer`): Maximum property area in square meters. Leave blank for no maximum. ## `maxItems` (type: `integer`): Maximum number of property listings to return (1–1000). ## Actor input object example ```json { "mode": "searchForSale", "propertyType": "", "city": "", "maxItems": 5 } ``` # Actor output Schema ## `properties` (type: `string`): Dataset containing all scraped FincaRaiz property listings. # 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 = { "mode": "searchForSale", "propertyType": "", "city": "", "maxItems": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/fincaraiz-colombia-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 = { "mode": "searchForSale", "propertyType": "", "city": "", "maxItems": 5, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/fincaraiz-colombia-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 '{ "mode": "searchForSale", "propertyType": "", "city": "", "maxItems": 5 }' | apify call crawlerbros/fincaraiz-colombia-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/fincaraiz-colombia-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FincaRaiz Colombia Real Estate Scraper", "description": "Scrape property listings from FincaRaiz.com.co - Colombia's largest real estate portal with 100K+ active listings. Get apartments, houses, offices, and commercial spaces for sale or rent. Includes price, bedrooms, bathrooms, area, coordinates, agent details, and images.", "version": "1.0", "x-build-id": "mMWOWeYJjavT4SuGp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~fincaraiz-colombia-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-fincaraiz-colombia-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/crawlerbros~fincaraiz-colombia-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-fincaraiz-colombia-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/crawlerbros~fincaraiz-colombia-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-fincaraiz-colombia-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": { "mode": { "title": "Mode", "enum": [ "searchForSale", "searchForRent" ], "type": "string", "description": "Type of operation to fetch.", "default": "searchForSale" }, "propertyType": { "title": "Property Type", "enum": [ "", "Apartamento", "Casa", "Oficina", "Local", "Bodega", "Apartaestudio", "Finca", "Lote", "Casa Campestre", "Parqueadero", "Habitación", "Edificio" ], "type": "string", "description": "Filter by property type. Leave blank for all types.", "default": "" }, "city": { "title": "City Filter", "type": "string", "description": "Filter results by city name (partial match, case-insensitive). E.g. 'Bogotá', 'Medellín', 'Cali', 'Barranquilla', 'Cartagena', 'Bucaramanga', 'Pereira'.", "default": "" }, "priceMin": { "title": "Minimum Price (COP)", "minimum": 0, "type": "integer", "description": "Minimum listing price in Colombian Pesos (COP). Leave blank for no minimum." }, "priceMax": { "title": "Maximum Price (COP)", "minimum": 0, "type": "integer", "description": "Maximum listing price in Colombian Pesos (COP). Leave blank for no maximum." }, "bedroomsMin": { "title": "Minimum Bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum number of bedrooms. Leave blank for no minimum." }, "bedroomsMax": { "title": "Maximum Bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum number of bedrooms. Leave blank for no maximum." }, "bathroomsMin": { "title": "Minimum Bathrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum number of bathrooms. Leave blank for no minimum." }, "areaMin": { "title": "Minimum Area (m²)", "minimum": 0, "type": "integer", "description": "Minimum property area in square meters. Leave blank for no minimum." }, "areaMax": { "title": "Maximum Area (m²)", "minimum": 0, "type": "integer", "description": "Maximum property area in square meters. Leave blank for no maximum." }, "maxItems": { "title": "Max Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of property listings to return (1–1000).", "default": 50 } } }, "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 } } } } } } } } } } ```