{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Scraper - Italy Property Listings, Sale & Rent", "description": "Scrape immobiliare.it (Italy) sale, rent and auction listings from any search URL (city, zone, province, region, map area). One record per listing: price, m², rooms, floor, address, coordinates, features, agency, photos. New-listings monitoring. $0.70 per 1,000 listings on Bronze.", "version": "0.1", "x-build-id": "EitsEKw5Qc5fkkXra" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/amitaviv~immobiliare-it-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-amitaviv-immobiliare-it-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/amitaviv~immobiliare-it-scraper/runs": { "post": { "operationId": "runs-sync-amitaviv-immobiliare-it-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/amitaviv~immobiliare-it-scraper/run-sync": { "post": { "operationId": "run-sync-amitaviv-immobiliare-it-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Search URLs", "type": "array", "description": "Required. immobiliare.it search result URLs copied from the browser's address bar after you choose the place and filters, e.g. https://www.immobiliare.it/vendita-case/milano/ or https://www.immobiliare.it/affitto-case/roma/?prezzoMassimo=1500. Each URL is one search; several are fine. Sale and rent of homes, rooms, offices, shops, garages, land, new builds and auctions; city, zone, province and region searches; private advertisers only (/da-privati/); the site's feature pages such as /con-ascensore/, /con-terrazzo/ or /con-garage/ (a feature page whose filter the site does not apply fails by name); map searches (/search-list/ URLs with a place or an area drawn on the map). Filters and sort order in the URL are applied. Not supported: single listing pages (/annunci/…), microzone pages and the feature pages /con-vista-mare/ and /con-prezzo-basso/.", "items": { "type": "string" } }, "maxItemsPerQuery": { "title": "Max listings per search URL", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of listings delivered for each search URL, from 1 to 2,000; default 100. Apart from the start fee you pay only per delivered listing, so this also caps the cost. immobiliare.it shows at most 2,000 results per search, so larger areas need one URL per zone or per price range.", "default": 100 }, "onlyNew": { "title": "Only new listings (monitoring)", "type": "boolean", "description": "Off (default): every run delivers the listings it finds. On: return and charge only listings that earlier runs of this actor in your account have not delivered for the same search, for scheduled monitoring. Searches are then read newest first, bypassing the site's cache. The first run delivers up to the maximum. Set maxItemsPerQuery and the run's maximum charge high enough for the new listings between two runs: a later run does not go back for listings a limit left out. The memory is a key-value store named immobiliare-it-scraper-monitor in your account; delete it to start over.", "default": false }, "monitorKey": { "title": "Monitor name (optional)", "type": "string", "description": "Only with onlyNew. A free name for the monitor memory, e.g. milano-daily. Runs with the same search URL and the same monitor name share one memory; give two schedules different names to keep their memories apart. Default: empty (one shared memory per search)." }, "includePrivateSellerData": { "title": "Include private advertisers' names and phone pictures", "type": "boolean", "description": "Off (default): for listings by private persons (\"privato\", isPrivate: true) the advertiser's name and phone are null and phone numbers and e-mail addresses in their texts are masked (privateDataRedacted: true). Agencies' and builders' business name, page and phone are delivered either way. On: private advertisers' names and phone pictures as published. Turn on only if you have a lawful basis under the GDPR to process this personal data; by turning it on you confirm that you do.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }