Fincaraiz Property Search Scraper: Extract Colombian Real Estate Data at Scale

---

What Is Fincaraiz.com.co?

Fincaraiz.com.co is Colombia's premier online real estate marketplace, hosting thousands of active property listings across residential, commercial, and agricultural sectors. The platform aggregates offers from individual sellers, real estate agencies, and developers nationwide. Manually collecting and organizing this property data is tedious and error-prone — the Fincaraiz Property Search Scraper automates data extraction, delivering structured records ready for analysis, investment research, or platform integration.

---

Overview

The Fincaraiz Property Search Scraper extracts comprehensive property detail pages from Fincaraiz listings, transforming unstructured web content into clean, machine-readable data records. It is designed for:

• Real estate investors tracking market trends and property availability across regions
• Market researchers analyzing Colombian housing prices and market conditions
• Property aggregators feeding data into multi-listing portals
• Data analysts building datasets for investment models or price prediction
• Real estate agencies monitoring competitor listings and market intelligence

The scraper supports bulk extraction from search result pages, configurable item limits, and robust error handling to ensure reliable large-scale data collection.

---

Input Format

The scraper accepts a JSON configuration object with the following parameters:

{
  "urls": [
    "https://www.fincaraiz.com.co/proyectos-vivienda/casas-y-apartaestudios-y-casas-campestres/2-o-mas-habitaciones/baratos/pagina2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Configuration Fields

Parameter	Type	Description
urls	Array	URLs of Fincaraiz property list pages to scrape. Paste search result or category pages, not individual property detail pages
ignore_url_failures	Boolean	If true, the scraper continues if some URLs fail; if false, it stops on first error. Default: true
max_items_per_url	Integer	Maximum number of properties to extract per URL (e.g., 200). Useful for controlling run duration and data volume

Example: To scrape 200 affordable 2+ bedroom properties in apartments and houses across page 2 of Fincaraiz, use the URL above with max_items_per_url: 200.

Tip: Test with lower max_items_per_url values (e.g., 20–50) to validate URL and output before scaling to full runs.

---

Output Format

Sample output

{
  "id": 7883085,
  "id_finca_legacy": 7883085,
  "title": "Viverdi, Apartamentos en Venta en San fernando viejo, Cali",
  "type_id": null,
  "address": "Calle 4B No 37- 5",
  "show_address": true,
  "country_id": 3,
  "description": "Viverdi es un proyecto de apartamentos estrato 5, ubicado en el barrio San Fernando, al oeste de Cali, se compone de 2 torres de 18 pisos cada una y 6 apartamentos por piso, 2 ascensores por torre, cuenta con un parqueadero privado para cada apartamento, y en el caso de los apartamentos con mayor área construida contara con doble asignación de parqueadero. El edificio de parqueadero se compone de 2 sótanos y una plataforma en el piso 3, cuenta con 2 puntos fijos y 2 ascensores que conducen a las.",
  "code": "FRP3B8C36",
  "code2": "faac8322-db2d-4f25-ace8-5b03287cff67",
  "finances": true,
  "grouped_ids": null,
  "img": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_3_0.jpg",
  "is_map_featured": false,
  "price": {
    "amount": 538205000,
    "admin_included": 538205000,
    "hide_price": false,
    "currency": {
      "id": 4,
      "name": "$",
      "rate": 3805.62
    }
  },
  "price_amount_usd": 141424,
  "price_admin_usd": 141424,
  "owner": {
    "id": 174539047,
    "name": "MARVAL CALI",
    "masked_phone": "+5732",
    "whatsapp_phone": null,
    "has_whatsapp": true,
    "active": true,
    "logo": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2015/9/15/201591510595TKZQFVLBQHWNCSIYOETKAQGVMBSHXNDTJYP.jpg",
    "inmo_link": null,
    "inmo_props_link": "/inmobiliarias/174539047-marval cali/propiedades",
    "inmofull": false,
    "type": "desarrollador",
    "particular": false,
    "address": "Cra. 100 Holguines Trade Center  Torre Valle del L",
    "subsidiaries": [
      {
        "id": 687194,
        "name": "Casa central",
        "masked_phone": "+5760",
        "address": "",
        "office_hours": ""
      }
    ]
  },
  "locations": {
    "location_point": "POINT (-76.5468139648438 3.42928123474121)",
    "location_main": {
      "id": "3af58099-c1b1-41aa-92e6-c6d9285712d3",
      "name": "San fernando viejo",
      "slug": [
        "neighbourhood-colombia-76-001-001904"
      ],
      "location_type": "neighbourhood"
    },
    "country": [
      {
        "id": "858656c1-bbb1-4b0d-b569-f61bbdebc8f0",
        "name": "Colombia",
        "slug": [
          "country-48-colombia"
        ]
      }
    ],
    "state": [
      {
        "id": "baa6a98e-3451-4ae9-b082-3e395a5f0504",
        "name": "Valle del cauca",
        "slug": [
          "state-colombia-76-valle-del-cauca"
        ],
        "indicative": null
      }
    ],
    "city": [
      {
        "id": "0e99ce18-9ff5-4c20-9b60-6150cc9e094b",
        "name": "Cali",
        "slug": [
          "city-colombia-76-001"
        ]
      }
    ],
    "locality": [],
    "commune": [
      {
        "id": "3a49938b-5ee8-4bd7-99bf-3eaee96e1c2b",
        "name": "Comuna 19",
        "slug": [
          "commune-colombia-cali-001-76-19"
        ]
      }
    ],
    "zone": [
      {
        "id": "3f5c62b9-8d04-4bba-91d7-32c19661465b",
        "name": "Zona Oeste",
        "slug": [
          "zone-colombia-cali-oeste"
        ]
      },
      {
        "id": "5c3e8161-5e5e-42a9-af5e-fa5ec3e3f6f2",
        "name": "Sur",
        "slug": [
          "zone-colombia-cali-sur"
        ]
      },
      {
        "id": "a0c508ae-438f-46ed-9a00-3953c9be164d",
        "name": "Occidente",
        "slug": [
          "zone-colombia-cali-occidente"
        ]
      }
    ],
    "region": [],
    "neighbourhood": [
      {
        "id": "3af58099-c1b1-41aa-92e6-c6d9285712d3",
        "name": "San fernando viejo",
        "slug": [
          "neighbourhood-colombia-76-001-001904"
        ]
      },
      {
        "id": "2d7a8022-c703-4dfb-8682-0f8df56488aa",
        "name": "Santa isabel",
        "slug": [
          "neighbourhood-colombia-76-001-001908"
        ]
      }
    ]
  },
  "seller": null,
  "technical_sheet": [
    {
      "field": "construction_state_name",
      "value": "Nuevos",
      "text": "Estado"
    },
    {
      "field": "garages",
      "value": "",
      "text": "Parqueaderos"
    },
    {
      "field": "financing",
      "value": "Financiación: 80",
      "text": "Financiación"
    },
    {
      "field": "payment_methods",
      "value": "",
      "text": "Formas de pago"
    },
    {
      "field": "initialFee",
      "value": "",
      "text": "Cuota inicial"
    },
    {
      "field": "floorsAmount",
      "value": "",
      "text": "Cantidad de pisos"
    },
    {
      "field": "subsidy_apply",
      "value": "",
      "text": "Aplica subsidio"
    },
    {
      "field": "finalization_date",
      "value": "",
      "text": "Fecha de Finalización"
    },
    {
      "field": "stratum",
      "value": "5",
      "text": "Estrato"
    }
  ],
  "image_count": 8,
  "file_count": 0,
  "img_size": null,
  "link": "/proyectos-vivienda/viverdi-apartamentos-en-venta-en-san-fernando-viejo-cali/7883085",
  "property_type": {
    "id": 2,
    "name": "Apartamento"
  },
  "operation_type": {
    "id": 1,
    "name": "Venta"
  },
  "barter": false,
  "facilities": [
    {
      "id": null,
      "name": "Cableado de Red",
      "group": null
    }
  ],
  "m2": 72.68,
  "m2_built": 72.68,
  "m2apto": 63.3,
  "m2_terrain": null,
  "m2_terrace": null,
  "hectares": null,
  "created_at": "2023-01-24",
  "updated_at": "2026-01-28",
  "latitude": "3.42928123474121000000",
  "longitude": "-76.54681396484380000000",
  "images": [
    {
      "id": 159679796,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_3_0.jpg",
      "tag": null
    },
    {
      "id": 159581506,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_805_1.jpg",
      "tag": null
    },
    {
      "id": 159679794,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_812_2.jpg",
      "tag": null
    },
    {
      "id": 159596127,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_938_3.jpg",
      "tag": null
    },
    {
      "id": 159679795,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_809_4.jpg",
      "tag": null
    },
    {
      "id": 159679798,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_873_5.jpg",
      "tag": null
    },
    {
      "id": 159683525,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_364_6.jpg",
      "tag": null
    },
    {
      "id": 159679797,
      "image": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/OVFR_COL/2023/1/24/4068285_496_7.jpg",
      "tag": null
    }
  ],
  "files": [],
  "source": null,
  "color": 3,
  "project_group_md5": "project_7883085",
  "project": [],
  "pausd": false,
  "point_type": false,
  "zoom": 0,
  "youtube": "https://www.youtube.com/embed/venQAcRWxlw",
  "highlight": 18,
  "active": true,
  "deleted": false,
  "relevance": 0.001,
  "antiquity": null,
  "construction_year": null,
  "notes": "",
  "sold": false,
  "sold_date": null,
  "discount": null,
  "draft": false,
  "sign": null,
  "guarantee": null,
  "facilities_not_apply": false,
  "common_expenses": {
    "amount": 0,
    "hide_price": false,
    "currency": {
      "id": null,
      "name": null
    }
  },
  "price_variation": {},
  "ce_currency_id": null,
  "highlight_date": "2026-01-28",
  "social_media_links": [
    {
      "slug": "facebook",
      "name": "facebook",
      "url": "https://www.facebook.com/sharer/sharer.php?u=https://www.fincaraiz.com.co/proyectos-vivienda/viverdi-apartamentos-en-venta-en-san-fernando-viejo-cali/7883085",
      "icon": "icon-facebook-1",
      "order": null
    },
    {
      "slug": "linkedin",
      "name": "linkedin",
      "url": "https://www.linkedin.com/shareArticle?mini=true&url=https://www.fincaraiz.com.co/proyectos-vivienda/viverdi-apartamentos-en-venta-en-san-fernando-viejo-cali/7883085",
      "icon": "icon-linkedin",
      "order": null
    },
    {
      "slug": "twitter",
      "name": "twitter",
      "url": "https://twitter.com/intent/tweet?url=https://www.fincaraiz.com.co/proyectos-vivienda/viverdi-apartamentos-en-venta-en-san-fernando-viejo-cali/7883085",
      "icon": "icon-twitter",
      "order": null
    },
    {
      "slug": "email",
      "name": "email",
      "url": "mailto:?subject=Propiedad Recomendada - InfoCasas&body=Link de la Propiedad: https://www.fincaraiz.com.co/proyectos-vivienda/viverdi-apartamentos-en-venta-en-san-fernando-viejo-cali/7883085",
      "icon": "icon-mail",
      "order": null
    }
  ],
  "garage": 0,
  "office": false,
  "disposition_id": null,
  "bathrooms": 2,
  "rooms": 0,
  "seaview": false,
  "living_place": false,
  "condominium": false,
  "front_length": null,
  "floors_count": 0,
  "apartments_per_floor": 0,
  "floor": null,
  "neighborhood_id": 1,
  "estate_id": 1,
  "farmhouse": false,
  "allowed_height": "0",
  "is_favorite": false,
  "is_external": false,
  "guests": null,
  "seasons": [],
  "price_season": {},
  "occupancies": [],
  "temporal_price": null,
  "temporal_currency": {},
  "sea_distance_name": null,
  "tour3d": null,
  "legacy_prop_id": null,
  "is_project": true,
  "is_project_unit": false,
  "operation_type_id": 1,
  "property_type_id": 2,
  "currency": "$",
  "currency_id": 4,
  "hide_price": false,
  "stratum": 5,
  "common_expenses_currency": null,
  "const_states_id": null,
  "bedrooms": 2,
  "event": {
    "show": false,
    "fecha_inicio_evento": null,
    "link": null,
    "logo": null,
    "tag": null
  },
  "turbo_product": {
    "start_date": null,
    "end_date": null,
    "duration": null
  },
  "tag": {},
  "commercial_units": [
    {
      "id": 191584609,
      "title": "VIVERDI, Apartamento en Venta en San fernando viejo, Cali",
      "code": "FRX69F30",
      "link": "viverdi-apartamento-en-venta-en-san-fernando-viejo-cali/191584609",
      "rooms": 0,
      "bedrooms": 2,
      "bathrooms": 2,
      "m2": 72.68,
      "m2_terrace": 63.3,
      "m2_terrain": 63.3,
      "property_type": {
        "id": 2,
        "name": "Apartamento"
      },
      "price": {
        "amount": 538205000,
        "admin_included": 538205000,
        "hide_price": false,
        "currency": "$",
        "currency_id": 4
      }
    }
  ],
  "modify_score": 0,
  "modify_score_client": 0,
  "description_count": 501,
  "categories_count": 1,
  "has_images": true,
  "has_video": true,
  "paid_quota": true,
  "logo": "https://s3.amazonaws.com/imagenes.fincaraiz.com.co/FC_COL/2023/01/24/7883085/proyecto-nuevo-venta-valle-del-cauca-cali-527081947_m.jpg",
  "include_administration": false,
  "md5": null,
  "has_garage": false,
  "penthouse": false,
  "id_form": null,
  "finalization_date": null,
  "fair": {},
  "has_tour3d": false,
  "duplicated": [],
  "from_url": "https://www.fincaraiz.com.co/venta/pagina4"
}

Each scraped property returns a comprehensive record with 120+ fields spanning identification, pricing, specifications, location, and media:

Core Property Identification

Field	Purpose
ID	Unique Fincaraiz property identifier
ID Finca Legacy	Legacy internal ID from prior systems
Title	Property listing title/headline
Code	Secondary property code or reference
Code 2	Additional code field for tracking
Link	Direct URL to the full property listing
MD5	Hash fingerprint for deduplication

Pricing & Financial Data

Field	Purpose
Price	Listed sale or rental price in local currency
Price Amount USD	Price converted to US dollars
Price Admin USD	Administrative/processed price in USD
Currency	Currency code (e.g., COP, USD)
Currency ID	Numeric currency identifier
Common Expenses	Monthly maintenance/HOA fees (if applicable)
Common Expenses Currency	Currency for common expenses
CE Currency ID	Currency ID for common expenses
Discount	Any price reduction applied
Price Variation	Historical price changes
Hide Price	Whether price is publicly visible
Temporal Price	Seasonal or temporary pricing (e.g., vacation rentals)
Temporal Currency	Currency for temporal pricing

Property Type & Operation

Field	Purpose
Property Type	Category (e.g., apartment, house, land, commercial)
Property Type ID	Numeric property type identifier
Operation Type	Sale, rent, lease, barter, etc.
Operation Type ID	Numeric operation type identifier
Type ID	General property type code
Barter	Whether property is offered for exchange/barter

Physical Specifications

Field	Purpose
M2	Total property area in square meters
M2 Built	Built/constructed area in m²
M2 Apto	Apartment-specific built area
M2 Terrain	Terrain/land area in m²
M2 Terrace	Terrace or balcony area in m²
Hectares	Property size in hectares (for large properties)
Bedrooms	Number of bedrooms
Rooms	Total number of rooms
Bathrooms	Number of bathrooms
Floors Count	Total floors in the building
Floor	Specific floor number of the property
Apartments Per Floor	Units per floor (for multi-unit buildings)
Garage	Number of parking spaces
Has Garage	Boolean: whether garage is included
Front Length	Street frontage length in meters
Penthouse	Boolean: whether property is a penthouse
Condominium	Boolean: whether property is in a condominium
Farmhouse	Boolean: indicates rural/farmhouse property
Sea View	Boolean: whether property has ocean/lake views
Sea Distance Name	Named distance from shoreline
Construction Year	Year the property was built
Construction State ID	Condition/state of construction (new, renovated, etc.)
Stratum	Colombian socioeconomic classification (1–6)
Antiquity	Age of the property in years

Location Data

Field	Purpose
Address	Full street address of the property
Show Address	Boolean: whether to display address publicly
Country ID	Numeric country identifier (Colombia = 1)
Locations	Geographic location tags or categories
Neighborhood ID	Numeric neighborhood/district identifier
Estate ID	Residential development or estate ID
Displayed Location	Location shown to potential buyers
Latitude	GPS latitude coordinate
Longitude	GPS longitude coordinate
Zoom	Map zoom level for optimal viewing

Media & Images

Field	Purpose
Image	Primary/featured property image URL
Image Count	Total number of images available
Image Size	Size of the primary image file
Images	Array of all image URLs
Has Images	Boolean: whether images are included
Logo	Company/agent logo URL
Is Map Featured	Boolean: whether property appears on map view
3D Tour	URL or ID for 3D virtual tour
Has 3D Tour	Boolean: whether 3D tour is available
YouTube	YouTube video URL (if available)
Has Video	Boolean: whether video content exists
File Count	Total number of attachable documents
Files	Array of document/file URLs

Owner & Seller Information

Field	Purpose
Owner	Property owner name or entity
Seller	Agent or seller responsible for listing
Social Media Links	Links to seller's social media profiles

Description & Content

Field	Purpose
Description	Full HTML property description
Sanitized Description	Clean plain-text description
Sanitized Requirements	Plain-text tenant/buyer requirements
Notes	Additional notes or special conditions
Description Count	Number of description paragraphs/sections

Dates & Status

Field	Purpose
Created At	Listing creation date/time
Updated At	Last update timestamp
Sold Date	Date property was sold (if applicable)
Highlight Date	Date of last promotional highlight
Finalization Date	Expected completion/move-in date

Listing Flags & Attributes

Field	Purpose
Active	Boolean: whether listing is currently active
Deleted	Boolean: whether listing is archived/deleted
Sold	Boolean: whether property has been sold
Draft	Boolean: whether listing is in draft mode
Is Favorite	Boolean: bookmarked/favorited by user
Is External	Boolean: links to external website
Highlight	Boolean: listing has paid highlight/boost
Turbo Product	Boolean: premium/turbo listing status
Is Project	Boolean: property is part of a development project
Is Project Unit	Boolean: individual unit within a project
Relevance	Relevance/popularity score
Paid Quota	Boolean: paid listing quota applied

Facilities & Amenities

Field	Purpose
Facilities	Array of amenity codes (e.g., gym, pool, security)
Facilities Not Apply	Amenities explicitly not available

Additional Metadata

Field	Purpose
Project Group MD5	Development project identifier hash
Project	Associated development project name
PAUSD	Price per unit square meter (USD)
Point Type	Geolocation point classification
Color	Visual marker color on map
Tag	Categorical tags or labels
Event	Special event or promotion flag
Living Place	Indicates property type for residence
Office	Indicates commercial/office use
Commercial Units	Number of commercial spaces
Disposition ID	Property layout/disposition type
Allowed Height	Maximum allowed building height
Fair	Boolean: fair/ethical listing designation
Guests	Max occupants (for rental properties)
Seasons	Seasonal availability (for vacation rentals)
Price Season	Seasonal price variations
Occupancies	Occupancy patterns or restrictions
Legacy Property ID	ID from legacy property database
Grouped IDs	Related property IDs for grouped listings
Technical Sheet	Engineering/technical specifications URL
Finances	Financing options available
Guarantee	Warranty or guarantee terms
Include Administration	Boolean: whether admin fees included
Modify Score	Data quality/modification score
Modify Score Client	Client-side modification score
ID Form	Form or questionnaire ID used
Categories Count	Number of property categories
Duplicated	Boolean: indicates duplicate listing

---

How to Use

1. Find search URLs — Navigate to Fincaraiz.com.co, apply filters (price, location, property type, bedrooms), and copy the search results page URL.
2. Configure parameters — Paste the URL into the urls array. Set max_items_per_url based on how many properties you need (e.g., 200 for a full page, 500 for multiple pages).
3. Set error handling — Keep ignore_url_failures: true for uninterrupted bulk runs.
4. Start the scraper — Execute the run and monitor the log for progress.
5. Download results — Export data as JSON, CSV, or Excel for analysis or import into your database.

Best practices:

• Use specific search filters to narrow results by region, price range, or property type
• Test with small max_items_per_url values (20–50) first to verify data quality
• Combine multiple URLs to scrape different filters in a single run
• Store timestamps (Created At, Updated At) to detect new or modified listings

---

Use Cases & Business Value

• Investment analysis: Build datasets of Colombian properties to identify market trends, price cycles, and geographic hotspots
• Competitive monitoring: Track competitor listings, pricing strategies, and market share in real estate agencies
• Aggregator platforms: Feed Fincaraiz inventory into your own multi-listing website or mobile app
• Market research: Analyze housing availability, affordability, and demand by neighborhood or region
• Lead generation: Identify properties matching investor criteria for outreach campaigns

The Fincaraiz Property Search Scraper transforms time-intensive manual data collection into automated workflows, enabling data-driven decisions in real estate investment and development.

---

Conclusion

The Fincaraiz Property Search Scraper provides real estate professionals, investors, and researchers with structured, comprehensive data from Colombia's largest property marketplace. With 120+ fields covering pricing, specifications, location, and media, it eliminates hours of manual copying and enables scalable market analysis. Start scraping today to unlock competitive intelligence and investment opportunities.