FincaRaíz Property Scraper

Scrape public sale and rental property listings from FincaRaíz in Colombia and export records with listing, price, location, area, room, facility, image, seller and source-date fields when present; no buyer-supplied FincaRaíz key or login is needed. Free-plan pricing is described below.

• Collect sale or rental inventory by operation, property type and location for property research.
• Filter listings by price, area, bedrooms, bathrooms, keyword or Colombian stratum for property discovery.
• Build location-aware datasets with public addresses, coordinates, neighborhoods, departments and cities when provided.
• Download public listing images and seller or source-date fields for catalog and monitoring workflows.
• Run with your Apify account without buyer API keys or FincaRaíz credentials.

What you get

The Actor reads FincaRaíz server-rendered listing data and saves source records. A field is omitted when the source does not provide it.

Field family	Output fields	What it contains
Identity	id, legacy_id, url, title, description	Property identifiers, canonical page URL, title and listing description
Listing	operation_type, property_type, source	Sale or rental label, property category and source site
Price	price, currency, price_usd, administration_fee	Advertised price, currency, source-provided USD equivalent and administration fee when supplied
Location	address, country, department, city, neighborhood, latitude, longitude	Public address, geographic names and coordinates
Area	area_m2, built_area_m2, private_area_m2, terrain_area_m2, terrace_area_m2, hectares	Total, built, private, land and terrace measurements
Rooms and building	bedrooms, bathrooms, garages, stratum, floor, floors_count, construction_year, construction_state	Room counts, parking, Colombian stratum, floor information and construction details
Facilities and media	amenities, images, image_count	Named facilities and public listing image URLs
Seller and dates	seller_name, created_at, updated_at, scraped_at	Seller or agency, source dates and collection timestamp

Sample output

This shortened sample preserves values from one real dataset record and omits other fields, including the description, image list and additional property details.

{
  "id": "194196781",
  "url": "https://www.fincaraiz.com.co/apartamento-en-venta-en-el-batan-bogota/194196781",
  "title": "Apartamento en Venta en El Batán, Bogotá",
  "operation_type": "Venta",
  "property_type": "Apartamento",
  "price": 620000000,
  "currency": "COP",
  "address": "Calle 126 #52a-96, Bogotá, Colombia",
  "city": "Bogotá",
  "department": "Bogotá, d.c.",
  "latitude": 4.7072814,
  "longitude": -74.0618545,
  "area_m2": 100,
  "bedrooms": 3,
  "bathrooms": 3,
  "garages": 2,
  "stratum": 5,
  "source": "FincaRaíz"
}

Pricing

This Actor uses pay-per-event billing. The listed event prices are:

Event	Unit	Price
apify-default-dataset-item	One scraped result with all fields	$0.001 per result on the Free plan
apify-actor-start	Actor start	$0.00005 per start event on the Free plan

For example, 1,000 results = $1.00 on Free, plus one Actor Start event at $0.00005 on the Free plan; 10,000 results = $10.00 on Free, plus one Actor Start event at $0.00005 on the Free plan. The result event is charged for each saved dataset item; the Actor Start event is charged when the Actor starts running.

The Apify Free plan includes $5 of monthly platform usage credit. Using the supplied event prices, the Free-plan calculation gives 4,999 results after one $0.00005 start event: 4,999 dataset items plus one start event total $4.99905 on the Free plan.

These are Actor event charges. Platform usage such as compute, Apify Proxy traffic including residential traffic, and storage is included in the event prices and paid by the Actor developer. This Actor does not use the “Pay per event + usage” option, so platform usage is not additionally paid by the user.

How to use

1. Choose sale or rent for operationType, select a propertyType, and enter a FincaRaíz location path such as bogota-dc or medellin/antioquia.
2. Set maxResults to the maximum number of property records to save. It defaults to 50.
3. Add optional filters such as a keyword, price bounds, area bounds, minimum bedrooms, minimum bathrooms or an exact stratum.
4. Provide one or more startUrls when you want to collect a specific FincaRaíz search or property page. Each URL must use HTTPS on the fincaraiz.com.co domain; supplied start URLs replace the generated operation, property type and location URL.
5. Configure proxyConfiguration only when needed. Set useApifyProxy to false, or omit proxy settings, to connect directly.
6. Schedule the run again through Apify Schedules; daily is a suitable starting point for a listings collection job.

