# Immobiliare.it Scraper — Italy Real Estate | $0.69/1K (`bovi/immobiliare-listings`) Actor Scrape Immobiliare.it Italian real estate listings. Returns price, address, city, rooms, surface, floor, GPS coordinates and photos. No proxy needed. Pay per listing. - **URL**: https://apify.com/bovi/immobiliare-listings.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.87 / 1,000 property listings 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Immobiliare.it Scraper — Italian Real Estate | $1.50/1K | No Proxy For Italian property investors, international real estate funds, and PropTech platforms targeting Italy's 1.3M annual transactions market — the largest in Southern Europe. **$1.50 per 1,000 listings**. Luxury and new-construction listings available as premium events. Scrape **Immobiliare.it** — Italy's #1 real estate portal. Extracts structured listing data from any search URL: price, address, city, rooms, surface area, floor, GPS coordinates, and photos. **No proxy required.** No authentication. Parses embedded `__NEXT_DATA__` JSON — stable and fast. ### What you get | Field | Description | |---|---| | `listing_id` | Immobiliare numeric listing ID | | `uuid` | Listing UUID | | `title` | Listing title | | `description` | Full description text | | `price` | Price in EUR (int) | | `price_formatted` | Formatted price string (e.g. "€ 319,000") | | `contract` | "sale" or "rent" | | `property_type` | Type (e.g. "Apartment", "Villa") | | `address` | Street address | | `city` | City name | | `province` | Province | | `region` | Region (e.g. "Lazio") | | `macrozone` | Neighborhood zone | | `microzone` | Sub-neighborhood | | `lat`, `lng` | GPS coordinates | | `surface_m2` | Living area in m² | | `rooms` | Total rooms | | `bathrooms` | Bathrooms | | `bedrooms` | Bedrooms | | `floor` | Floor description | | `energy_class` | EU energy class (A–G) | | `is_new` | New construction flag | | `is_luxury` | Luxury listing flag | | `has_elevator` | Elevator present | | `url` | Full listing URL | | `image_url` | Main photo URL | | `images` | All photo URLs | | `scraped_at` | Scrape timestamp (ISO 8601 UTC) | | `parse_confidence` | Data quality score 0.0–1.0 | | `warnings` | Quality issue codes | ### How it works Immobiliare.it uses Next.js SSR. All listing data is embedded in `__NEXT_DATA__` → `dehydratedState.queries[0].state.data.results` — no DOM parsing, no fragile CSS selectors. Pagination via `?pag=N`. ### Input ```json { "searchUrl": "https://www.immobiliare.it/en/vendita-case/roma/", "maxItems": 50 } ```` Works with any Immobiliare.it search URL — sale/rent, city, neighborhood filters all work. ### Output sample ```json { "listing_id": 99812345, "title": "Appartamento in vendita, Via del Corso, Roma", "price": 319000, "price_formatted": "€ 319,000", "contract": "sale", "property_type": "Apartment", "city": "Roma", "province": "RM", "macrozone": "Centro Storico", "surface_m2": 76, "rooms": 3, "bathrooms": 1, "is_new": false, "is_luxury": false, "lat": 41.8967, "lng": 12.4822, "url": "https://www.immobiliare.it/en/annunci/99812345/", "parse_confidence": 1.0, "warnings": [] } ``` ### Pricing example | Run size | Cost | |---|---| | 50 listings | ~$0.075 | | 1,000 listings | ~$1.50 | | 10,000 listings | ~$15.00 | | + luxury listing | +$2.00/1K | | + new-construction | +$1.00/1K | ### FAQ **Do I need an Immobiliare account or proxy?** No account, no proxy. Works from Apify cloud IPs with both `/en/` (English) and Italian-language URLs. **What output formats are available?** JSON, CSV, Excel, XML — all via Apify dataset download or API. **Can I filter for only rental listings?** Paste any Immobiliare.it URL — both sale (`/vendita-case/`) and rental (`/affitti-case/`) URLs work. **What if it returns empty results?** Check that your `searchUrl` is a valid Immobiliare.it search URL. The actor logs the issue and exits cleanly with 0 results rather than crashing. ### Why this actor vs. competitors | Feature | This actor | epctex/immobiliare-scraper ($3/1K) | Typical Immobiliare scraper | |---|---|---|---| | Luxury flag (`is_luxury`) | Yes | No | No | | New construction flag (`is_new`) | Yes | No | No | | Macrozone + microzone | Yes | No | Rarely | | parse\_confidence + warnings | Yes | No | No | | Floor field | Yes | Rarely | Rarely | | Source: `__NEXT_DATA__` JSON | Yes (stable) | DOM | DOM | | Price per 1K listings | $1.50 | $3.00 | varies | Works with both English (`/en/`) and Italian Immobiliare.it URLs. **Unique fields:** `is_luxury` and `is_new` flags make this actor ideal for luxury real estate agencies and property developer pipelines. `macrozone` + `microzone` provide sub-neighborhood granularity not available in any other Italian real estate actor. ### parse\_confidence Every listing includes a `parse_confidence` score (0–1). Score < 0.8 means one or more critical fields are missing — check the `warnings` array before relying on those records. ### Use with AI agents (MCP) Tag: `MCP_SERVERS`. Returns clean JSON — drop into any n8n / Make / LangChain workflow without post-processing. ```json { "mcpServer": "https://mcp.apify.com/?tools=bovi/immobiliare-listings" } ``` ### Competitive edge - Parses embedded JSON state, not DOM — survives redesigns - `parse_confidence` + `warnings` on every record - GPS coordinates, macrozone, microzone included - `is_luxury` and `is_new` flags — unique in the Italian real estate scraper space - No proxy COGS ### Pricing Pay-Per-Event (PPE): | Event | Price | |---|---| | `listing-item` (primary) | **$1.50 / 1,000 listings** | | `luxury-listing` (premium) | **$2.00 / 1,000 luxury listings** | | `new-construction` (premium) | **$1.00 / 1,000 new-build listings** | Luxury (`is_luxury=true`) and new-construction (`is_new=true`) listings each fire their respective premium event in addition to the base charge. Filter for luxury or new-build buyers by checking these flags in the output. ### Integrations Built for Italian property investors, PropTech platforms, and real-estate funds tracking listings, prices, and GPS data — the JSON/dataset output drops into the tools you already run, no glue code: - **n8n / Make / Zapier** — trigger a run or pipe every new dataset item into 500+ apps (Google Sheets, Airtable, Slack, HubSpot, your database) with no code: [n8n](https://docs.apify.com/platform/integrations/n8n), [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier). - **Webhooks** — fire your own endpoint the moment a run finishes, to push results straight into your pipeline ([docs](https://docs.apify.com/platform/integrations/webhooks)). - **MCP server** — expose this actor as a tool to Claude, Cursor, or any [MCP client](https://mcp.apify.com) so an AI agent can pull this data mid-conversation ([guide](https://blog.apify.com/how-to-use-mcp/)). - **API & SDKs** — fetch the dataset as JSON, CSV, or Excel through the Apify REST API or the Python / JS SDKs. See all [Apify integrations](https://apify.com/integrations). # Actor input Schema ## `searchUrl` (type: `string`): Full Immobiliare.it search URL. Example: https://www.immobiliare.it/en/vendita-case/roma/ or https://www.immobiliare.it/en/affitti-case/milano/ ## `maxItems` (type: `integer`): Maximum number of listings to return (0 = no limit, scrapes all pages). Default 50. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. RESIDENTIAL recommended for reliability. ## Actor input object example ```json { "searchUrl": "https://www.immobiliare.it/en/vendita-case/roma/", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IT" } } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing Immobiliare Listings records (title, price\_formatted, contract, property\_type, city, address, surface\_m2, rooms, is\_new, url, scraped\_at, parse\_confidence). # 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 = { "searchUrl": "https://www.immobiliare.it/en/vendita-case/roma/", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IT" } }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/immobiliare-listings").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 = { "searchUrl": "https://www.immobiliare.it/en/vendita-case/roma/", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IT", }, } # Run the Actor and wait for it to finish run = client.actor("bovi/immobiliare-listings").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 '{ "searchUrl": "https://www.immobiliare.it/en/vendita-case/roma/", "maxItems": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IT" } }' | apify call bovi/immobiliare-listings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/immobiliare-listings", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Immobiliare.it Scraper — Italy Real Estate | $0.69/1K", "description": "Scrape Immobiliare.it Italian real estate listings. Returns price, address, city, rooms, surface, floor, GPS coordinates and photos. No proxy needed. Pay per listing.", "version": "0.1", "x-build-id": "FCY5QfGp1FQF67CLM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~immobiliare-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-immobiliare-listings", "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/bovi~immobiliare-listings/runs": { "post": { "operationId": "runs-sync-bovi-immobiliare-listings", "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/bovi~immobiliare-listings/run-sync": { "post": { "operationId": "run-sync-bovi-immobiliare-listings", "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", "required": [ "searchUrl" ], "properties": { "searchUrl": { "title": "Immobiliare search URL", "type": "string", "description": "Full Immobiliare.it search URL. Example: https://www.immobiliare.it/en/vendita-case/roma/ or https://www.immobiliare.it/en/affitti-case/milano/" }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return (0 = no limit, scrapes all pages). Default 50." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy configuration. RESIDENTIAL recommended for reliability." } } }, "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 } } } } } } } } } } ```