# immobiliare.it Listings Scraper (`xtracto/immobiliare-listings`) Actor Scrapes real estate listings from Italy's #1 portal immobiliare.it via its internal JSON search API. Supports sale and rent search by city or URL, with price, surface, rooms, location, photos and agency data. HTTP-only; residential proxy optional for detail pages. - **URL**: https://apify.com/xtracto/immobiliare-listings.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## immobiliare.it Scraper Collect property listings from [immobiliare.it](https://www.immobiliare.it) — Italy's largest real estate portal with 750,000+ active listings — and download them as structured data ready for spreadsheets, databases, or analytics pipelines. ### Why use this actor - **No account or login required** — public listings are collected without signing in. - **Sale and rent in one run** — search for properties for sale, to rent, or both at once. - **Rich listing detail** — price, surface area, number of rooms, floor, city, neighborhood, GPS coordinates, agency name, and up to dozens of photos per listing. - **Search by city name or custom URL** — type a city (e.g. "Roma", "Milano") or paste any immobiliare.it search page URL with your own filters already set. - **Precise result caps** — set `maxResults` to get exactly the number of listings you need; the actor stops mid-page the moment the limit is reached. - **Stable structured output** — results stream directly to your dataset as they arrive; download as JSON, CSV, or Excel without any extra steps. ### How it works 1. You provide one or more Italian city names (or paste existing search URLs with filters already applied). 2. The actor resolves each city to its correct search path and retrieves pages of listings automatically. 3. Each listing is written to your dataset as soon as it is collected — price, location, rooms, surface, photos, and agency are all included. 4. Once the page or result limit you set is reached, the actor stops and writes a summary record showing how many listings the site holds in total. 5. Download your results as JSON, CSV, or Excel from the Apify Console — no scraping infrastructure or browsers to manage. ### Input ```json { "cities": ["Roma"], "contractType": "sale", "categoryId": "1", "maxPages": 40, "maxResults": 0, "maxConcurrency": 3, "requestDelayMs": 1000, "proxyConfiguration": {} } ```` | Field | Type | Description | |---|---|---| | `searchUrls` | array | Paste immobiliare.it search page URLs directly. Takes priority over `cities`. Example: `https://www.immobiliare.it/vendita-case/roma/`. | | `cities` | array | Italian city names to search (e.g. `"Roma"`, `"Milano"`, `"Napoli"`). Used when no search URLs are provided. | | `contractType` | string | `"sale"` — for-sale listings. `"rent"` — rental listings. `"both"` — runs both searches per city. | | `categoryId` | string | Property category: `"1"` Residential (apartments, houses, villas), `"2"` Commercial, `"6"` New builds, `"24"` Land. | | `maxPages` | integer | Pages to fetch per search (25 listings per page). `0` = no page limit. Default: `40`. | | `maxResults` | integer | Maximum listings to collect per search target. `0` = no limit (use `maxPages` instead). | | `maxConcurrency` | integer | Simultaneous page requests (keep 2–4). Default: `3`. | | `requestDelayMs` | integer | Milliseconds between requests per worker (random variation applied). Default: `1000`. | | `proxyConfiguration` | object | Proxy settings. Not required for standard search; an Italian residential proxy (`RESIDENTIAL`, country `IT`) helps if the search starts returning errors from your location. | ### Output The dataset contains two record types: - `LISTING` — one row per property listing. - `CITY_SNAPSHOT` — one row per city per run with totals (total ads found, pages available, pages scraped). #### Sample listing record ```json { "_input": "roma:sale", "_source": "S1-search-api", "_scrapedAt": "2026-06-10T12:14:38Z", "recordType": "LISTING", "id": 100233540, "title": "Trilocale via Francesco Crispi 34, Ospedale, Busto Arsizio", "contract": "sale", "price": { "formattedValue": "€ 389.000", "value": 389000, "visible": true }, "properties": [ { "surface": "184 m²", "rooms": "3", "bathrooms": "3", "floor": { "value": "6°, con ascensore" }, "location": { "address": "Via Francesco Crispi", "city": "Busto Arsizio", "province": "Varese", "region": "Lombardia", "latitude": 45.6226, "longitude": 8.8503, "microzone": "Ospedale" }, "multimedia": { "photos": [ { "id": 1260970622, "urls": { "small": "https://pwm.im-cdn.it/image/1260970622/xxs-c.jpg" } }, { "id": 1260970670, "urls": { "small": "https://pwm.im-cdn.it/image/1260970670/xxs-c.jpg" } }, { "id": 1260970460, "urls": { "small": "https://pwm.im-cdn.it/image/1260970460/xxs-c.jpg" } }, "... 60 more" ] } } ], "advertiser": { "agency": { "displayName": "Gabetti Agency SpA - Frazionamenti e Cantieri", "agencyUrl": "https://www.immobiliare.it/imprese-edili/144077/gabetti-frazionamenti/" } }, "typology": { "id": 14, "name": "Trilocale" }, "seo_url": "https://www.immobiliare.it/annunci/100233540/" } ``` #### Output field reference | Field | Type | Description | |---|---|---| | `recordType` | string | `"LISTING"` or `"CITY_SNAPSHOT"`. | | `id` | integer | Unique listing ID on immobiliare.it. | | `title` | string | Listing headline as shown on the site. | | `contract` | string | `"sale"` or `"rent"`. | | `price.value` | integer | Price in euros (null if hidden by the seller). | | `price.formattedValue` | string | Human-readable price string (e.g. `"€ 389.000"`). | | `properties[0].surface` | string | Floor area (e.g. `"184 m²"`). | | `properties[0].rooms` | string | Number of rooms. | | `properties[0].bathrooms` | string | Number of bathrooms. | | `properties[0].floor.value` | string | Floor description (e.g. `"6°, con ascensore"`). | | `properties[0].location.city` | string | City name. | | `properties[0].location.province` | string | Province (e.g. `"Varese"`). | | `properties[0].location.latitude` | number | GPS latitude. | | `properties[0].location.longitude` | number | GPS longitude. | | `properties[0].location.microzone` | string | Neighborhood or district. | | `properties[0].multimedia.photos` | array | Photo objects with `id` and `urls` (small/medium/large). | | `advertiser.agency.displayName` | string | Listing agency name. | | `advertiser.agency.agencyUrl` | string | Agency profile URL. | | `typology.name` | string | Property type (e.g. `"Trilocale"`, `"Villa"`). | | `seo_url` | string | Direct link to the listing page. | | `_scrapedAt` | string | ISO 8601 timestamp of when the record was collected. | #### Sample city snapshot record ```json { "recordType": "CITY_SNAPSHOT", "city_slug": "roma", "contractType": "sale", "totalAds": 773143, "maxPages": 30926, "pagesScraped": 2, "isResultsLimitReached": true } ``` ### Other actors in this collection | Actor | Source | |---|---| | [mobile.de Listings Scraper](https://apify.com/xtracto/mobilede-listings) | Germany's largest used-car marketplace | | [Eventbrite Events Scraper](https://apify.com/xtracto/eventbrite-events) | Live events and tickets worldwide | | [Kickstarter Projects Scraper](https://apify.com/xtracto/kickstarter-projects) | Crowdfunding campaigns | | [Leboncoin Listings Scraper](https://apify.com/xtracto/leboncoin-listings) | France's largest classifieds site | | [Idealista Listings Scraper](https://apify.com/xtracto/idealista-listings) | Spain and Portugal real estate | | [Semrush Website Overview Scraper](https://apify.com/xtracto/semrush-website-overview) | Website traffic and SEO metrics | # Actor input Schema ## `searchUrls` (type: `array`): Paste immobiliare.it search page URLs directly (e.g. https://www.immobiliare.it/vendita-case/roma/). The actor extracts city, contract type, and filters from the URL. Takes priority over Cities/Contract Type fields. ## `cities` (type: `array`): List of Italian city names to search (e.g. 'Roma', 'Milano', 'Napoli'). Each city is resolved via the geography autocomplete to the correct search path. Used when no Search URLs are provided. ## `contractType` (type: `string`): Listing contract type. 'sale' = vendita (properties for sale), 'rent' = affitto (properties to rent), 'both' = run sale and rent search for each city. ## `categoryId` (type: `string`): Property category to search. Residenziale (1) covers apartments, houses, and villas. Commerciale (2) = shops and offices. Nuove Costruzioni (6) = new builds only. Terreni (24) = land plots. ## `maxPages` (type: `integer`): Maximum number of result pages to fetch per search (25 listings per page). 0 = unlimited (fetches up to the site's own page limit). Roma sale has ~31k pages; typical useful depth is 50–200 pages. ## `maxResults` (type: `integer`): Hard cap on the number of listings emitted per search target. 0 = no limit (use maxPages to control volume instead). When set, the actor stops exactly at this count mid-page if needed. ## `maxConcurrency` (type: `integer`): Maximum number of simultaneous page requests. Keep at 2–4 to avoid triggering rate limits on the search service. ## `requestDelayMs` (type: `integer`): Milliseconds to wait between page requests per worker. A random jitter of ±30% is applied automatically. Increase to 2000–3000 if you see 403 error responses. ## `proxyConfiguration` (type: `object`): Apify proxy settings. The search works without a proxy from most locations. An Italian residential proxy (RESIDENTIAL group, country IT) is only required if the search starts returning errors from your location. ## Actor input object example ```json { "searchUrls": [], "cities": [ "Roma" ], "contractType": "sale", "categoryId": "1", "maxPages": 40, "maxResults": 0, "maxConcurrency": 3, "requestDelayMs": 1000, "proxyConfiguration": {} } ``` # 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 = { "searchUrls": [], "cities": [ "Roma" ], "contractType": "sale", "categoryId": "1" }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/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 = { "searchUrls": [], "cities": ["Roma"], "contractType": "sale", "categoryId": "1", } # Run the Actor and wait for it to finish run = client.actor("xtracto/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 '{ "searchUrls": [], "cities": [ "Roma" ], "contractType": "sale", "categoryId": "1" }' | apify call xtracto/immobiliare-listings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/immobiliare-listings", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "immobiliare.it Listings Scraper", "description": "Scrapes real estate listings from Italy's #1 portal immobiliare.it via its internal JSON search API. Supports sale and rent search by city or URL, with price, surface, rooms, location, photos and agency data. HTTP-only; residential proxy optional for detail pages.", "version": "0.1", "x-build-id": "N684eC49771hIu0KF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~immobiliare-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-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/xtracto~immobiliare-listings/runs": { "post": { "operationId": "runs-sync-xtracto-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/xtracto~immobiliare-listings/run-sync": { "post": { "operationId": "run-sync-xtracto-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", "properties": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Paste immobiliare.it search page URLs directly (e.g. https://www.immobiliare.it/vendita-case/roma/). The actor extracts city, contract type, and filters from the URL. Takes priority over Cities/Contract Type fields.", "default": [], "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "List of Italian city names to search (e.g. 'Roma', 'Milano', 'Napoli'). Each city is resolved via the geography autocomplete to the correct search path. Used when no Search URLs are provided.", "default": [ "Roma" ], "items": { "type": "string" } }, "contractType": { "title": "Contract Type", "enum": [ "sale", "rent", "both" ], "type": "string", "description": "Listing contract type. 'sale' = vendita (properties for sale), 'rent' = affitto (properties to rent), 'both' = run sale and rent search for each city.", "default": "sale" }, "categoryId": { "title": "Property Category", "enum": [ "1", "2", "6", "24" ], "type": "string", "description": "Property category to search. Residenziale (1) covers apartments, houses, and villas. Commerciale (2) = shops and offices. Nuove Costruzioni (6) = new builds only. Terreni (24) = land plots.", "default": "1" }, "maxPages": { "title": "Max Pages per Search", "minimum": 0, "type": "integer", "description": "Maximum number of result pages to fetch per search (25 listings per page). 0 = unlimited (fetches up to the site's own page limit). Roma sale has ~31k pages; typical useful depth is 50–200 pages.", "default": 40 }, "maxResults": { "title": "Max Listings per Search", "minimum": 0, "type": "integer", "description": "Hard cap on the number of listings emitted per search target. 0 = no limit (use maxPages to control volume instead). When set, the actor stops exactly at this count mid-page if needed.", "default": 0 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Maximum number of simultaneous page requests. Keep at 2–4 to avoid triggering rate limits on the search service.", "default": 3 }, "requestDelayMs": { "title": "Request Delay (ms)", "minimum": 0, "type": "integer", "description": "Milliseconds to wait between page requests per worker. A random jitter of ±30% is applied automatically. Increase to 2000–3000 if you see 403 error responses.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. The search works without a proxy from most locations. An Italian residential proxy (RESIDENTIAL group, country IT) is only required if the search starts returning errors from your location.", "default": {} } } }, "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 } } } } } } } } } } ```