# Fincaraiz Property Search Scraper (`stealth_mode/fincaraiz-property-search-scraper`) Actor Scrape detailed property listings from Fincaraiz.com.co with 120+ data fields. Collect prices, locations, specifications, images, and owner details from hundreds of real estate listings — essential for investors, property aggregators, and market researchers. - **URL**: https://apify.com/stealth\_mode/fincaraiz-property-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, Real estate - **Stats:** 4 total users, 2 monthly users, 83.3% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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: ```json { "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** ```json { "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. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "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": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "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": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/fincaraiz-property-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "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": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/fincaraiz-property-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "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": 20 }' | apify call stealth_mode/fincaraiz-property-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/fincaraiz-property-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Fincaraiz Property Search Scraper", "description": "Scrape detailed property listings from Fincaraiz.com.co with 120+ data fields. Collect prices, locations, specifications, images, and owner details from hundreds of real estate listings — essential for investors, property aggregators, and market researchers.", "version": "0.0", "x-build-id": "5xngJ1UNconerO7ip" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~fincaraiz-property-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-fincaraiz-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~fincaraiz-property-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-fincaraiz-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~fincaraiz-property-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-fincaraiz-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the property list urls to scrape", "type": "array", "description": "Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```