Fincaraiz Scraper: Colombia Real Estate Listings & API

The most complete Fincaraiz scraper for Colombia real estate data. Turn any fincaraiz.com.co search into a clean dataset of property listings for sale (venta) or rent (arriendo): apartments, houses, offices, lots, farms and more, across Bogota, Medellin, Cali, Barranquilla, Cartagena and every other city on the portal.

One normalized row per listing with price in COP and USD, administration fee, estrato (socioeconomic stratum), bedrooms, bathrooms, area in m2, price per m2, neighborhood, city, department, map coordinates, amenities, the full image gallery and the advertiser / agency contact. Export to JSON, CSV or Excel, or pull it straight from the API.

Keywords: Fincaraiz scraper, Fincaraiz API, Colombia real estate data, property listings scraper Colombia, apartments and houses Colombia, inmuebles en venta y arriendo, datos inmobiliarios Colombia.

Here is one real result (image and amenity arrays trimmed for length, values real):

{
  "listingId": "194024116",
  "referenceCode": "194024116",
  "sourceMode": "search",
  "title": "Apartamento en Venta en Chico norte, Bogota",
  "url": "https://www.fincaraiz.com.co/apartamento-en-venta-en-chico-norte-bogota/194024116",
  "price": 1100000000,
  "currency": "COP",
  "priceUsd": 341354,
  "priceWithAdmin": 1101414000,
  "pricePerM2": 8943089,
  "pricePerM2Usd": 2775,
  "adminFee": 1414000,
  "priceHidden": false,
  "operationType": "Venta",
  "propertyType": "Apartamento",
  "bedrooms": 2,
  "bathrooms": 3,
  "parkingSpaces": 2,
  "rooms": 4,
  "areaM2": 123,
  "builtAreaM2": 123,
  "stratum": 6,
  "floor": 3,
  "buildingFloors": 8,
  "antiquity": 4,
  "propertyCondition": "Usado",
  "isProject": false,
  "address": "Carrera 17 #93a, Bogota, Colombia",
  "neighborhood": "Chico norte",
  "city": "Bogota",
  "department": "Bogota, d.c.",
  "country": "Colombia",
  "coordinates": { "lat": 4.678526, "lng": -74.052898 },
  "imageUrl": "https://s3.amazonaws.com/imagenesprof.fincaraiz.com.co/...jpg",
  "imageCount": 30,
  "hasVideo": true,
  "videoUrl": "https://www.youtube.com/embed/LxEb85znWKQ",
  "advertiser": {
    "name": "Ronald Morales",
    "type": "inmobiliaria",
    "hasWhatsapp": true,
    "profileUrl": "https://www.fincaraiz.com.co/inmobiliarias/177095690-ronald-morales/propiedades",
    "logo": null,
    "phone": "+573001234567",
    "whatsapp": "+573001234567",
    "maskedPhone": "+5731",
    "address": "Carrera 9bis 97-45",
    "subsidiaries": null
  },
  "description": "Apartamento en venta | Chico Norte, Bogota | 123 m2 ... (full text returned)",
  "amenities": ["Ascensor", "Chimenea", "Gimnasio", "Porteria / Recepcion", "Terraza", "Vigilancia"],
  "images": ["https://cdn2.infocasas.com.uy/repo/img/...jpg", "..."],
  "createdAt": "2026-07-23",
  "updatedAt": "2026-07-23",
  "observedAt": "2026-07-28T17:07:52.133Z",
  "error": null
}

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Why this scraper
• How it compares
• Quickstart
• Input reference
• Output reference
• Use cases
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

Give the actor a Fincaraiz search: a search results URL, a batch of URLs, a text query like venta apartamentos bogota-dc, or a structured operation + propertyType + city. It paginates the matching listings and writes one normalized record per property, deduplicated by listing id.

Every run returns the core listing fields for all users: price in COP and USD, administration fee, estrato, bedrooms, bathrooms, parking, area (built, total, private, terrace, land), floor, building floors, antiquity, property condition, neighborhood, locality, city, department, country, map coordinates, primary image, image count, video and 3D tour flags, project / new build flags, and the agency name, type, logo and public profile.

Enable the details add-on to also attach the full description, complete amenities list, full image gallery, the technical sheet, social links and the advertiser contact (phone and WhatsApp when public). Three optional AI add-ons attach a plain-English summary, normalized English feature tags and an English translation of the title and description.

