# FincaRaíz Property Scraper - Colombia Real Estate Data (`memo23/fincaraiz-property-scraper`) Actor Scrape FincaRaíz (Colombia) property listings by city, operation and type, or paste search & property URLs. One row per property: price in COP + USD, area, bedrooms, bathrooms, estrato, full location, amenities, images and the lister/agency. Optional detail enrichment. JSON/CSV/API. - **URL**: https://apify.com/memo23/fincaraiz-property-scraper.md - **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community) - **Categories:** Real estate, AI, Agents - **Stats:** 17 total users, 16 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 properties This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## FincaRaíz Property Scraper Turn any [FincaRaíz](https://www.fincaraiz.com.co) search into clean, structured data. Search by **city, operation and property type** (e.g. `venta apartamentos bogota`), or paste **search URLs** and **individual property URLs** — and get one flat row per property with price in **COP and USD**, area, bedrooms, bathrooms, **estrato (stratum)**, full location, amenities, images and the **lister / agency** block. Flip on detail mode to add the full description, complete amenities list and the whole image gallery. Built for real-estate market research, price and inventory analysis, agency lead-generation and portal-to-warehouse data feeds across Colombia's largest property portal. ![How the FincaRaíz Scraper works](https://raw.githubusercontent.com/muhamed-didovic/muhamed-didovic.github.io/main/assets/how-it-works-fincaraiz.png) #### ✨ Why use this scraper? - **Rich rows out of the box** — ~40 fields per property from the search results alone: price (COP + pre-computed USD), admin fee, area (total / built / private), bedrooms, bathrooms, garages, estrato, floor, antiquity, full location (city / state / locality / neighborhood / lat-lng), images and the lister block. - **Two ways in** — a plain-text ` ` query, or pasted search / property URLs. Mix them in one run. - **COP *and* USD prices** — FincaRaíz pre-computes a USD price on every listing; both come through so you don't have to convert. - **Colombia-specific fields** — `estrato` (the 1–6 socioeconomic stratum that drives utility tariffs and buyer segmentation), admin/common-expense fee, and construction state. - **Full detail on demand** — turn on *Scrape property detail pages* (or paste a property URL) to add the full description, complete facilities/amenities list and the entire image gallery. - **No brittle DOM scraping** — reads FincaRaíz's embedded Next.js JSON, so the output stays stable when the page layout changes. - **JSON, CSV, Excel or API** — pipe straight into your sheet, BI tool or pipeline. Billed per property row. #### 🎯 Use cases | You are a… | Use it to… | |---|---| | Real-estate analyst | Track asking prices, price-per-m² and inventory by city, neighborhood and estrato | | Investor / developer | Spot supply gaps and price bands per zone before acquiring or building | | Agency / broker | Pull comparable listings and monitor competing agencies' portfolios | | PropTech / data builder | Seed a Colombian property dataset with structured, geocoded rows | | Market researcher | Measure price distribution and listing volume across operations and property types | #### 📥 Supported inputs | Input | Example | What it does | |---|---|---| | Text query | `venta apartamentos bogota`, `arriendo casas medellin` | Builds the search and paginates the results | | Search URL | `https://www.fincaraiz.com.co/venta/apartamentos/bogota` | Paginates that search's listings | | Property URL | `https://www.fincaraiz.com.co/apartamento-en-venta-en-chapinero-bogota/193084937` | Scrapes that single property in full detail | **Not supported:** private/account-only data, lister contact emails, saved searches, and anything behind a FincaRaíz login. The actor reads only public search and property pages. #### ⚙️ How it works 1. **Classify** every input — text queries become search URLs (`/{operation}/{type}/{city}`); pasted URLs are sorted into search vs property detail. 2. **Fetch** each page over a Colombian residential IP with a real browser TLS fingerprint, so the real FincaRaíz page is returned. 3. **Parse** the page's embedded `__NEXT_DATA__` JSON — a search page yields 21 properties; the `?page=2`, `?page=3` … sequence is followed automatically up to your limit. 4. **Enrich** each property from its detail page (when *Scrape property detail pages* is on): full description, complete facilities list and the whole gallery. 5. **Emit** one flat, deduplicated row per property to the dataset. #### ⚙️ Input parameters | Field | Type | Default | Description | |---|---|---|---| | `searchQueries` | array | `venta apartamentos bogota` | Text queries ` `. Operation defaults to `venta`, type to `apartamentos`. | | `startUrls` | array | — | FincaRaíz search and/or property URLs. Auto-classified. | | `scrapeDetails` | boolean | `false` | Also fetch each search property's detail page for description, full amenities and gallery (~2× requests). Pasted property URLs are always fully detailed. | | `maxItems` | integer | `1000` | Max rows for the whole run (free tier capped at 100). | | `maxItemsPerSearch` | integer | `1000` | Max properties per search / URL (21 per page). | | `maxConcurrency` | integer | `6` | Parallel requests. Keep moderate (4–8). | | `maxRequestRetries` | integer | `12` | Retry budget per request on 403 / 429 / 5xx; each retry rotates to a fresh CO residential IP. | | `proxy` | object | Apify Residential, CO | Applies to free-tier runs; paid runs use a built-in CO residential pool. | #### 📊 Output overview Each dataset record is **one property**. Rows carry the search-card fields (price in COP + USD, area, bedrooms, bathrooms, garages, estrato, full location, images, lister block) and — when *Scrape property detail pages* is on, or for pasted property URLs — the detail fields (full description, complete facilities list, full gallery). Prices are in Colombian pesos (COP) with a pre-computed USD value. #### 📦 Output sample ```json { "id": "193084937", "title": "Apartamento en Venta en Chapinero, Bogotá", "propertyType": "Apartamento", "operationType": "Venta", "priceCop": 1240000000, "priceUsd": 358000, "adminFeeCop": 850000, "currency": "COP", "areaM2": 162, "builtAreaM2": 162, "bedrooms": 3, "bathrooms": 3, "garages": 3, "stratum": 6, "floor": 8, "antiquityYears": 5, "city": "Bogotá", "state": "Cundinamarca", "locality": "Chapinero", "neighborhood": "El Retiro", "lat": 4.6534, "lng": -74.0578, "owner": { "name": "CASA BROK3RS INMOBILIARIA", "type": "inmobiliaria", "maskedPhone": "3XX XXX XX45", "profileUrl": "https://www.fincaraiz.com.co/inmobiliaria/casa-brok3rs" }, "coverImage": "https://…/cover.jpg", "images": ["https://…/1.jpg", "https://…/2.jpg"], "imageCount": 30, "facilities": [{ "name": "Piscina", "group": "Zonas comunes" }], "url": "https://www.fincaraiz.com.co/apartamento-en-venta-en-chapinero-bogota/193084937", "sourceMode": "search", "scrapedAt": "2026-07-06T05:00:00.000Z" } ```` #### 🗂 Key output fields | Field | Type | Notes | |---|---|---| | `title` / `url` | string | Listing headline + canonical URL | | `priceCop` / `priceUsd` | number | Asking price in COP and FincaRaíz's pre-computed USD | | `adminFeeCop` | number | Monthly administration / common-expense fee | | `areaM2` / `builtAreaM2` / `privateAreaM2` | number | Total / built / private area in m² | | `bedrooms` / `bathrooms` / `garages` | number | Room counts | | `stratum` | number | Estrato 1–6 (Colombian socioeconomic stratum) | | `floor` / `antiquityYears` / `constructionState` | number / string | Floor, age, new-vs-used status | | `city` / `state` / `locality` / `neighborhood` | string | Full location hierarchy | | `lat` / `lng` | number | Coordinates when published | | `owner` | object | Lister: name, type (inmobiliaria / desarrollador / particular), masked phone, profile URL | | `coverImage` / `images` / `imageCount` | string / string\[] / number | Gallery | | `facilities` | array | Amenities (name + group); full list with `scrapeDetails` / on property URLs | | `description` | string | Full text; present with `scrapeDetails` / on property URLs | #### ❓ FAQ **Can I get the lister's phone number or email?** FincaRaíz masks contact phones on public pages and does not publish emails, so the actor returns the public lister block (name, type, masked phone, profile URL) exactly as shown on the site. **What's `estrato`?** It's Colombia's 1–6 socioeconomic stratification of a property's location — it drives utility tariffs and is a core buyer-segmentation signal. FincaRaíz publishes it per listing and the actor passes it straight through. **Why are there two prices?** FincaRaíz pre-computes a USD value alongside the COP asking price on each listing; both are returned as `priceCop` and `priceUsd` so you don't have to convert. **What does *Scrape property detail pages* add?** The search row is already rich (~40 fields). Turning it on visits each property's page to add the **full description, the complete facilities/amenities list and the entire image gallery** — at roughly double the requests. Property URLs you paste are always fully detailed. **Do I need to configure proxies?** No. Colombian residential routing is built in. Just give it a query or URLs. #### 💬 Support Found a bug or need an extra field? Open an issue on the [actor's Issues tab](https://apify.com/memo23/fincaraiz-property-scraper/issues) and it'll be looked at quickly. #### 🛠 Additional services Need a custom field, another Latin-American property portal (Metrocuadrado, Ciencuadras, properati), or a scheduled listings feed into your warehouse? Custom scraping and pipeline work is available on request. #### 🔎 Explore more scrapers Looking for more real-estate or company-data sources? Check out the other property, e-commerce and directory scrapers in the same publisher's collection on the Apify Store. *** ### ⚠️ Disclaimer This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by FincaRaíz, La República, or any of their subsidiaries or affiliates. All trademarks mentioned are the property of their respective owners. The scraper accesses only publicly available FincaRaíz search and property pages — no authenticated endpoints, no login-only or private data. Users are responsible for ensuring their use complies with FincaRaíz's Terms of Service, applicable data-protection law (including Colombia's Ley 1581 de 2012, GDPR and CCPA where relevant) and any contractual obligations of their own organisation. Use scraped personal data (such as lister names) lawfully and honour opt-out / do-not-contact requirements. *** ### SEO Keywords fincaraiz scraper, scrape fincaraiz, fincaraiz api, colombia property scraper, colombian real estate data, fincaraiz listings scraper, apartamentos bogota scraper, casas medellin scraper, real estate scraper colombia, property data colombia, fincaraiz precio scraper, estrato data, venta arriendo scraper, fincaraiz apartamentos, propiedades colombia scraper, real estate market data colombia, property listings extractor, fincaraiz bogota, fincaraiz medellin, apify fincaraiz # Actor input Schema ## `searchQueries` (type: `array`): Free-text queries in the form ` `, e.g. `venta apartamentos bogota`, `arriendo casas medellin`, `venta lotes cali`. Operation defaults to `venta` and type to `apartamentos` if omitted. Each is paginated. ## `startUrls` (type: `array`): FincaRaíz listing/search URLs (e.g. `https://www.fincaraiz.com.co/venta/apartamentos/bogota`) and/or individual property detail URLs (e.g. `https://www.fincaraiz.com.co/apartamento-en-venta-en-chapinero-bogota/193084937`). Auto-classified. ## `scrapeDetails` (type: `boolean`): For each property found in a search, also fetch its detail page to add the full description, complete amenities/facilities list and the full image gallery. Richer rows, but ~2× the requests. Off = the search-card fields (already ~40 per property). Property URLs you paste are always fully detailed. ## `maxItems` (type: `integer`): Hard cap on rows across the entire run. Each row is one paid `property` event. Default 1000. Free-tier users are additionally capped at 100. ## `maxItemsPerSearch` (type: `integer`): Cap per search query / URL. FincaRaíz returns 21 properties per page. Default 1000. ## `maxConcurrency` (type: `integer`): Parallel HTTP requests. Keep this moderate (4–8) to stay under rate limits. Default 6. ## `maxRequestRetries` (type: `integer`): Per-request retry budget on 403 / 429 / 5xx / network errors. Each retry rotates to a fresh Colombian residential IP. Default 12. ## `proxy` (type: `object`): Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies. ## Actor input object example ```json { "searchQueries": [ "venta apartamentos bogota" ], "startUrls": [], "scrapeDetails": false, "maxItems": 1000, "maxItemsPerSearch": 1000, "maxConcurrency": 6, "maxRequestRetries": 12 } ``` # 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 = { "searchQueries": [ "venta apartamentos bogota" ], "startUrls": [] }; // Run the Actor and wait for it to finish const run = await client.actor("memo23/fincaraiz-property-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 = { "searchQueries": ["venta apartamentos bogota"], "startUrls": [], } # Run the Actor and wait for it to finish run = client.actor("memo23/fincaraiz-property-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 '{ "searchQueries": [ "venta apartamentos bogota" ], "startUrls": [] }' | apify call memo23/fincaraiz-property-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=memo23/fincaraiz-property-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FincaRaíz Property Scraper - Colombia Real Estate Data", "description": "Scrape FincaRaíz (Colombia) property listings by city, operation and type, or paste search & property URLs. One row per property: price in COP + USD, area, bedrooms, bathrooms, estrato, full location, amenities, images and the lister/agency. Optional detail enrichment. JSON/CSV/API.", "version": "0.1", "x-build-id": "xs6mRQA7g28ambr2E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~fincaraiz-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-fincaraiz-property-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/memo23~fincaraiz-property-scraper/runs": { "post": { "operationId": "runs-sync-memo23-fincaraiz-property-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/memo23~fincaraiz-property-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-fincaraiz-property-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Free-text queries in the form ` `, e.g. `venta apartamentos bogota`, `arriendo casas medellin`, `venta lotes cali`. Operation defaults to `venta` and type to `apartamentos` if omitted. Each is paginated.", "items": { "type": "string" } }, "startUrls": { "title": "Search & property URLs", "type": "array", "description": "FincaRaíz listing/search URLs (e.g. `https://www.fincaraiz.com.co/venta/apartamentos/bogota`) and/or individual property detail URLs (e.g. `https://www.fincaraiz.com.co/apartamento-en-venta-en-chapinero-bogota/193084937`). Auto-classified.", "items": { "type": "string" } }, "scrapeDetails": { "title": "Scrape property detail pages", "type": "boolean", "description": "For each property found in a search, also fetch its detail page to add the full description, complete amenities/facilities list and the full image gallery. Richer rows, but ~2× the requests. Off = the search-card fields (already ~40 per property). Property URLs you paste are always fully detailed.", "default": false }, "maxItems": { "title": "Max results (whole run)", "minimum": 1, "type": "integer", "description": "Hard cap on rows across the entire run. Each row is one paid `property` event. Default 1000. Free-tier users are additionally capped at 100.", "default": 1000 }, "maxItemsPerSearch": { "title": "Max properties per search", "minimum": 1, "type": "integer", "description": "Cap per search query / URL. FincaRaíz returns 21 properties per page. Default 1000.", "default": 1000 }, "maxConcurrency": { "title": "Max parallel requests", "minimum": 1, "maximum": 15, "type": "integer", "description": "Parallel HTTP requests. Keep this moderate (4–8) to stay under rate limits. Default 6.", "default": 6 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "type": "integer", "description": "Per-request retry budget on 403 / 429 / 5xx / network errors. Each retry rotates to a fresh Colombian residential IP. Default 12.", "default": 12 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies." } } }, "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 } } } } } } } } } } ```