Example input:

{
  "operationType": "sale",
  "propertyType": "apartment",
  "location": "bogota-dc",
  "maxResults": 50,
  "minPrice": 200000000,
  "maxAreaM2": 150,
  "minRooms": 2
}

Export the dataset as JSON or CSV, or read it through the Apify dataset API.

Input parameters

Parameter	What it does	Default
operationType	Selects the operation: sale or rent.	sale
propertyType	Selects a category: apartment, house, studio_apartment, country_house, ranch, cabin, house_lot, room, land, warehouse, commercial, office, medical_office, parking, building or any. any searches all property types.	apartment
location	FincaRaíz URL path for a city, neighborhood or department. Separate nested slugs with /.	bogota-dc
maxResults	Maximum number of property records to save.	50
keyword	Keeps records whose title, description or amenities contain the text.	Not set
minPrice	Keeps listings at or above this price in COP.	Not set
maxPrice	Keeps listings at or below this price in COP.	Not set
minAreaM2	Keeps listings with at least this total area in square metres.	Not set
maxAreaM2	Keeps listings with no more than this total area in square metres.	Not set
minRooms	Keeps listings with at least this many bedrooms.	Not set
minBathrooms	Keeps listings with at least this many bathrooms.	Not set
stratum	Keeps listings matching exactly this Colombian stratum, from 1 through 6.	Not set
startUrls	Optional HTTPS FincaRaíz search or property URLs. Valid URLs replace the generated search URL.	[]
proxyConfiguration	Optional proxy settings. Set useApifyProxy to false, or omit proxy settings, for a direct connection.	{"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}

The additional filters are applied to collected source records. minPrice, maxPrice, area limits, room limits, bathroom limits and stratum use the corresponding parsed record fields.

Limits and edge cases

Condition	What the buyer sees	What to do
The source does not provide a field	That field is omitted from the record rather than filled with an empty value.	Use fields that are present, and account for optional property details in downstream processing.
A filter is set but a record lacks the field needed for that filter	The record does not pass that filter.	Relax the filter or choose a search where the source provides the relevant property detail.
maxResults is 0 at runtime	The Actor logs that no records were requested and saves no records.	Use a positive value when records are required.
A startUrls value is not HTTPS on the FincaRaíz domain	The URL is ignored and a warning is logged. If no valid start URL remains, the Actor logs that no valid URLs were provided and stops.	Use an HTTPS URL on fincaraiz.com.co or one of its subdomains.
A page contains no parsed property records	The Actor logs that no property records were found at that page and stops processing that URL.	Check the URL, broaden the search or use a different FincaRaíz search page.
A page fetch fails	The page fetch is attempted up to three times. After the final failure, the Actor logs a warning and stops processing that base URL; records already pushed remain in the dataset.	Retry the run or use another valid start URL.
A property page is used as a startUrl	The page is treated as a detail page and pagination does not continue beyond that record.	Use a FincaRaíz search URL when multiple listings are needed.
The same property appears more than once across collected pages or URLs	The Actor skips duplicate records by listing ID, or by URL when an ID is unavailable.	Review the remaining records and use more specific URLs or filters if needed.

FAQ

How much does it cost to scrape FincaRaíz property listings?

The dataset-item event costs $0.001 per result on the Free plan, and the Actor Start event costs $0.00005 per start event on the Free plan. For example, 1,000 results = $1.00 on Free, plus one $0.00005 start event on the Free plan.

Why did the Actor return an empty dataset?

The search page may contain no parsed property records, or optional filters may exclude every collected record. A filter also excludes a record when the corresponding value is absent. Try a broader location or search URL, remove restrictive filters, or verify that the property page is an HTTPS FincaRaíz URL.

What happens if a FincaRaíz page does not load?

The Actor retries a failed page fetch up to three times. If the fetch still fails, it logs a warning and stops processing that base URL. Records pushed before that failure remain available in the dataset.

Is using FincaRaíz public data legal for my project?

The Actor collects public listing data from FincaRaíz, but public availability is not a legal guarantee for every use. Source terms and applicable law depend on your use case, so review them before using the data.

Related actors

• Chaves na Mão Property Listings — another bovi Actor for property listings.
• Metrocuadrado Scraper — a related bovi property scraper.
• QuintoAndar Property Listings Scraper — another bovi Actor focused on property listings.