Why this scraper

• Both currencies, always. price in COP plus a native priceUsd, and both pricePerM2 and pricePerM2Usd, so you never have to convert.
• Colombia specifics. stratum (estrato) validated to 1 to 6, adminFee (administracion), priceWithAdmin, and propertyCondition (nuevo, usado, en pozo).
• Contactable leads. Agency name, type, logo, public profile, and, with the details add-on, phone and WhatsApp when the advertiser exposes them.
• Map ready. Real coordinates (lat, lng) on every listing, plus neighborhood, locality, city, department and country.
• Flexible input. Paste a URL, a batch of URLs, text queries, or structured operation + type + city, and filter by price, bedrooms, bathrooms or area.
• Honest nulls. Missing source values are returned as null, never invented. No charge on failure, and a spend cap you control.

How it compares

Capability	This actor	memo23/fincaraiz-property-scraper	hernan_restrepo/fincaraiz-property-scraper
Search results URL input	Yes	Yes	No
Batch startUrls	Yes	Yes	No
Text searchQueries	Yes	Yes	No
Structured operation + type + city	Yes	No	Yes
Single property URL	Yes	Yes	No
Client-side filters (price, beds, baths, area)	Yes	No	No
Price in COP and USD	Yes	Yes	No
Price per m2 (COP and USD)	Yes	No	No
Administration fee	Yes	Yes	No
Estrato (stratum)	Yes	Yes	No
Map coordinates	Yes	Yes	No
Amenities and full gallery	Yes	Yes	No
Advertiser contact (phone / WhatsApp)	Yes	Partial	No
Project / new build flags	Yes	No	No
Video and 3D tour	Yes	No	No
AI summary, features, translation	Yes	No	No
Spend cap and no charge on failure	Yes	Not documented	Not documented
Fields returned	~65	~40	12

This actor is a strict superset: it accepts every input the alternatives accept and returns every field they return, plus dual-currency price per m2, project flags, video and 3D tour, richer advertiser contact, client-side filters and optional AI enrichment.

Quickstart

Open the actor, paste this input, and press Run. It returns 10 apartments for sale in Bogota with full details.

{
  "startUrl": "https://www.fincaraiz.com.co/venta/apartamentos/bogota-dc",
  "maxListings": 10,
  "withDetails": true
}

Build the startUrl on fincaraiz.com.co: apply your filters (operation, property type, city, price) and paste the resulting URL. Or skip the URL entirely and use operation + propertyType + city, or a searchQueries list.

Input reference

Field	Type	Required	Default	Description
startUrl	string	no	(example Bogota URL)	A Fincaraiz search results URL, or a single property URL.
startUrls	array	no	(empty)	Multiple search and/or property URLs (strings or { "url": "..." }), classified automatically.
searchQueries	array	no	(empty)	Text queries <operation> <propertyType> <city>, for example venta apartamentos bogota-dc.
operation	string	no	(empty)	venta or arriendo for a single structured search.
propertyType	string	no	(empty)	Property type slug, for example apartamentos, casas, oficinas, lotes.
city	string	no	(empty)	City slug, for example bogota-dc, medellin, cali.
maxListings	integer	no	10	Overall cap on listings. Free plans are capped at 10 per run.
maxItems	integer	no	(unset)	Alias of maxListings.
maxItemsPerSearch	integer	no	(unset)	Cap per individual search source.
maxPages	integer	no	(unset)	Maximum result pages per search (about 21 listings per page).
withDetails	boolean	no	true	Attach description, amenities, full gallery, advertiser contact, technical sheet and social links (paid add-on).
scrapeDetails	boolean	no	(unset)	Alias of withDetails.
minPrice / maxPrice	integer	no	(unset)	Keep listings within this price range (listing currency, typically COP).
minBedrooms / minBathrooms	integer	no	(unset)	Keep listings with at least this many bedrooms / bathrooms.
minAreaM2 / maxAreaM2	integer	no	(unset)	Keep listings within this area range in m2.
maxConcurrency	integer	no	(auto)	Parallel page and enrichment tasks, 1 to 8.
maxRequestRetries	integer	no	(auto)	Retries per failed request, 0 to 6.
withAiSummary	boolean	no	false	Plain-English AI summary of each listing (paid add-on).
withAiFeatures	boolean	no	false	Normalized English feature tags, condition and highlights via AI (paid add-on).
withAiTranslate	boolean	no	false	Spanish-to-English translation of title and description via AI (paid add-on).
proxyConfiguration	object	no	Apify Proxy (Colombia)	Proxy settings. Residential is recommended for large runs.

