{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Scraper - Real Estate Data for Italy", "description": "Extract comprehensive Italian real estate listings from Immobiliare.it for sale, rent and auction data, with customizable filters for province, municipality, price, size, rooms and amenities. Receive clean JSON output for market analysis, lead generation and trend tracking.", "version": "0.0", "x-build-id": "TVDzNVnNIUJkEx46s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~immobiliare-it-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-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/igolaizola~immobiliare-it-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-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/igolaizola~immobiliare-it-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-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": [ "maxItems" ], "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of properties to scrape", "default": 10 }, "province": { "title": "Province", "enum": [ "", "AG", "AL", "AN", "AO", "AR", "AP", "AT", "AV", "BA", "BT", "BL", "BN", "BG", "BI", "BO", "BZ", "BS", "BR", "CA", "CL", "CB", "CE", "CT", "CZ", "CH", "CO", "CS", "CR", "KR", "CN", "EN", "FM", "FE", "FI", "FG", "FC", "FR", "GE", "GO", "GR", "IM", "IS", "AQ", "SP", "LT", "LE", "LC", "LI", "LO", "LU", "MC", "MN", "MS", "MT", "ME", "MI", "MO", "MB", "NA", "NO", "NU", "OR", "PD", "PA", "PR", "PV", "PG", "PU", "PE", "PC", "PI", "PT", "PN", "PZ", "PO", "RG", "RA", "RC", "RE", "RI", "RN", "RM", "RO", "SA", "SM", "SS", "SV", "SI", "SR", "SO", "SU", "TA", "TE", "TR", "TO", "TP", "TN", "TV", "TS", "UD", "VA", "VE", "VB", "VC", "VR", "VV", "VI", "VT" ], "type": "string", "description": "Province of the municipality to search within. If empty, it will be auto-detected.", "default": "" }, "municipality": { "title": "Municipality (comuni)", "type": "string", "description": "Municipality (comuni) to search" }, "locations": { "title": "Locations", "type": "array", "description": "Municipalities to search in order. When at least one non-empty value remains after trimming, this overrides municipality.", "items": { "type": "string" } }, "area": { "title": "Area", "type": "string", "description": "Area to search within the municipality" }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Center latitude for radius search. Use together with longitude instead of municipality." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Center longitude for radius search. Use together with latitude instead of municipality." }, "distanceKm": { "title": "Distance (km)", "minimum": 1, "type": "integer", "description": "Radius around the coordinates in kilometers.", "default": 20 }, "operation": { "title": "Operation", "enum": [ "buy", "rent", "auction" ], "type": "string", "description": "Operation type (buy, rent, auction)", "default": "buy" }, "sortType": { "title": "Sort Type", "enum": [ "relevance", "minPrice", "maxPrice", "biggest", "leastBig", "mostRecent", "leastRecent", "maxRooms", "minRooms", "privateUsers", "agencies", "discounted", "lessExpensiveM2", "moreExpensiveM2", "higherFloor", "lowerFloor" ], "type": "string", "description": "Sort type for the results", "default": "relevance" }, "minPrice": { "title": "Min Price", "minimum": 0, "type": "integer", "description": "Minimum price of the property (0 for any)", "default": 0 }, "maxPrice": { "title": "Max Price", "minimum": 0, "type": "integer", "description": "Maximum price of the property (0 for any)", "default": 0 }, "minSize": { "title": "Min Size (m²)", "minimum": 0, "type": "integer", "description": "Minimum size in square meters (0 for any)", "default": 0 }, "maxSize": { "title": "Max Size (m²)", "minimum": 0, "type": "integer", "description": "Maximum size in square meters (0 for any)", "default": 0 }, "minRooms": { "title": "Min Rooms", "minimum": 0, "type": "integer", "description": "Minimum number of rooms (0 for any)", "default": 0 }, "maxRooms": { "title": "Max Rooms", "minimum": 0, "type": "integer", "description": "Maximum number of rooms (0 for any)", "default": 0 }, "bedrooms": { "title": "Number of bedrooms", "type": "integer", "description": "Number of bedrooms (0 for any)", "default": 0 }, "propertyCondition": { "title": "Property Condition", "enum": [ "", "newConstruction", "excellent", "good", "toBeRenovated" ], "type": "string", "description": "Condition of the property" }, "propertyType": { "title": "Property Type (only buy or auction operation)", "enum": [ "", "apartment", "house", "commercialProperty", "land" ], "type": "string", "description": "Type of property to search for", "default": "" }, "floor": { "title": "Floor", "type": "array", "description": "Level of the property in the building (leave empty for any)", "items": { "type": "string", "enum": [ "ground", "middle", "last" ], "enumTitles": [ "Ground", "Middle", "Last" ] } }, "garage": { "title": "Garage", "type": "array", "description": "Garage type (leave empty for any)", "items": { "type": "string", "enum": [ "singleGarage", "doubleGarage", "parkingSpace" ], "enumTitles": [ "Single garage", "Double garage", "Parking space" ] } }, "hvac": { "title": "Heating, Ventilation, and Air Conditioning (HVAC)", "type": "array", "description": "HVAC type (leave empty for any)", "items": { "type": "string", "enum": [ "autonomous", "centralized", "airConditioning" ], "enumTitles": [ "Autonomous", "Centralized", "Air conditioning" ] } }, "garden": { "title": "Garden", "type": "array", "description": "Garden type (leave empty for any)", "items": { "type": "string", "enum": [ "private", "shared" ], "enumTitles": [ "Private", "Shared" ] } }, "energyRating": { "title": "Energy efficiency rating", "enum": [ "", "high", "middle", "low" ], "type": "string", "description": "Energy efficiency rating (leave empty for any)" }, "terrace": { "title": "Terrace", "type": "boolean", "description": "Whether the property has a terrace", "default": false }, "balcony": { "title": "Balcony", "type": "boolean", "description": "Whether the property has a balcony", "default": false }, "lift": { "title": "Lift", "type": "boolean", "description": "Whether the property has a lift", "default": false }, "cellar": { "title": "Cellar", "type": "boolean", "description": "Whether the property has a cellar", "default": false }, "pool": { "title": "Pool", "type": "boolean", "description": "Whether the property has a pool", "default": false }, "furnished": { "title": "Furnished", "type": "boolean", "description": "Whether the property is furnished", "default": false }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to include in the search", "items": { "type": "string" } }, "excludeAuctions": { "title": "Exclude auctions (only buy operation)", "type": "boolean", "description": "Whether to exclude auction listings", "default": false }, "virtualTour": { "title": "Virtual tour", "type": "boolean", "description": "Whether the property has a virtual tour", "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 } } } } } } } } } }