{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Scraper - Italy Property Listings", "description": "Collect Italian sale and rental listings, project units and agency profiles from Immobiliare.it. Export prices, locations and published contacts. Pay per delivered row plus a start fee.", "version": "0.5", "x-build-id": "S0IOHP9a6zDju7af3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~immobiliare-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-immobiliare-property-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/lentic_clockss~immobiliare-property-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-immobiliare-property-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/lentic_clockss~immobiliare-property-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-immobiliare-property-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": "Immobiliare.it search, listing or agency profile URLs. Each URL has its own maxItems limit; search URLs override location, channel and property categories.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "type": "string", "description": "Italian city, e.g. milano, roma, torino, napoli or firenze. Used when no start URL is given. If you fill in neither, the Actor runs a short example search for firenze." }, "channel": { "title": "Channel", "enum": [ "BUY", "RENT" ], "type": "string", "description": "BUY (vendita) or RENT (affitto). Used when building searches from location. Some categories are sale-only (e.g. nuove-costruzioni).", "default": "RENT" }, "propertyType": { "title": "Property type (single)", "enum": [ "case", "appartamenti", "attici", "case-indipendenti", "loft", "rustici", "ville", "villette", "uffici", "negozi", "garage", "garage-posti-auto", "palazzi", "attivita", "magazzini", "capannoni", "stanze", "terreni", "nuove-costruzioni", "all" ], "type": "string", "description": "One property category, ignored when propertyTypes is nonempty. Select all for primary categories without separate residential subtypes.", "default": "case" }, "propertyTypes": { "title": "Property types (multi)", "type": "array", "description": "Property categories to search, each with its own maxItems limit; overrides propertyType. Select all for primary categories without separate residential subtypes.", "items": { "type": "string", "enum": [ "case", "appartamenti", "attici", "case-indipendenti", "loft", "rustici", "ville", "villette", "uffici", "negozi", "garage", "garage-posti-auto", "palazzi", "attivita", "magazzini", "capannoni", "stanze", "terreni", "nuove-costruzioni", "all" ] }, "default": [] }, "maxItems": { "title": "Max rows per URL or category", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum listing, unit and agency rows per URL or category (1–500), collected in parts when needed; aliases are maxResults and limit. Default 70; the run is also capped by your maximum total charge and, on the Free plan, 200 rows per run and 10 runs of this Actor.", "default": 70 }, "maxPages": { "title": "Max search pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Ignored: the Actor pages until maxItems rows are collected, so the page count follows maxItems. Kept so older inputs stay valid.", "default": 1 }, "scrapeDetails": { "title": "Scrape detail pages", "type": "boolean", "description": "Add available information from listing detail pages, including property details and agency contacts. Missing source fields remain empty.", "default": false }, "includeRaw": { "title": "Developer test data", "type": "boolean", "description": "Leave off. Used only by the developer for testing.", "default": false }, "includeUnits": { "title": "Include project units", "type": "boolean", "description": "Add separate, billed unit rows for properties within project listings. Listing and unit rows share each input's maxItems limit.", "default": false }, "allowEmptyResults": { "title": "Allow empty results", "type": "boolean", "description": "Allow the run to succeed with zero rows when the search has no matching inventory. Collection errors still fail.", "default": true }, "requestDelayMillis": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Delay between collection requests in milliseconds, from 0 to 20000. Keep the default unless you need a longer pause.", "default": 2000 }, "workerBaseUrl": { "title": "Developer test setting", "type": "string", "description": "Leave empty. Used only by the developer for testing.", "default": "" }, "provider": { "title": "Collection option", "enum": [ "auto", "patchright", "wsapp" ], "type": "string", "description": "Leave at auto for standard searches across the supported categories. The App data option (wsapp) supports case searches and the optional listing selectors below, but not other categories or residential subtypes.", "default": "auto" }, "wsappEnum": { "title": "Optional listing selector", "enum": [ "list", "markers", "latest", "agency" ], "type": "string", "description": "With provider set to wsapp, choose list for search results, markers for map-based selection, latest for newest listings, or agency for one agency's inventory. The agency option requires agencyId.", "default": "list" }, "agencyId": { "title": "Agency ID for inventory", "pattern": "^$|^[0-9]+$", "type": "string", "description": "Numeric agency ID for the agency listing selector, for example 51157. Used only with provider set to wsapp and wsappEnum set to agency.", "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 }, "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 } } } } } } } } } }