Output reference

One dataset item per listing. Types: string, number, boolean, array, object, or null when the source value is absent. Detail fields are populated when the details add-on is enabled.

Field	Type	Description
listingId	string	Fincaraiz listing id.
referenceCode	string	Advertiser reference code.
sourceMode	string	search or property, depending on the input that produced the row.
title	string	Listing title.
url	string	Canonical listing URL.
price	number	Asking price in the listing currency.
currency	string	Price currency, typically COP.
priceUsd	number	Price in US dollars.
priceWithAdmin	number	Price plus administration fee, when available.
priceWithAdminUsd	number	Price plus administration fee, in US dollars.
pricePerM2	number	Price per square meter (listing currency).
pricePerM2Usd	number	Price per square meter in US dollars.
adminFee	number	Monthly administration fee, or null.
priceHidden	boolean	Whether the advertiser hid the price.
includesAdministration	boolean	Whether the price includes administration.
acceptsBarter	boolean	Whether the advertiser accepts barter (permuta).
operationType	string	Venta (sale) or Arriendo (rent).
propertyType	string	Property type, for example Apartamento, Casa.
bedrooms	integer	Bedrooms (0 kept for studios).
bathrooms	integer	Bathrooms.
parkingSpaces	integer	Parking spaces (0 kept).
rooms	integer	Total rooms.
guests	integer	Guest capacity, when published.
areaM2	number	Listed area in square meters.
builtAreaM2	number	Built area in square meters.
totalAreaM2	number	Total area in square meters.
privateAreaM2	number	Private area in square meters, or null.
terraceAreaM2	number	Terrace area in square meters, or null.
landAreaM2	number	Land area in square meters, or null.
hectares	number	Land in hectares, for rural properties.
stratum	integer	Colombian socioeconomic stratum (1 to 6), or null.
floor	integer	Floor number (0 for ground).
buildingFloors	integer	Number of floors in the building.
antiquity	integer	Property age in years, or null.
antiquityText	string	Age range label, for example 9 a 15 anos.
constructionYear	integer	Year built, or null.
propertyCondition	string	Condition (nuevo, usado, en pozo), or null.
seaView	boolean	Whether the listing advertises a sea view.
isProject	boolean	Whether the listing is a development project.
isProjectUnit	boolean	Whether the listing is a unit within a project.
projectName	string	Project / development name, when available.
address	string	Street address, when published.
neighborhood	string	Neighborhood (barrio).
locality	string	Locality / zone.
city	string	City.
department	string	Department (region).
country	string	Country.
coordinates	object	{ lat, lng } map coordinates, or null.
imageUrl	string	Primary listing image URL.
imageCount	integer	Number of images in the gallery.
hasVideo	boolean	Whether the listing has a video.
videoUrl	string	Video embed URL, or null.
hasTour3d	boolean	Whether the listing has a 3D tour.
tour3dUrl	string	3D tour URL, or null.
advertiser	object	name, type, hasWhatsapp, profileUrl, logo; the details add-on adds phone, whatsapp, maskedPhone, address, subsidiaries.
sold	boolean	Whether the listing is marked sold.
soldDate	string	Sold date, when marked sold.
createdAt	string	Date the listing was created (YYYY-MM-DD).
updatedAt	string	Date the listing was last updated (YYYY-MM-DD).
description	string	Full listing description (details add-on).
amenities	array	Amenities and features (details add-on).
amenitiesDetailed	array	Amenities with their group (details add-on).
images	array	Full image gallery URLs (details add-on).
technicalSheet	array	Technical sheet rows { label, field, value } (details add-on).
socialMediaLinks	array	Share / social links (details add-on).
aiListingSummary	string	AI summary when withAiSummary is on, otherwise null.
aiFeatures	object	AI feature extract when withAiFeatures is on, otherwise null.
aiTitleEn	string	AI English title when withAiTranslate is on, otherwise null.
aiTranslation	string	AI English translation when withAiTranslate is on, otherwise null.
observedAt	string	ISO 8601 timestamp of collection.
error	string	null on success. On a failed source, one item with a populated error is written instead.

