{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Scraper (Italy Real Estate Listings)", "description": "Scrape immobiliare.it property listings by search URL, location or listing URL. Get price, price per m2, rooms, size, floor, features, geo, energy class, owner-direct vs agency, agency name and phone. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "wtDlWn4NsddIhkaxy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~immobiliare-it-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-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/scrapers_lat~immobiliare-it-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-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/scrapers_lat~immobiliare-it-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-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", "properties": { "startUrl": { "title": "Search URL", "type": "string", "description": "An immobiliare.it search results URL to scrape (copy it from your browser after applying filters on immobiliare.it), for example https://www.immobiliare.it/vendita-case/roma/. All matching listings are collected, following pagination. This is the most precise way to target results." }, "location": { "title": "Location", "type": "string", "description": "Optional convenience alternative to Search URL: an Italian city or comune such as roma, milano, torino, napoli or firenze. Combined with Operation to build the search. Ignored when Search URL is set." }, "operation": { "title": "Operation", "enum": [ "vendita", "affitto" ], "type": "string", "description": "Buy (vendita) or rent (affitto). Used with Location to build the search URL.", "default": "vendita" }, "propertyType": { "title": "Property Type", "enum": [ "", "appartamento", "casa", "villa", "attico", "loft", "mansarda", "terreno", "box", "ufficio", "negozio", "palazzo" ], "type": "string", "description": "Only keep listings of this property type. Leave empty for all types.", "default": "" }, "minPrice": { "title": "Minimum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or above this amount in euros. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum Price (EUR)", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or below this amount in euros. Leave empty for no maximum." }, "minRooms": { "title": "Minimum Rooms", "minimum": 0, "type": "integer", "description": "Only keep listings with at least this many rooms (locali). Leave empty for no minimum." }, "listingUrls": { "title": "Listing URLs", "type": "array", "description": "Optional list of individual immobiliare.it listing URLs (https://www.immobiliare.it/annunci//) to scrape directly with full detail (features, geo, agency, phone, energy class, full description).", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max Listings To Scrape", "minimum": 1, "type": "integer", "description": "Maximum number of listings to collect across the whole run. Free Apify plans are capped at 10 per run." }, "contactDetails": { "title": "Add contact and full detail enrichment (paid add-on, off by default)", "type": "boolean", "description": "Fetch each listing detail page to add the energy class, building year, condition, condominium expenses, full feature list, geo coordinates, agency contact and full description. Charged only when real detail is returned. Disabled on free plans.", "default": false }, "aiListingSummary": { "title": "Add AI listing summary (paid add-on, off by default)", "type": "boolean", "description": "Use AI to produce buyer-facing highlights, a condition assessment, the ideal target buyer and a price-per-m2 value assessment for each listing. Charged only when a usable summary is returned. Disabled on free plans.", "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 } } }, "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 } } } } } } } } } }