{ "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 } } } } } } } } } }