Use cases

• Real estate market research for Colombia: track prices per m2, admin fees and estrato by neighborhood and city.
• Lead generation for agents and proptech: build lists of agencies and advertisers with public profiles and contact.
• Price monitoring and comps across Bogota, Medellin, Cali, Barranquilla and Cartagena.
• Map and geo analysis using coordinates on every listing.
• AI and data pipelines that need clean, deduplicated property data (inmuebles en venta y arriendo) in JSON or CSV.

Run via API and CLI

Start a run and read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~fincaraiz-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrl":"https://www.fincaraiz.com.co/venta/apartamentos/bogota-dc","maxListings":25,"withDetails":true}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~fincaraiz-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"operation":"arriendo","propertyType":"casas","city":"medellin","maxListings":100}'

Apify CLI:

apify call scrapers_lat/fincaraiz-scraper \
  --input '{"searchQueries":["venta apartamentos bogota-dc"],"maxListings":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets.

Billing and limits

• Pay per result. You are charged per listing returned (result event). See the pricing tab for the current per-result price.
• Details add-on. withDetails attaches the rich block (description, amenities, gallery, advertiser contact, technical sheet) and is billed per enriched record. It requires a paid Apify plan.
• AI add-ons. withAiSummary, withAiFeatures and withAiTranslate are billed only when they produce usable output, and require a paid Apify plan.
• No charge on failure. If a source errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 listings per run. Upgrade for higher maxListings.

FAQ and troubleshooting

A run returned 0 records. Why? The search matched no listings, the URL was not a Fincaraiz page, or your filters excluded everything. Open the URL in a browser to confirm it shows listings. Zero-result runs are not charged.

How do I control which listings I get? Build the search on fincaraiz.com.co with the filters you want, then paste that URL, or use operation + propertyType + city, or a searchQueries list. You can further narrow with minPrice, maxPrice, minBedrooms, minBathrooms, minAreaM2 and maxAreaM2.

What does the details add-on add? Full description, complete amenities list, full image gallery, technical sheet, social links, and the advertiser contact (phone and WhatsApp when the advertiser exposes them). Disable it for a lighter run that keeps the core listing fields.

Why are some fields null? Not every listing publishes every field (for example constructionYear, stratum or projectName). Missing source values are returned as null, never invented.

Can I get results in English? Enable withAiTranslate for an English title and description, and withAiFeatures for normalized English feature tags. Both are paid add-ons.

Is this an official Fincaraiz tool? No. This actor is independent and has no affiliation with Fincaraiz or InfoCasas. It reads only data that is publicly available on fincaraiz.com.co.

Related scrapers

• Metrocuadrado Colombia Scraper: Colombian real estate listings from Metrocuadrado.
• Properati Scraper: Latin American property listings.
• Inmuebles24 Scraper: Mexican real estate listings.
• Adondevivir Scraper: Peruvian real estate listings.
• Plusvalia Scraper: Ecuadorian real estate listings.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

Independent tool, not affiliated with Fincaraiz. Accesses only publicly available fincaraiz.com.co data.

---

Fincaraiz Scraper: Datos Inmobiliarios y API de Colombia

El scraper de Fincaraiz mas completo para datos inmobiliarios de Colombia. Convierte cualquier busqueda de fincaraiz.com.co en un dataset limpio de avisos de propiedades en venta o arriendo: apartamentos, casas, oficinas, lotes, fincas y mas, en Bogota, Medellin, Cali, Barranquilla, Cartagena y todas las demas ciudades del portal.

Una fila normalizada por aviso con precio en COP y USD, cuota de administracion, estrato, habitaciones, banos, area en m2, precio por m2, barrio, ciudad, departamento, coordenadas del mapa, amenidades, la galeria completa de imagenes y el contacto del anunciante o inmobiliaria. Exporta a JSON, CSV o Excel, o consumelo directo desde la API.

Palabras clave: scraper de Fincaraiz, API de Fincaraiz, datos inmobiliarios Colombia, scraper de propiedades Colombia, apartamentos y casas en Colombia, inmuebles en venta y arriendo, bienes raices Colombia.

Aca tienes un resultado real (arreglos de imagenes y amenidades recortados por espacio, valores reales):

