Fincaraiz Scraper

Extracts structured real estate data from FincaRaiz.com.co, Colombia's leading property portal. Use it to gather listings for houses, apartments, offices, and more based on location, price, property type, and transaction type (sale/rent).

Overview

This actor automates the collection of property listings from FincaRaiz. It returns clean, structured data (like price, location, bedrooms, area) in JSON format, suitable for market analysis, investment research, price comparison, or feeding into other applications.

Key Features

• Targeted Scraping: Filter searches by city, property type, price range, bedrooms, bathrooms, parking spaces, stratum, area, and property condition.
• Dual Operation Modes: Scrape properties for "venta" (sale) or "arriendo" (rent).
• Flexible Numeric Filters: Specify exact values or minimum thresholds for rooms, bathrooms, etc.
• Pagination Control: Limit the number of result pages scraped (max 10).
• Structured Output: Returns consistent, ready-to-use data for each property listing.

How to Use

1. Configure the actor's input parameters (see below).
2. Run the actor. It will navigate FincaRaiz, apply your filters, and extract data.
3. Retrieve the structured dataset from the actor's output.

Important Formatting Note: All text input values (like city, operation type) must be in lowercase and without accents. The actor normalizes inputs automatically.

Input Parameters

Required

• operation: Transaction type. Must be "venta" or "arriendo".
• city: City to search in (e.g., "bogota", "medellin").

Optional

• property_types: Array of property types (e.g., ["apartamentos", "casas"]).
• precio_min / precio_max: Price range in Colombian Pesos (COP).
• bedrooms / bathrooms / garage: Arrays of numeric strings.
  • ["3"] means "at least 3".
  • ["2","3"] means "exactly 2 or exactly 3".
• stratum: Array of desired socioeconomic strata (e.g., ["3","4"]).
• m2_min / m2_max: Minimum and maximum area in square meters.
• m2_type: Area type. "edificados" (built) or "totales" (total).
• condition: Property condition: "nuevos", "usados", "en-construccion".
• antiguedad: Property age (e.g., "menor-a-1-anio").
• solo_proyectos_nuevos: Boolean. Set to true for new developments only.
• max_pages: Number of search result pages to scrape (maximum 10).

Example Input

{
  "operation": "venta",
  "city": "bogota",
  "property_types": ["casas"],
  "bedrooms": ["3", "4"],
  "bathrooms": ["2"],
  "garage": ["1", "2"],
  "stratum": ["4", "5"],
  "precio_min": 300000000,
  "precio_max": 600000000,
  "m2_min": 100,
  "m2_max": 200,
  "max_pages": 2
}

Output

The actor outputs a dataset where each item represents a property listing. Typical fields include:
* title, url, price, operation (sale/rent)
* location, city, neighborhood
* property_type, bedrooms, bathrooms, garages
* area, stratum, description
* agency, contact_name, contact_phone