Fincaraiz Scraper — Colombia Property & Agency Leads

Scrape Fincaraiz, Colombia's largest property portal: price in COP and USD, admin fee, stratum, private and built area, bedrooms, coordinates, neighbourhood and the listing agency with type and address. Sale and rent. Keyless. JSON, CSV or Excel.

---

What does the Fincaraiz Scraper do?

This Actor turns Fincaraiz into a structured dataset you can actually work with. You give it a search, it walks the result pages, and it writes one clean row per record into your dataset — ready to export as JSON, CSV or Excel, or to pull straight from the Apify API.

It runs on plain HTTP with no browser and no login, which keeps it fast and cheap, and it works the same on a free account as on a paid one. Every field documented below came from a real verification run of this Actor, so what you read here is what you get.

The current build returns 43 populated fields per record, of which 36 are present on virtually every row.

Who is it for?

• Analysts who need Fincaraiz data as a spreadsheet instead of a browser tab.
• Operations and research teams tracking how Fincaraiz listings change over time.
• Developers wiring a live data feed into an internal tool or database.
• Growth and sales teams building prospect and market lists from public data.
• AI teams assembling structured training or grounding data.

Use cases

• Export a full Fincaraiz search into a spreadsheet for analysis.
• Track how prices, volumes or availability move week over week by scheduling the run.
• Feed a dashboard or internal database with a repeatable, structured source.
• Build a market map by running several searches in one job.
• Enrich an existing list by matching on the identifiers in the output.

Why use this Fincaraiz Scraper?

• 🔑 No API key and no login — nothing to authenticate, nothing to expire.
• 📦 43 verified fields — every column below was confirmed against live output.
• 📄 Real pagination — it walks the result set instead of returning the first screen.
• 🎯 Bounded runs — caps in the input stop the job exactly where you want, so the bill is predictable.
• 💸 Tiered pay-per-result — you pay per row, and higher Apify plans pay less per row.
• 📊 Export anywhere — JSON, CSV, Excel, HTML, the API, or any Apify integration.

What data can you extract?

One row per record. These columns come from a live run, with the share of rows that carried a value:

Field	Type	Typically filled	Description
acceptsBarter	string	100%	Accepts barter
address	string	100%	Address
areaBuiltSqm	number	92%	Area built sqm
areaTotalSqm	number	100%	Area total sqm
bathrooms	number	97%	Bathrooms
bedrooms	number	97%	Bedrooms
city	string	100%	City
constructionState	string	100%	Construction state
country	number	100%	Country
currency	string	100%	Currency
description	string	100%	Description
imageCount	number	100%	Image count
isAddressPublic	boolean	100%	Is address public
isPriceHidden	number	100%	Is price hidden
latitude	number	100%	Latitude
listingCode	string	100%	Listing code
listingId	string	100%	Listing id
listingUrl	string	100%	Listing url
longitude	number	100%	Longitude
neighbourhood	string	100%	Neighbourhood
operationType	string	100%	Operation type
priceAmount	number	100%	Price amount
priceUsd	number	100%	Price usd
priceWithAdmin	number	100%	Price with admin
propertyType	string	100%	Property type
scrapedAt	string	100%	Scraped at
sellerAddress	string	100%	Seller address
sellerIsPrivate	string	100%	Seller is private
sellerName	string	100%	Seller name
sellerType	string	100%	Seller type
sellerUrl	string	100%	Seller url
source	string	100%	Source
state	string	100%	State
stratum	string	100%	Stratum
title	string	100%	Title
zone	string	93%	Zone
areaPrivateSqm	number	88%	Area private sqm
commonExpenses	string	62%	Common expenses
constructionYear	number	63%	Construction year
floorNumber	number	50%	Floor number
garages	string	52%	Garages
locality	string	75%	Locality
sellerLogoUrl	string	88%	Seller logo url

Fields below 90% are genuinely optional at the source — Fincaraiz does not publish them for every record. An empty value means the source did not show it, not that extraction failed.

How to use

1. Open the Actor and fill in the search fields — the defaults below are a working example.
2. Set the result cap so the run stops where you want it.
3. Click Start, then export from the Output tab or pull the dataset through the API.