{
  "listingId": "194024116",
  "referenceCode": "194024116",
  "sourceMode": "search",
  "title": "Apartamento en Venta en Chico norte, Bogota",
  "url": "https://www.fincaraiz.com.co/apartamento-en-venta-en-chico-norte-bogota/194024116",
  "price": 1100000000,
  "currency": "COP",
  "priceUsd": 341354,
  "priceWithAdmin": 1101414000,
  "pricePerM2": 8943089,
  "pricePerM2Usd": 2775,
  "adminFee": 1414000,
  "operationType": "Venta",
  "propertyType": "Apartamento",
  "bedrooms": 2,
  "bathrooms": 3,
  "parkingSpaces": 2,
  "areaM2": 123,
  "stratum": 6,
  "floor": 3,
  "propertyCondition": "Usado",
  "neighborhood": "Chico norte",
  "city": "Bogota",
  "department": "Bogota, d.c.",
  "country": "Colombia",
  "coordinates": { "lat": 4.678526, "lng": -74.052898 },
  "advertiser": { "name": "Ronald Morales", "type": "inmobiliaria", "hasWhatsapp": true, "whatsapp": "+573001234567" },
  "observedAt": "2026-07-28T17:07:52.133Z",
  "error": null
}

📥 Entrada · 📤 Salida · 💰 Precios · ▶️ Ejemplos

Tabla de contenido

• Que hace
• Por que este scraper
• Como se compara
• Inicio rapido
• Referencia de entrada
• Referencia de salida
• Casos de uso
• Uso por API y CLI
• Obtener resultados
• Cobros y limites
• Preguntas frecuentes

Que hace

Dale al actor una busqueda de Fincaraiz: una URL de resultados, un lote de URLs, una consulta de texto como venta apartamentos bogota-dc, o un operation + propertyType + city estructurado. Pagina los avisos que coinciden y escribe un registro normalizado por propiedad, sin duplicados por id de aviso.

Cada ejecucion devuelve los campos base para todos los usuarios: precio en COP y USD, cuota de administracion, estrato, habitaciones, banos, parqueaderos, area (construida, total, privada, terraza, lote), piso, pisos del edificio, antiguedad, estado de la propiedad, barrio, localidad, ciudad, departamento, pais, coordenadas del mapa, imagen principal, cantidad de imagenes, indicadores de video y tour 3D, indicadores de proyecto u obra nueva, y el nombre, tipo, logo y perfil publico de la inmobiliaria.

Activa el complemento details para adjuntar tambien la descripcion completa, la lista completa de amenidades, la galeria completa de imagenes, la ficha tecnica, los enlaces sociales y el contacto del anunciante (telefono y WhatsApp cuando son publicos). Tres complementos de IA opcionales agregan un resumen en ingles, etiquetas de caracteristicas normalizadas en ingles y una traduccion al ingles del titulo y la descripcion.

Por que este scraper

• Ambas monedas, siempre. price en COP mas un priceUsd nativo, y pricePerM2 y pricePerM2Usd, para que nunca tengas que convertir.
• Especificos de Colombia. stratum (estrato) validado de 1 a 6, adminFee (administracion), priceWithAdmin y propertyCondition (nuevo, usado, en pozo).
• Leads contactables. Nombre, tipo, logo y perfil publico de la inmobiliaria y, con el complemento details, telefono y WhatsApp cuando el anunciante los expone.
• Listo para mapa. Coordenadas reales (lat, lng) en cada aviso, mas barrio, localidad, ciudad, departamento y pais.
• Entrada flexible. Pega una URL, un lote de URLs, consultas de texto, o operacion + tipo + ciudad, y filtra por precio, habitaciones, banos o area.
• Nulos honestos. Los valores ausentes se devuelven como null, nunca inventados. Sin cobro en fallos y con un tope de gasto que tu controlas.

Como se compara

