{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Scraper — Italian Property Listings & Prices", "description": "Scrape Immobiliare.it homes for sale and rent by town, zone, province, search URL or agency: price, €/m², price drops, size, rooms, address, coordinates, photos, agency, full details.", "version": "0.1", "x-build-id": "ng7sC5G9bEhM2Rgrv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tortuga~immobiliare-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tortuga-immobiliare-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/tortuga~immobiliare-scraper/runs": { "post": { "operationId": "runs-sync-tortuga-immobiliare-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/tortuga~immobiliare-scraper/run-sync": { "post": { "operationId": "run-sync-tortuga-immobiliare-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 pages: a search with your filters (run it on immobiliare.it and copy the address bar, e.g. https://www.immobiliare.it/vendita-case/milano/?prezzoMassimo=400000), a listing (https://www.immobiliare.it/annunci/133212744/) or an agency page (https://www.immobiliare.it/agenzie-immobiliari/51157/...) for all its listings. Price, size, rooms, zone and sort filters in the URL are applied. Leave empty to use Locations.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "locations": { "title": "Locations", "type": "array", "description": "Alternative to Start URLs: Italian towns (comuni), provinces or zones, e.g. \"Milano\", \"Roma\", \"provincia di Firenze\", \"Navigli, Milano\". Searches with the type and filters below. Region-wide searches are not supported: list provinces instead.", "items": { "type": "string" } }, "operation": { "title": "For sale or to rent", "enum": [ "sale", "rent" ], "type": "string", "description": "Used with Locations.", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "homes", "apartments", "villas", "penthouses", "detached_houses", "terraced_houses", "country_houses", "new_builds", "rooms", "offices", "shops", "garages", "land", "warehouses", "storage", "buildings" ], "type": "string", "description": "Used with Locations. 'Homes' covers every residential type (apartments, villas, penthouses, houses...).", "default": "homes" }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Used with Locations. Sale price, or monthly rent for rentals." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Used with Locations. Sale price, or monthly rent for rentals." }, "minSize": { "title": "Min size (m²)", "minimum": 0, "type": "integer", "description": "Used with Locations." }, "maxSize": { "title": "Max size (m²)", "minimum": 0, "type": "integer", "description": "Used with Locations." }, "minRooms": { "title": "Min rooms (locali)", "minimum": 0, "type": "integer", "description": "Used with Locations. Italian listings count rooms as 'locali' (bilocale = 2, trilocale = 3; kitchen and bathrooms not counted)." }, "maxRooms": { "title": "Max rooms (locali)", "minimum": 0, "type": "integer", "description": "Used with Locations." }, "sort": { "title": "Sort by", "enum": [ "", "newest", "price_asc", "price_desc", "size_desc", "size_asc", "oldest", "rooms_desc", "rooms_asc" ], "type": "string", "description": "Used with Locations. Immobiliare.it lists paid placements (Sky, Top, Premium...) first in every order. 'Newest' is the natural choice for monitoring.", "default": "" }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Also fetch each listing's detail record: full description, headline, all characteristics, year built, availability, kitchen, heating and air conditioning, condominium fees and other costs, energy class, virtual tour and videos, agent name, agency URL and address, new-build units. One extra request and an extra 'detail' event per listing.", "default": false }, "language": { "title": "Language", "enum": [ "it", "en" ], "type": "string", "description": "Italian returns descriptions and labels as published. English returns Immobiliare.it's own English labels and machine-translated descriptions, and /en/ listing URLs.", "default": "it" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many listings in total (all searches together). Keeps cost predictable. With 'Only new or changed items' on, this is the number of listings checked per run (e.g. the newest 20).", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop each search after this many result pages (20 listings each). Every page of a search is reachable.", "default": 100 }, "onlyNewOrChanged": { "title": "Only new or changed items", "type": "boolean", "description": "Remember what earlier runs of this search returned and output only new items or items whose price/status changed. Use with a Schedule; unchanged items are not charged.", "default": false }, "monitoringKey": { "title": "Monitoring key", "type": "string", "description": "Name for this watch, so several schedules on the same search stay separate; defaults to a key derived from the search input" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy. The default datacenter proxy works: the actor reads Immobiliare.it's app API, not the protected website. Switch to Residential (Italy) only if runs report blocked answers.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }