{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Listings Scraper", "description": "Scrape Immobiliare.it (Italy) property listings for sale and rent by city, province, region, map area or search URL: price, size, rooms, GPS, agency and phone, energy class, costs, photos. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "8wuRkpFCFAmgEOGce" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~immobiliare-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-immobiliare-listings-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/nice_dev~immobiliare-listings-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-immobiliare-listings-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/nice_dev~immobiliare-listings-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-immobiliare-listings-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": { "operation": { "title": "Operation", "enum": [ "sale", "rent" ], "type": "string", "description": "For sale or for rent. Ignored for pasted URLs (they keep their own).", "default": "sale" }, "propertyType": { "title": "Property type", "enum": [ "homes", "newDevelopments", "rooms", "offices", "commercial", "garages", "storageRooms", "sheds", "lands", "buildings" ], "type": "string", "description": "Category searched, as in the site's menu. Ignored for pasted URLs.", "default": "homes" }, "homeTypes": { "title": "Home types", "uniqueItems": true, "type": "array", "description": "Only these kinds of homes (Property type = Homes). Empty = all.", "items": { "type": "string", "enum": [ "apartment", "penthouse", "detachedHouse", "villa", "loft" ], "enumTitles": [ "Apartment", "Penthouse (attico)", "Detached house", "Villa", "Loft" ] }, "default": [] }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "Italian city, province or region, as typed on the site (e.g. `Bologna`, `Provincia di Milano`, `Toscana`). The first match of the site's own suggestions is used; the run log says which one. A name several towns share: add the province (`Samone, Trento` or `Samone (TN)`)." }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: one search per location (times each keyword below, max 500 searches). Added to **Location**.", "default": [], "items": { "type": "string" } }, "query": { "title": "Keyword", "maxLength": 100, "type": "string", "description": "Word that must appear in the listing (the site's own keyword filter, e.g. `terrazzo`, `vista mare`). Empty = no keyword." }, "searchQueries": { "title": "More keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each location). Added to **Keyword**; listings found by several searches are saved once.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Immobiliare.it search-result URLs (every filter set on the site is kept, pagination is automatic, map searches too) or single listing URLs (`https://www.immobiliare.it/annunci/123456789/`). When this list is not empty, Location, Keyword, point and polygon are ignored; the filters below still apply to search URLs. Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingIds": { "title": "Listing IDs", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Listing numbers (the digits of `/annunci//`). Each one is read with its details (charged as a listing plus its details). Given alone, only these listings are returned.", "default": [], "items": { "type": "string" } }, "latitude": { "title": "Latitude (point search)", "minimum": 35, "maximum": 48, "type": "number", "description": "Search around a point instead of a location: latitude in decimal degrees, e.g. 45.4642 (Milan). Needs Longitude; Radius sets the distance." }, "longitude": { "title": "Longitude (point search)", "minimum": 6, "maximum": 19, "type": "number", "description": "Longitude in decimal degrees, e.g. 9.19 (Milan)." }, "radiusKm": { "title": "Radius (km)", "minimum": 0.1, "maximum": 50, "type": "number", "description": "Distance around the point, in kilometres.", "default": 2 }, "polygon": { "title": "Polygon (map search)", "maxLength": 4000, "type": "string", "description": "Draw your own area: corner points as `latitude,longitude` separated by `;` (at least 3, at most 100), e.g. `45.47,9.17;45.47,9.21;45.45,9.21;45.45,9.17`." }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Maximum number of listings to save for the whole run (after deduplication and filters). 0 = no limit.", "default": 100 }, "maxItemsPerQuery": { "title": "Max listings per search", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Cap for EACH search (location × keyword, or search URL), so that the first search cannot use up the whole **Max listings** budget. 0 = no per-search cap.", "default": 0 }, "splitLargeSearches": { "title": "Get every listing of large searches", "type": "boolean", "description": "The site shows at most 2 000 listings per search. On: a larger search is cut into price bands, each under that limit, so that every listing is returned (duplicates removed). Off: the first 2 000 only.", "default": true }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest", "oldest", "priceLow", "priceHigh", "sizeLarge", "sizeSmall", "roomsMost", "roomsLeast" ], "type": "string", "description": "Order of the results, as on the site. With **Only new listings**, Relevance becomes Newest first, so that a search can stop at the listings already delivered.", "default": "relevance" }, "language": { "title": "Language of the results", "enum": [ "it", "en", "de", "es", "fr", "pt", "el" ], "type": "string", "description": "Language of titles, typologies and floors, and of the description when the advertiser gave a translation (the site's own translations); otherwise the listing page shows, and the Actor returns with details, the original text. Italian = the site default.", "default": "it" }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Open each listing page for the full description, energy class and performance, condominium and heating costs, publication and update dates, building year, condition, all features, agency reference and price per m². Charged per listing with details (see Pricing). Off = the search-result fields only (price, size, rooms, GPS, zone, agency and phones, 600-character description).", "default": false }, "minPrice": { "title": "Min price (€)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Lowest price, in euros (monthly rent for rentals)." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Highest price, in euros (monthly rent for rentals)." }, "minSize": { "title": "Min size (m²)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Smallest surface, in square metres." }, "maxSize": { "title": "Max size (m²)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Largest surface, in square metres." }, "minRooms": { "title": "Min rooms (locali)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Fewest rooms, counted like the site (`locali`: bedrooms + living rooms, kitchen excluded)." }, "maxRooms": { "title": "Max rooms (locali)", "minimum": 1, "maximum": 5, "type": "integer", "description": "Most rooms (`locali`)." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 1, "maximum": 5, "type": "integer", "description": "Fewest bedrooms." }, "maxBedrooms": { "title": "Max bedrooms", "minimum": 1, "maximum": 5, "type": "integer", "description": "Most bedrooms." }, "bathrooms": { "title": "Bathrooms", "enum": [ "", "1", "2", "3", "4+" ], "type": "string", "description": "Exact number of bathrooms, as on the site.", "default": "" }, "condition": { "title": "Condition", "enum": [ "", "new", "renovated", "good", "toRenovate" ], "type": "string", "description": "State of the property.", "default": "" }, "floors": { "title": "Floor", "uniqueItems": true, "type": "array", "description": "Ground floor, intermediate floors and/or top floor. Empty = any.", "items": { "type": "string", "enum": [ "ground", "intermediate", "top" ], "enumTitles": [ "Ground floor", "Intermediate floors", "Top floor" ] }, "default": [] }, "garden": { "title": "Garden", "uniqueItems": true, "type": "array", "description": "Private and/or shared garden. Empty = any.", "items": { "type": "string", "enum": [ "private", "shared" ], "enumTitles": [ "Private garden", "Shared garden" ] }, "default": [] }, "garage": { "title": "Garage / parking", "uniqueItems": true, "type": "array", "description": "Single garage, double garage and/or parking space. Empty = any.", "items": { "type": "string", "enum": [ "single", "double", "parkingSpace" ], "enumTitles": [ "Single garage", "Double garage", "Parking space" ] }, "default": [] }, "heating": { "title": "Heating", "uniqueItems": true, "type": "array", "description": "Independent heating, central heating and/or air conditioning. Empty = any.", "items": { "type": "string", "enum": [ "independent", "central", "airConditioning" ], "enumTitles": [ "Independent (autonomo)", "Central (centralizzato)", "Air conditioning" ] }, "default": [] }, "balconyTerrace": { "title": "Balcony / terrace", "uniqueItems": true, "type": "array", "description": "With a balcony and/or a terrace. Empty = any.", "items": { "type": "string", "enum": [ "balcony", "terrace" ], "enumTitles": [ "Balcony", "Terrace" ] }, "default": [] }, "ownership": { "title": "Ownership", "enum": [ "", "full", "bare", "partial", "usufruct", "timeshare", "landLease" ], "type": "string", "description": "Kind of ownership sold.", "default": "" }, "hasElevator": { "title": "Elevator", "type": "boolean", "description": "Only listings with an elevator.", "default": false }, "hasBasement": { "title": "Cellar", "type": "boolean", "description": "Only listings with a cellar (cantina).", "default": false }, "hasSwimmingPool": { "title": "Swimming pool", "type": "boolean", "description": "Only listings with a swimming pool.", "default": false }, "furnished": { "title": "Furnished", "type": "boolean", "description": "Only furnished properties.", "default": false }, "virtualTourOnly": { "title": "With virtual tour", "type": "boolean", "description": "Only listings with a virtual tour.", "default": false }, "excludeAuctions": { "title": "Exclude auctions", "type": "boolean", "description": "Leave out properties sold at auction (aste).", "default": false }, "rentedOnly": { "title": "Rented (investment) only", "type": "boolean", "description": "Only properties sold with a tenant in place (a reddito).", "default": false }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only listings first published on or after this date (the date the listing page gives, so it needs **Include listing details**): `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too)." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only listings first published on or before this date (the whole day is included), or older than a period such as `30 days`. Needs **Include listing details**." }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the listings whose title or description contains one of these words (case and accents ignored).", "default": [], "items": { "type": "string" } }, "privateSellersOnly": { "title": "Private sellers only", "type": "boolean", "description": "Only listings posted by private owners (no agency).", "default": false }, "agenciesOnly": { "title": "Agencies only", "type": "boolean", "description": "Only listings posted by an agency or a builder.", "default": false }, "requirePhone": { "title": "With phone number only", "type": "boolean", "description": "Only listings that show at least one phone number.", "default": false }, "excludeNewDevelopments": { "title": "Exclude new developments", "type": "boolean", "description": "Leave out the new-build projects that group several units in one listing.", "default": false }, "onlyPriceDrops": { "title": "Price drops only", "type": "boolean", "description": "Only listings whose price was lowered (the site shows the former price).", "default": false }, "minPriceDropPercent": { "title": "Min price drop (%)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only listings whose price dropped by at least this percentage (setting it switches **Price drops only** on by itself)." }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Skip the listings that a previous run (same **Memory key**) already delivered: they are not saved and not charged. First run = everything is new. Works best with **Sort by** = Newest first.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new listings**. Give each schedule / task its own key (e.g. `milano-rentals`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every listing again. Untick it afterwards.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxies. Keep the default: it is included in the price. The residential Apify proxy is not available in this Actor.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of result pages read in parallel.", "default": 4 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 1000, "type": "integer", "description": "Budget of requests per minute for the whole run.", "default": 150 }, "minRequestIntervalMs": { "title": "Min delay between requests", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Smallest gap between two requests, in milliseconds. Unlike the per-minute budget, this spreads the requests evenly. 0 = no gap.", "default": 300 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. A request the site turns away is also retried at once on a new proxy session up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "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 }, "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 } } } } } } } } } }