Capacidad	Este actor	memo23/fincaraiz-property-scraper	hernan_restrepo/fincaraiz-property-scraper
Entrada por URL de resultados	Si	Si	No
Lote startUrls	Si	Si	No
Consultas de texto searchQueries	Si	Si	No
Operacion + tipo + ciudad estructurado	Si	No	Si
URL de una propiedad	Si	Si	No
Filtros (precio, habitaciones, banos, area)	Si	No	No
Precio en COP y USD	Si	Si	No
Precio por m2 (COP y USD)	Si	No	No
Cuota de administracion	Si	Si	No
Estrato	Si	Si	No
Coordenadas del mapa	Si	Si	No
Amenidades y galeria completa	Si	Si	No
Contacto del anunciante (telefono / WhatsApp)	Si	Parcial	No
Indicadores de proyecto / obra nueva	Si	No	No
Video y tour 3D	Si	No	No
Resumen, caracteristicas y traduccion con IA	Si	No	No
Tope de gasto y sin cobro en fallos	Si	No documentado	No documentado
Campos devueltos	~65	~40	12

Este actor es un superconjunto estricto: acepta toda entrada que aceptan las alternativas y devuelve todo campo que ellas devuelven, mas precio por m2 en dos monedas, indicadores de proyecto, video y tour 3D, contacto del anunciante mas rico, filtros y enriquecimiento con IA opcional.

Inicio rapido

Abre el actor, pega esta entrada y presiona Run. Devuelve 10 apartamentos en venta en Bogota con detalles completos.

{
  "startUrl": "https://www.fincaraiz.com.co/venta/apartamentos/bogota-dc",
  "maxListings": 10,
  "withDetails": true
}

Arma el startUrl en fincaraiz.com.co: aplica tus filtros (operacion, tipo de inmueble, ciudad, precio) y pega la URL resultante. O salta la URL y usa operation + propertyType + city, o una lista searchQueries.

Referencia de entrada

Campo	Tipo	Requerido	Predeterminado	Descripcion
startUrl	string	no	(URL de ejemplo)	Una URL de resultados de Fincaraiz, o la URL de una propiedad.
startUrls	array	no	(vacio)	Varias URLs de busqueda o de propiedad (strings o { "url": "..." }), clasificadas automaticamente.
searchQueries	array	no	(vacio)	Consultas de texto <operacion> <tipo> <ciudad>, por ejemplo venta apartamentos bogota-dc.
operation	string	no	(vacio)	venta o arriendo para una busqueda estructurada.
propertyType	string	no	(vacio)	Slug del tipo de inmueble, por ejemplo apartamentos, casas, oficinas, lotes.
city	string	no	(vacio)	Slug de ciudad, por ejemplo bogota-dc, medellin, cali.
maxListings	integer	no	10	Tope total de avisos. Los planes gratuitos estan limitados a 10 por ejecucion.
maxItems	integer	no	(sin valor)	Alias de maxListings.
maxItemsPerSearch	integer	no	(sin valor)	Tope por cada busqueda individual.
maxPages	integer	no	(sin valor)	Maximo de paginas por busqueda (unos 21 avisos por pagina).
withDetails	boolean	no	true	Adjunta descripcion, amenidades, galeria completa, contacto, ficha tecnica y enlaces sociales (complemento pago).
scrapeDetails	boolean	no	(sin valor)	Alias de withDetails.
minPrice / maxPrice	integer	no	(sin valor)	Conserva avisos dentro de este rango de precio (moneda del aviso, tipicamente COP).
minBedrooms / minBathrooms	integer	no	(sin valor)	Conserva avisos con al menos estas habitaciones / banos.
minAreaM2 / maxAreaM2	integer	no	(sin valor)	Conserva avisos dentro de este rango de area en m2.
maxConcurrency	integer	no	(auto)	Tareas de paginas y enriquecimiento en paralelo, 1 a 8.
maxRequestRetries	integer	no	(auto)	Reintentos por peticion fallida, 0 a 6.
withAiSummary	boolean	no	false	Resumen del aviso en ingles con IA (complemento pago).
withAiFeatures	boolean	no	false	Etiquetas de caracteristicas en ingles, estado y aspectos destacados con IA (complemento pago).
withAiTranslate	boolean	no	false	Traduccion del titulo y la descripcion del espanol al ingles con IA (complemento pago).
proxyConfiguration	object	no	Apify Proxy (Colombia)	Configuracion de proxy. Se recomienda residencial para ejecuciones grandes.

Referencia de salida

Un item por aviso. Tipos: string, number, boolean, array, object, o null cuando el valor de origen no existe. Los campos de detalle se completan con el complemento details activo.