{
  "operation": "venta",
  "propertyType": "apartamentos",
  "city": "bogota",
  "department": "bogota-dc",
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Input parameters

Parameter	Type	Default	Description
operation	string	venta	Sale (venta) or rent (arriendo).
propertyType	string	apartamentos	Which kind of property to list.
city	string	–	Fincaraiz city slug from the search URL, e.g.
department	string	–	Department slug that follows the city in the URL, e.g.
maxResults	integer	500	Stop after this many listings.
proxyConfiguration	object	–	Fincaraiz embeds its search payload in the page; the default datacenter proxy is enough.

Tips for best results

• Broad searches return the deepest result sets; very narrow ones run out after a page or two.
• Use the result cap rather than the page cap when you want a predictable bill.
• Schedule the same input daily or weekly to build a history instead of a one-off snapshot.
• Lower the concurrency if you see retries — the source rate-limits aggressive crawling.
• Run several searches in one job instead of one search with a huge page count.
• Empty optional fields are normal; filter on the columns that matter to you after export.
• Deduplicate on the identifier column if you merge several runs together.
• Keep the proxy setting on the default unless the source blocks your region.

Integrations

Push results straight into Google Sheets, Slack, Zapier, Make, Airtable or any Webhook. You can also schedule the Actor and have each run append to the same dataset, which is how you turn a single export into a time series.

API usage

Replace <YOUR_TOKEN> with your Apify API token.

cURL

curl -X POST "https://api.apify.com/v2/acts/logiover~fincaraiz-scraper/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"operation": "venta", "propertyType": "apartamentos", "city": "bogota", "department": "bogota-dc", "maxResults": 500, "proxyConfiguration": {"useApifyProxy": true}}'

Python

from apify_client import ApifyClient

client = ApifyClient('<YOUR_TOKEN>')
run = client.actor('logiover/fincaraiz-scraper').call(run_input={"operation": "venta", "propertyType": "apartamentos", "city": "bogota", "department": "bogota-dc", "maxResults": 500, "proxyConfiguration": {"useApifyProxy": true}})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_TOKEN>' });
const run = await client.actor('logiover/fincaraiz-scraper').call({"operation": "venta", "propertyType": "apartamentos", "city": "bogota", "department": "bogota-dc", "maxResults": 500, "proxyConfiguration": {"useApifyProxy": true}});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Use with AI agents (MCP)

This Actor is reachable through the Apify MCP server, so an AI agent can call it as a tool. Point the agent at https://mcp.apify.com and ask it something like "pull the first 200 listings from Fincaraiz and summarise them" — it receives the same structured rows you would get from the UI.

FAQ

Do I need a Fincaraiz account or API key?

No. The Actor reads publicly available pages only. There is nothing to authenticate and no credentials to rotate.

Does it work on the free plan?

Yes. Every feature is available on a free Apify account — nothing is gated behind a paid tier. Pricing is per result, and higher plans simply pay less per row.

How many listings can I get in one run?

As many as the search exposes. Raise the page and result caps together; the run stops at whichever limit it reaches first.

Why did I get fewer rows than I asked for?

The search ran out of records. That is normal for narrow queries — broaden the search or add more searches to one run.

Why are some fields empty?

Fincaraiz does not publish every attribute for every record. The table above shows how often each field is filled in practice.

What export formats are supported?

JSON, CSV, Excel, HTML and RSS from the Output tab, plus the Apify API and any integration you connect.

How fast is it?

It is pure HTTP with no browser, so a page of results typically takes a second or two.

Can I schedule it?

Yes. Use the Apify scheduler to run it on any interval and append each run to the same dataset.

Does it use a proxy?

It routes through Apify Proxy by default. You can switch groups or supply your own proxies in the input.

Is the output schema stable?

Yes. Field names and types are fixed, so downstream pipelines will not break between runs.

How often is the data refreshed?

Every run reads the live source. There is no cache, so the data is as current as the website itself.

What if the site changes its layout?

Open an issue on the Issues tab and it gets fixed — the Actor is actively maintained.

Is it legal?

This Actor reads only publicly available pages on Fincaraiz — the same content any visitor sees without logging in. It does not bypass authentication and does not collect private data. You remain responsible for how you use the output: respect the source's terms of service, applicable copyright, and data-protection law such as GDPR where personal data is involved.

Related scrapers

Browse the full collection at apify.com/logiover — Real Estate, Lead Generation tools and more.