# Casa Property Search Scraper (`solidcode/casa-property-search-scraper`) Actor \[💰 $1.5 / 1K] Scrape comprehensive property listings from Casa.it with detailed features, pricing, locations, and agency contact information. - **URL**: https://apify.com/solidcode/casa-property-search-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 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. 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 ## Casa Property Search Scraper Extract Italian home and commercial property listings from Casa.it at scale — complete with detailed features, geo data, pricing, and verified agency contact information. Built for real estate investors, property agents, and market analysts who need fresh Casa.it data without manually browsing or building their own scraper. ### Why This Scraper? - **Cover all 8,000+ Italian municipalities** — search by city or region: Roma, Milano, Firenze, Napoli, Torino, Bologna, and every regional capital on Italy's coast and inland - **Extract 5 property type categories** — apartments (appartamento), houses (casa), villas (villa), land (terreno), and commercial spaces (locale) with full feature details - **Get verified agency contacts on every listing** — publisher name, phone number, and website URL for lead generation and agent outreach - **Exact coordinates on every property** — latitude, longitude, street address, city, and region for mapping, geospatial analysis, and location-based filtering - **Up to 1,000+ results per search without manual pagination** — feed the actor a city name or search URL and collect everything in one run - **Price filters built in** — slice by €100k–€5M range to narrow high-value segments - **Export bilingual data** — choose Italian or English output labels to fit your team's workflow and analysis tools ### Use Cases **Investment & Portfolio Analysis** - Build a price-per-square-meter comparison matrix across 20 cities - Track new listings in target neighborhoods and flag off-market opportunities - Analyze price trends by bedrooms, location, and property type across a year of listings **Real Estate Lead Generation** - Compile agency contact lists from active listings for cold outreach campaigns - Identify top-performing agents by their listing density and sale velocity - Create targeted call lists for specific cities, price ranges, and property types **Market Research & Competitive Intelligence** - Benchmark Casa.it inventory against competitor platforms - Monitor supply changes when filtering by region, property type, and price tier - Detect emerging micromarkets with sudden price spikes or listing velocity increases **Relocation & Buyer Services** - Build personalized property recommendations by filtering price and bedroom count - Export neighborhood comparables for appraisals and CMA reports - Create searchable, sortable property catalogs for client presentations **Data Enrichment & Analytics** - Join Casa.it listings with property tax, flood risk, or school district data - Bulk-geocode properties and visualize supply clusters on a map - Feed listing data into a predictive pricing or demand forecasting model **Real Estate CRM & Workflow Automation** - Push new listings to team members via Zapier or Make workflows - Bulk-import properties into Google Sheets for tracking and follow-up - Trigger alerts when listings match predefined search criteria ### Getting Started #### Basic City Search The simplest possible run — search one Italian city, get 20 properties: ```json { "searchLocation": "Roma", "maxResults": 20 } ```` #### Filtered Search (Price) Find affordable properties in Milan under €500k: ```json { "searchLocation": "Milano", "propertyType": "appartamento", "priceMin": 100000, "priceMax": 500000, "maxResults": 50 } ``` #### URL-Based Search (Most Powerful) Paste a Casa.it search results page URL directly — the actor uses Casa.it's own filters: ```json { "startUrls": ["https://www.casa.it/vendita/appartamenti/roma/?pmin=200000&pmax=600000"], "maxResultsPerUrl": 100, "maxResults": 0 } ``` #### Advanced Multi-City Batch Scrape multiple cities in one run with language preference: ```json { "searchLocation": "Roma", "maxResults": 100, "language": "en", "ignoreUrlFailures": true, "maxResultsPerUrl": 50 } ``` ### Input Reference #### What to Scrape | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `startUrls` | array | — | Paste Casa.it search result page URLs directly. Leave empty to use Search Location below. | | `searchLocation` | string | — | City or region name (e.g., "Roma", "Milano", "Toscana"). Works with filters below. | #### Filters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `propertyType` | select | All Types | Apartment, House, Villa, Land, or Commercial Space. Only applies when using Search Location. | | `priceMin` | integer | — | Minimum price in euros. Leave empty for no minimum. | | `priceMax` | integer | — | Maximum price in euros. Leave empty for no maximum. | #### Options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `maxResultsPerUrl` | integer | 20 | Maximum properties per URL. Increase to 50–100 for larger searches. | | `maxResults` | integer | 0 | Total maximum results across all URLs. Set to 0 for unlimited. | | `ignoreUrlFailures` | boolean | true | Skip failed URLs and continue, or stop on first failure. | #### Advanced | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `language` | select | Italian | Output labels in Italian or English. | ### Output Here's a sample property listing extracted from Casa.it: ```json { "id": 53865863, "title": "Elegant 3-bedroom apartment in the heart of Rome", "description": "Spacious apartment in a historic building with original wooden floors, high ceilings, and a private balcony overlooking the neighborhood. Recently renovated kitchen and bathrooms. Close to restaurants, shops, and public transit.", "category": "residenziale", "propertyType": "appartamento", "price": 430000, "location": { "city": "Roma", "region": "Lazio", "coordinates": { "lat": 41.9028, "lon": 12.4964 } }, "features": { "rooms": 3, "bathrooms": 1, "squareMeters": 82 }, "media": { "thumbnailUrl": "https://www.casa.it/image/123456.jpg", "photoUrls": [] }, "publisherName": "Centro Immobiliare Roma", "publisherPhone": "+39 06 1234 5678", "publisherEmail": "", "publisherWebsite": "https://www.centroimmo.it", "url": "https://www.casa.it/annuncio/1234567.html" } ``` #### Core Fields | Field | Type | Description | |-------|------|-------------| | `id` | integer | Unique Casa.it property ID | | `title` | string | Property headline (e.g., "Modern 2BR apartment in Duomo district") | | `description` | string | Full property description and highlights | | `category` | string | Property category (residenziale, commerciale) | | `propertyType` | string | Property type (appartamento, casa, villa, terreno, locale) | | `price` | integer | Price in euros | | `url` | string | Direct link to the property on Casa.it | #### Location & Coordinates | Field | Type | Description | |-------|------|-------------| | `location.city` | string | City name (e.g., "Roma", "Milano") | | `location.region` | string | Region name (e.g., "Lazio", "Lombardia") | | `location.coordinates.lat` | number | Latitude for mapping and geospatial queries | | `location.coordinates.lon` | number | Longitude for mapping and geospatial queries | #### Property Features | Field | Type | Description | |-------|------|-------------| | `features.rooms` | integer | Number of bedrooms | | `features.bathrooms` | integer | Number of bathrooms | | `features.squareMeters` | integer | Property size in square meters | #### Agency & Media | Field | Type | Description | |-------|------|-------------| | `publisherName` | string | Agency or publisher name | | `publisherPhone` | string | Contact phone number | | `publisherEmail` | string | Contact email (if available) | | `publisherWebsite` | string | Agency website URL | | `media.thumbnailUrl` | string | Primary listing image URL | | `media.photoUrls` | array | Additional photo URLs (if available) | ### Tips for Best Results - **Use city names in Italian or English interchangeably** — "Roma" and "Rome" both work. Region names also resolve: "Toscana" / "Tuscany", "Liguria" / "Liguria". The actor handles spelling variations for major cities. - **Set maxResultsPerUrl to 50–100 for deep research** — Casa.it returns ~20 results per page, but you can paginate up to 1,000+ listings in a single run. Increase maxResultsPerUrl to pull all available inventory in one call. - **Use price filters to target high-value segments** — apply priceMin €300k and priceMax €600k to focus on premium properties. The output includes room count and square meters so you can filter post-collection. - **Agency phone numbers are gold for lead generation** — filter by a specific city and property type, then export publisherPhone for targeted outreach. Cross-reference with LinkedIn to find decision-makers. - **URLs are fastest when you already have a Casa.it search** — if you've already filtered on the website, copy the URL from your browser and paste it into startUrls. The actor will respect all Casa.it's filters and pagination. - **Monitor by region, not just individual cities** — search a broader region like "Lombardia" or "Lazio" to capture suburban and rural properties alongside urban listings. Regional searches reveal supply shifts that city-level data can miss. - **Email addresses are rarely available** — Casa.it does not consistently include agency email addresses in listing data. Phone number and website are more reliable for contacting agents. ### Pricing **$1.50 per 1,000 results** — you only pay for properties returned. Run a small test first to estimate your search volume. | Results | Estimated Cost | |---------|----------------| | 100 | $0.15 | | 1,000 | $1.50 | | 10,000 | $15.00 | | 100,000 | $150.00 | **No compute charges — you only pay per result returned.** Platform fees are additional. ### Integrations Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via: - **Zapier** / **Make** / **n8n** — Trigger workflows on new listings; send alerts to Slack or email - **Google Sheets** — Direct spreadsheet export for instant team collaboration - **Slack** / **Email** — Automated notifications when results are ready - **Webhooks** — Trigger custom APIs on run completion - **Apify API** — Full programmatic access for enterprise integrations ### Legal & Ethical Use This actor is designed for personal research, business intelligence, and licensed real estate professional use. Always respect Casa.it's terms of service and Italian data protection laws (GDPR / CCPA). Do not use this actor to violate copyright, resell data without permission, or infringe on Casa.it's intellectual property. Real estate data may contain personal information — handle responsibly and in compliance with local regulations. For questions about permitted use, contact Casa.it's legal team or your legal counsel. # Actor input Schema ## `startUrls` (type: `array`): Paste Casa.it search result page URLs directly. You can copy URLs directly from Casa.it search results (e.g., results for property searches in Roma, Milano, etc.). Leave empty if using Search Location below. ## `searchLocation` (type: `string`): Italian city or region name to search (e.g., 'Roma', 'Milano', 'Napoli', 'Toscana'). Must be the Italian name — English names like 'Rome' or 'Milan' will return no results. Leave empty if using Start URLs above. ## `propertyType` (type: `string`): Type of property to search for. Only applies when using Search Location — ignored when using URLs. ## `priceMin` (type: `integer`): Only include properties at or above this price in euros. Leave empty for no minimum. Only applies to Search Location. ## `priceMax` (type: `integer`): Only include properties at or below this price in euros. Leave empty for no maximum. Only applies to Search Location. ## `maxResultsPerUrl` (type: `integer`): Maximum number of properties to extract from each URL. Increase to 50-100 for large result sets. ## `maxResults` (type: `integer`): Total maximum results to collect across all URLs. Set to 0 for unlimited (not recommended for large searches). ## `ignoreUrlFailures` (type: `boolean`): When enabled, the scraper will skip failed URLs and continue with the remaining ones. When disabled, the entire run stops if any URL fails. ## `language` (type: `string`): Language for output field labels and descriptions. ## Actor input object example ```json { "startUrls": [], "searchLocation": "Roma", "propertyType": "all", "maxResultsPerUrl": 20, "maxResults": 0, "ignoreUrlFailures": true, "language": "it" } ``` # Actor output Schema ## `overview` (type: `string`): Table of extracted properties with key fields: ID, title, price, location, features, and agency contact. ## `detail` (type: `string`): Full property information including description, media URLs, and complete agency details. # 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 = { "startUrls": [], "searchLocation": "Roma", "propertyType": "all", "maxResultsPerUrl": 20, "maxResults": 0, "ignoreUrlFailures": true, "language": "it" }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/casa-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 = { "startUrls": [], "searchLocation": "Roma", "propertyType": "all", "maxResultsPerUrl": 20, "maxResults": 0, "ignoreUrlFailures": True, "language": "it", } # Run the Actor and wait for it to finish run = client.actor("solidcode/casa-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 '{ "startUrls": [], "searchLocation": "Roma", "propertyType": "all", "maxResultsPerUrl": 20, "maxResults": 0, "ignoreUrlFailures": true, "language": "it" }' | apify call solidcode/casa-property-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/casa-property-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Casa Property Search Scraper", "description": "[💰 $1.5 / 1K] Scrape comprehensive property listings from Casa.it with detailed features, pricing, locations, and agency contact information.", "version": "1.0", "x-build-id": "rxXEO96Ue0vakAXdI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~casa-property-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-casa-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/solidcode~casa-property-search-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-casa-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/solidcode~casa-property-search-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-casa-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Paste Casa.it search result page URLs directly. You can copy URLs directly from Casa.it search results (e.g., results for property searches in Roma, Milano, etc.). Leave empty if using Search Location below.", "items": { "type": "string" } }, "searchLocation": { "title": "Search Location", "type": "string", "description": "Italian city or region name to search (e.g., 'Roma', 'Milano', 'Napoli', 'Toscana'). Must be the Italian name — English names like 'Rome' or 'Milan' will return no results. Leave empty if using Start URLs above." }, "propertyType": { "title": "Property Type", "enum": [ "all", "appartamento", "casa", "villa", "terreno", "locale" ], "type": "string", "description": "Type of property to search for. Only applies when using Search Location — ignored when using URLs.", "default": "all" }, "priceMin": { "title": "Minimum Price (€)", "minimum": 0, "type": "integer", "description": "Only include properties at or above this price in euros. Leave empty for no minimum. Only applies to Search Location." }, "priceMax": { "title": "Maximum Price (€)", "minimum": 0, "type": "integer", "description": "Only include properties at or below this price in euros. Leave empty for no maximum. Only applies to Search Location." }, "maxResultsPerUrl": { "title": "Max Properties Per URL", "minimum": 1, "type": "integer", "description": "Maximum number of properties to extract from each URL. Increase to 50-100 for large result sets.", "default": 20 }, "maxResults": { "title": "Max Results Overall", "minimum": 0, "type": "integer", "description": "Total maximum results to collect across all URLs. Set to 0 for unlimited (not recommended for large searches).", "default": 0 }, "ignoreUrlFailures": { "title": "Continue If URLs Fail", "type": "boolean", "description": "When enabled, the scraper will skip failed URLs and continue with the remaining ones. When disabled, the entire run stops if any URL fails.", "default": true }, "language": { "title": "Output Language", "enum": [ "it", "en" ], "type": "string", "description": "Language for output field labels and descriptions.", "default": "it" } } }, "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 } } } } } } } } } } ```