Campo	Tipo	Descripcion
listingId	string	Id del aviso en Fincaraiz.
referenceCode	string	Codigo de referencia del anunciante.
sourceMode	string	search o property, segun la entrada que genero la fila.
title	string	Titulo del aviso.
url	string	URL canonica del aviso.
price	number	Precio en la moneda del aviso.
currency	string	Moneda del precio, tipicamente COP.
priceUsd	number	Precio en dolares.
priceWithAdmin	number	Precio mas cuota de administracion, cuando esta disponible.
priceWithAdminUsd	number	Precio mas administracion, en dolares.
pricePerM2	number	Precio por metro cuadrado (moneda del aviso).
pricePerM2Usd	number	Precio por metro cuadrado en dolares.
adminFee	number	Cuota mensual de administracion, o null.
priceHidden	boolean	Si el anunciante oculto el precio.
includesAdministration	boolean	Si el precio incluye administracion.
acceptsBarter	boolean	Si el anunciante acepta permuta.
operationType	string	Venta o Arriendo.
propertyType	string	Tipo de inmueble, por ejemplo Apartamento, Casa.
bedrooms	integer	Habitaciones (0 se conserva para aparta estudios).
bathrooms	integer	Banos.
parkingSpaces	integer	Parqueaderos (0 se conserva).
rooms	integer	Ambientes totales.
guests	integer	Capacidad de huespedes, cuando se publica.
areaM2	number	Area publicada en metros cuadrados.
builtAreaM2	number	Area construida en metros cuadrados.
totalAreaM2	number	Area total en metros cuadrados.
privateAreaM2	number	Area privada en metros cuadrados, o null.
terraceAreaM2	number	Area de terraza en metros cuadrados, o null.
landAreaM2	number	Area de lote en metros cuadrados, o null.
hectares	number	Terreno en hectareas, para propiedades rurales.
stratum	integer	Estrato socioeconomico (1 a 6), o null.
floor	integer	Numero de piso (0 para primer piso).
buildingFloors	integer	Numero de pisos del edificio.
antiquity	integer	Antiguedad en anos, o null.
antiquityText	string	Rango de antiguedad, por ejemplo 9 a 15 anos.
constructionYear	integer	Ano de construccion, o null.
propertyCondition	string	Estado (nuevo, usado, en pozo), o null.
seaView	boolean	Si el aviso anuncia vista al mar.
isProject	boolean	Si el aviso es un proyecto.
isProjectUnit	boolean	Si el aviso es una unidad dentro de un proyecto.
projectName	string	Nombre del proyecto, cuando esta disponible.
address	string	Direccion, cuando se publica.
neighborhood	string	Barrio.
locality	string	Localidad o zona.
city	string	Ciudad.
department	string	Departamento.
country	string	Pais.
coordinates	object	Coordenadas { lat, lng }, o null.
imageUrl	string	URL de la imagen principal.
imageCount	integer	Cantidad de imagenes en la galeria.
hasVideo	boolean	Si el aviso tiene video.
videoUrl	string	URL del video, o null.
hasTour3d	boolean	Si el aviso tiene tour 3D.
tour3dUrl	string	URL del tour 3D, o null.
advertiser	object	name, type, hasWhatsapp, profileUrl, logo; el complemento details agrega phone, whatsapp, maskedPhone, address, subsidiaries.
sold	boolean	Si el aviso esta marcado como vendido.
soldDate	string	Fecha de venta, cuando aplica.
createdAt	string	Fecha de creacion del aviso (YYYY-MM-DD).
updatedAt	string	Fecha de ultima actualizacion (YYYY-MM-DD).
description	string	Descripcion completa (complemento details).
amenities	array	Amenidades y caracteristicas (complemento details).
amenitiesDetailed	array	Amenidades con su grupo (complemento details).
images	array	URLs de la galeria completa (complemento details).
technicalSheet	array	Filas de la ficha tecnica { label, field, value } (complemento details).
socialMediaLinks	array	Enlaces sociales o de compartir (complemento details).
aiListingSummary	string	Resumen con IA cuando withAiSummary esta activo, si no null.
aiFeatures	object	Extracto de caracteristicas con IA cuando withAiFeatures esta activo, si no null.
aiTitleEn	string	Titulo en ingles con IA cuando withAiTranslate esta activo, si no null.
aiTranslation	string	Traduccion al ingles con IA cuando withAiTranslate esta activo, si no null.
observedAt	string	Marca de tiempo ISO 8601 de la extraccion.
error	string	null en exito. Si una fuente falla, se escribe un item con error en su lugar.

