# Casa.it Scraper — Italy Real Estate Data (`logiover/casa-it-scraper-italy-real-estate`) Actor
Scrape Italian real estate listings from Casa.it (no browser, no API key). Filter by location, sale/rent, property type, price (EUR), area, rooms & seller. Returns price, price/m², GPS, full address, agency phone & website, energy class and image gallery per listing.
- **URL**: https://apify.com/logiover/casa-it-scraper-italy-real-estate.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** Real estate, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $3.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.
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
## Casa.it Scraper — Italy Real Estate Listings, Prices & Agent Leads (No API)
    
Scrape property listings from **Casa.it**, one of Italy's largest real-estate portals, with hundreds of thousands of active listings across every region. This **Casa.it scraper** extracts apartments, villas, penthouses, terraced houses, detached houses, farmhouses, lofts and studios — for **sale (vendita)** or **rent (affitto)** — filtered by location, property type, price in **EUR**, surface area (m²), rooms, bathrooms and seller type. Every row carries price and **price per m²**, monthly rent, GPS coordinates, a full Italian address breakdown (street, district, city, province, region), **agency contact details** (phone + website), energy class and image galleries — parsed straight from Casa.it's embedded `__INITIAL_STATE__` JSON, so it runs **fast, with no browser and no API key required.**
> ### 🏆 Why this Casa.it scraper?
> **60+ fields per listing** · **thousands of listings per run** · price + EUR/m² · monthly rent for rentals · full Italian address + GPS · energy class (A4–G) · **agency phone + website** · image gallery · sale & rent · export to JSON / CSV / Excel. The unofficial **Casa.it API alternative** for Italian real-estate data and agency leads.
---
### ✨ What this Actor does / Key features
- 🏠 **Every residential type** — apartments (appartamenti), villas (ville), penthouses/attics (attici e mansarde), terraced houses (villette a schiera), detached houses (case indipendenti), farmhouses (rustici e casali), lofts, studios (monolocali) and 2/3/4-room flats, for sale or rent.
- 📍 **Nationwide location targeting** — scrape any Italian city, province or zone (Roma, Milano, Napoli, Torino, Firenze, Bologna and thousands more) via URL location slugs; pass many in one run.
- 💰 **Powerful filters** — price range (EUR), surface-area range (m²), room range, minimum bathrooms, seller type (agency vs. private) and flexible sort order (relevance, latest, price or area, ascending/descending).
- 🗺️ **Full address & GPS** — street, block, district, city, province and region, plus latitude/longitude for every listing — ready for mapping and heatmaps.
- 🏢 **Agency contact data embedded** — agency name, ID, slug, logo, profile URL, **phone number**, website and postal address, plus the private-vs-agency seller flag for lead gen.
- ⚡ **Energy class, mortgage estimate & media flags** — energy efficiency class (A4–G), estimated monthly mortgage, image count, floorplan count and video / 360° / 3D-tour flags.
- 🖼️ **Image galleries** — main image URL plus the full list of image URLs at your chosen resolution (up to 1280×960).
- 🧩 **Direct HTTP + JSON extraction** — parses Casa.it's `__INITIAL_STATE__` payload; no browser, no DOM walking, no GraphQL token.
- 🛡️ **DataDome-aware proxy handling** — Apify residential proxy with a realistic browser fingerprint, user-agent rotation and automatic IP rotation on blocks.
- 📤 **Export anywhere** — one structured row per listing to **JSON, CSV, Excel or XML**, or pull from the Apify API and webhooks.
---
### 🚀 Quick start (3 steps)
1. **Configure** — set one or more `locationSlugs` (e.g. `["roma", "milano"]`), choose `transaction` (sale/rent) and `propertyType`, then add any price, area, room, bathroom or seller filters. Cap the run with `maxListings`.
2. **Run** — click **Start**. The Actor builds a Casa.it search per slug, fetches each page over residential proxy, parses the embedded `__INITIAL_STATE__` JSON and paginates up to `maxPagesPerTask`.
3. **Get your data** — open the **Output** tab and export as **JSON, CSV, Excel or XML**, or pull it from the Apify API. One clean row per listing, with price, EUR/m², address, agency contact and GPS included.
---
### 📥 Input
The only required field is `locationSlugs` — every other field has a sensible default. Each slug becomes its own scraping task, so you can benchmark several Italian cities in a single run.
**Example 1 — Rome & Milan apartments for sale, filtered**
```json
{
"locationSlugs": ["roma", "milano"],
"transaction": "sale",
"propertyType": "apartment",
"priceMin": 150000,
"priceMax": 600000,
"areaMin": 50,
"areaMax": 120,
"roomsMin": 2,
"bathroomsMin": 1,
"sort": "price_asc",
"maxListings": 500,
"maxPagesPerTask": 10,
"proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IT" }
}
````
**Example 2 — private-seller (privato) rentals in Naples for lead gen**
```json
{
"locationSlugs": ["napoli"],
"transaction": "rent",
"propertyType": "all",
"sellerType": "private",
"sort": "latest",
"maxListings": 300,
"proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IT" }
}
```
**Example 3 — villas for sale across multiple cities, largest first**
```json
{
"locationSlugs": ["firenze", "bologna", "torino"],
"transaction": "sale",
"propertyType": "villa",
"areaMin": 150,
"sort": "area_desc",
"imageSize": "1024x768",
"maxListings": 1000,
"maxPagesPerTask": 20,
"proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IT" }
}
```
> **Finding a location slug:** browse casa.it, apply a location filter, and copy the segment that follows `/vendita/residenziale/` (for sale) or `/affitto/residenziale/` (for rent) in the URL. For example, `https://www.casa.it/vendita/residenziale/roma/` → slug `roma`. Use a city, a province or a deeper zone segment.
| Field | Type | Description |
|-------|------|-------------|
| `locationSlugs` | array | Casa.it URL location paths. Each slug becomes its own task (e.g. `roma`, `milano`, `napoli`). **Required.** |
| `transaction` | string | `sale` (vendita) or `rent` (affitto). |
| `propertyType` | string | `all`, `apartment`, `penthouse`, `villa`, `terraced_house`, `detached_house`, `farmhouse`, `loft`, `studio`, `two_room`, `three_room` or `four_room`. |
| `priceMin` / `priceMax` | integer | Min / max price in EUR (or monthly rent for rentals). 0 = no bound. |
| `areaMin` / `areaMax` | integer | Min / max surface area in m². 0 = no bound. |
| `roomsMin` / `roomsMax` | integer | Min / max room count (locali). 0 = no bound. |
| `bathroomsMin` | integer | Minimum number of bathrooms (bagni). 0 = no minimum. |
| `sellerType` | string | `all`, `agency` or `private`. |
| `sort` | string | Result ordering: `relevance`, `latest`, `price_asc`, `price_desc`, `area_asc`, `area_desc`. |
| `imageSize` | string | Image CDN resolution: `360x270`, `800x600`, `1024x768` or `1280x960`. |
| `maxListings` | integer | Total cap across all location tasks. 0 = unlimited. |
| `maxPagesPerTask` | integer | Pagination depth per location (~20–25 listings per page). |
| `requestDelay` | integer | Delay between page requests in milliseconds (keep ≥ 600 ms). |
| `maxRetries` | integer | Retries per page on anti-bot blocks (rotates proxy IP). Casa.it uses DataDome, so 6–10 is recommended. |
| `proxyConfiguration` | object | Apify Proxy settings. **Residential with country=IT strongly recommended** — datacenter proxies are blocked. |
***
### 📤 Output
Each property listing is saved as one structured row in the dataset. Below is a trimmed sample; the full 60+ field reference follows. Export to JSON, CSV, Excel or XML, or pull via the Apify API.
```json
{
"adId": "82715349",
"detailUrl": "https://www.casa.it/immobili/82715349.html",
"title": "Trilocale via Nazionale, Centro Storico, Roma",
"transactionType": "sale",
"channel": "vendita",
"propertyType": "appartamento",
"propertyTypeGroup": "case",
"price": "395000",
"priceLabel": "€ 395.000",
"priceCurrency": "EUR",
"pricePerSqm": "4938",
"monthlyRent": null,
"mortgage": "1420",
"areaSqm": "80",
"rooms": "3",
"bathrooms": "2",
"energyClass": "C",
"floor": "3",
"street": "Via Nazionale",
"district": "Centro Storico",
"city": "Roma",
"province": "Roma",
"region": "Lazio",
"fullAddress": "Via Nazionale, Centro Storico, Roma (RM)",
"latitude": "41.8987",
"longitude": "12.4901",
"mainImageUrl": "https://images.immobiliare.it/.../800x600.jpg",
"imageCount": "18",
"hasVideo": "true",
"publisherName": "Roma Immobiliare Srl",
"publisherType": "Agency",
"publisherPhone": "+39 06 1234567",
"publisherWebsite": "https://www.romaimmobiliare.it",
"publisherUrl": "https://www.casa.it/agenzie/roma-immobiliare",
"searchLocation": "roma",
"searchUrl": "https://www.casa.it/vendita/residenziale/roma/",
"scrapedAt": "2026-07-06T09:15:00.000Z"
}
```
📋 Full field reference (click to expand)
| Field | Description |
|-------|-------------|
| `adId` | Casa.it stable listing ID |
| `detailUrl` | Full listing detail URL |
| `title` | Listing title |
| `titleExtra` | Additional title / zone label |
| `description` | Listing description snippet |
| `transactionType` | sale or rent |
| `channel` | Raw channel (vendita / affitto) |
| `category` | Casa.it category (residenziale, …) |
| `propertyType` | Property type slug (appartamento, villa, …) |
| `propertyTypeGroup` | Property type group (case, …) |
| `price` | Asking price for sales (null for rentals) |
| `priceLabel` | Formatted price string as shown on the site |
| `priceCurrency` | Currency code (EUR) |
| `pricePerSqm` | Price per square meter (EUR/m²) |
| `monthlyRent` | Monthly rent for rentals (null for sales) |
| `mortgage` | Estimated monthly mortgage |
| `hasPriceRange` | True if the price is a range |
| `areaSqm` | Surface area in m² |
| `rooms` | Number of rooms (locali) |
| `bathrooms` | Number of bathrooms (bagni) |
| `parkings` | Number of parking spaces / boxes |
| `energyClass` | Energy efficiency class (A4–G) |
| `availability` | Availability status (libero, …) |
| `floor` | Floor / level |
| `isAuction` | Whether the listing is an auction |
| `isNewDevelopment` | Whether it is a new-development project |
| `depth` | Listing prominence tier (platinum, …) |
| `labels` | Listing badge labels (IN ESCLUSIVA, …) |
| `street` | Street name |
| `block` | Block / micro-zone name |
| `district` | District / neighbourhood |
| `city` | City / comune |
| `province` | Province |
| `region` | Region (regione) |
| `fullAddress` | Composed full address string |
| `latitude` | GPS latitude |
| `longitude` | GPS longitude |
| `mainImageUrl` | Main listing image URL |
| `imageUrls` | Array of all image URLs |
| `imageCount` | Number of images |
| `floorplanCount` | Number of floorplan images |
| `hasVideo` | Whether a video is present |
| `has360` | Whether a 360° photo is present |
| `has3dTour` | Whether a 3D virtual tour is present |
| `publisherId` | Agency / publisher ID |
| `publisherName` | Agency / publisher name |
| `publisherType` | Publisher type (Agency, …) |
| `publisherSlug` | Publisher URL slug |
| `publisherPhone` | Agency contact phone number |
| `publisherWebsite` | Agency website |
| `publisherLogoUrl` | Agency logo image URL |
| `publisherUrl` | Agency profile URL on Casa.it |
| `publisherStreet` | Agency street address |
| `publisherTown` | Agency town |
| `publisherProvince` | Agency province |
| `publisherPostcode` | Agency postcode (CAP) |
| `refPublisher` | Publisher-side reference code |
| `searchTransaction` | Transaction type used for this search |
| `searchPropertyType` | Property type used for this search |
| `searchLocation` | Location slug used for this search |
| `searchUrl` | Full search URL used |
| `scrapedAt` | Scrape timestamp (ISO 8601) |