Casos de uso

• Estudios de mercado inmobiliario en Colombia: sigue precios por m2, cuotas de administracion y estrato por barrio y ciudad.
• Generacion de leads para agentes y proptech: arma listas de inmobiliarias y anunciantes con perfil publico y contacto.
• Monitoreo de precios y comparables en Bogota, Medellin, Cali, Barranquilla y Cartagena.
• Analisis de mapa y geografia usando las coordenadas de cada aviso.
• Pipelines de IA y datos que necesitan datos de propiedades limpios y sin duplicados (inmuebles en venta y arriendo) en JSON o CSV.

Uso por API y CLI

Inicia una ejecucion y lee el dataset. Reemplaza <TOKEN> con tu token de API de Apify.

Ejecuta de forma sincronica y obten los items en una sola llamada:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~fincaraiz-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"startUrl":"https://www.fincaraiz.com.co/venta/apartamentos/bogota-dc","maxListings":25,"withDetails":true}'

Inicia una ejecucion de forma asincronica:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~fincaraiz-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"operation":"arriendo","propertyType":"casas","city":"medellin","maxListings":100}'

Apify CLI:

apify call scrapers_lat/fincaraiz-scraper \
  --input '{"searchQueries":["venta apartamentos bogota-dc"],"maxListings":50}'

Obtener resultados

Cada ejecucion escribe en un dataset. Obten los items en JSON, CSV o Excel cambiando format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginar datasets grandes
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> se devuelve como defaultDatasetId en el objeto de la ejecucion. Usa offset y limit para paginar resultados grandes.

Cobros y limites

• Pago por resultado. Se cobra por aviso devuelto (evento result). Consulta la pestana de precios para el precio vigente por resultado.
• Complemento details. withDetails adjunta el bloque enriquecido (descripcion, amenidades, galeria, contacto, ficha tecnica) y se cobra por registro enriquecido. Requiere un plan pago de Apify.
• Complementos de IA. withAiSummary, withAiFeatures y withAiTranslate se cobran solo cuando producen salida util, y requieren un plan pago de Apify.
• Sin cobro en fallos. Si una fuente falla, el actor escribe un item con error y no cobra por el. Las ejecuciones vacias no cuestan nada.
• Tope de gasto respetado. Configura maxTotalChargeUsd en la ejecucion; al alcanzarlo, el actor deja de emitir y cobrar resultados.
• Planes gratuitos de Apify limitados a 10 avisos por ejecucion. Mejora tu plan para un maxListings mayor.

Preguntas frecuentes

Una ejecucion devolvio 0 registros. Por que? La busqueda no encontro avisos, la URL no era una pagina de Fincaraiz, o tus filtros excluyeron todo. Abre la URL en un navegador para confirmar que muestra avisos. Las ejecuciones sin resultados no se cobran.

Como controlo que avisos obtengo? Arma la busqueda en fincaraiz.com.co con los filtros que quieras y pega esa URL, o usa operation + propertyType + city, o una lista searchQueries. Puedes afinar con minPrice, maxPrice, minBedrooms, minBathrooms, minAreaM2 y maxAreaM2.

Que agrega el complemento details? Descripcion completa, lista completa de amenidades, galeria completa de imagenes, ficha tecnica, enlaces sociales y el contacto del anunciante (telefono y WhatsApp cuando el anunciante los expone). Desactivalo para una ejecucion mas liviana con los campos base.

Por que algunos campos son null? No todo aviso publica todos los campos (por ejemplo constructionYear, stratum o projectName). Los valores ausentes se devuelven como null, nunca inventados.

Puedo obtener resultados en ingles? Activa withAiTranslate para titulo y descripcion en ingles, y withAiFeatures para etiquetas de caracteristicas en ingles. Ambos son complementos pagos.

Es una herramienta oficial de Fincaraiz? No. Este actor es independiente y no tiene afiliacion con Fincaraiz ni InfoCasas. Solo lee datos disponibles publicamente en fincaraiz.com.co.

Herramienta independiente, sin afiliacion con Fincaraiz. Accede solo a datos disponibles publicamente en fincaraiz.com.co.