{
"openapi": "3.0.1",
"info": {
"title": "Immobiliare Scraper - Italy Property for Sale & Rent",
"description": "Scrape Italy property for sale, for rent and at auction, plus new developments, from immobiliare.it search URLs: price or rent, m2, rooms, floor, condition, heating, features, zone, coordinates, agency phone and every photo. Independent tool, not affiliated with Immobiliare.it.",
"version": "0.1",
"x-build-id": "258CxWQI1hrNZvh6k"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapesage~immobiliare-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~immobiliare-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapesage-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/scrapesage~immobiliare-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapesage-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": "immobiliare.it search URLs",
"type": "array",
"description": "immobiliare.it search URLs for sale (vendita), rent (affitto), auctions (aste) or new developments (nuove costruzioni), one per line. Build a search on immobiliare.it with your filters (city, zone, price, size ...), then paste the URL. Homes, rooms, offices, shops and garages all work. Single-listing pages (/annunci/...) are skipped at no cost, because immobiliare.it does not serve them to automated tools. Leave empty and the run returns a small sample.",
"items": {
"type": "string"
}
},
"startUrlsFromFile": {
"title": "Import URLs from a file",
"type": "string",
"description": "Bulk-load immobiliare.it search URLs (sale, rent, auctions or new developments). Either paste the whole list (one per line), or give a single link to a public .txt/.csv, a Google Sheet/Drive link, or an Apify key-value-store record. A file that cannot be read says so and charges nothing."
},
"maxPagesPerUrl": {
"title": "Max pages per URL",
"minimum": 1,
"type": "integer",
"description": "How many result pages to follow for each start URL (about 25 listings per page).",
"default": 10
},
"maxItems": {
"title": "Max listings (total)",
"minimum": 1,
"type": "integer",
"description": "Overall cap across all URLs. You are only charged for listings actually saved.",
"default": 1000
},
"outputFields": {
"title": "Output fields (leave empty for all)",
"type": "array",
"description": "Pick the fields you want and every record is trimmed to exactly those - handy for lean CSV/Sheets exports.",
"items": {
"type": "string",
"enum": [
"type",
"id",
"title",
"url",
"contract",
"propertyType",
"price",
"priceDisplay",
"currency",
"areaSqm",
"rooms",
"bathrooms",
"floor",
"city",
"zone",
"region",
"address",
"latitude",
"longitude",
"agency",
"isPrivate",
"image",
"imageCount",
"sourceUrl",
"scrapedAt",
"listingTitle",
"province",
"macrozone",
"microzone",
"category",
"propertyClass",
"condition",
"heating",
"garage",
"bedrooms",
"floorNumber",
"hasElevator",
"furnishing",
"features",
"views",
"seaDistance",
"description",
"imageUrls",
"hasVirtualTour",
"pricePerSqm",
"priceRange",
"previousPrice",
"priceDropPercent",
"priceDropDate",
"listingTier",
"isNewListing",
"isLuxury",
"visitBookable",
"virtualVisitAvailable",
"agencyId",
"agencyType",
"agencyUrl",
"agencyLogo",
"agencyPhone",
"uuid"
],
"enumTitles": [
"Record type (type)",
"Id (id)",
"Title (title)",
"URL (url)",
"Contract (contract)",
"Property type (propertyType)",
"Price (price)",
"Price display (priceDisplay)",
"Currency (currency)",
"Area m2 (areaSqm)",
"Rooms (rooms)",
"Bathrooms (bathrooms)",
"Floor (floor)",
"City (city)",
"Zone (zone)",
"Region (region)",
"Address (address)",
"Latitude (latitude)",
"Longitude (longitude)",
"Agency (agency)",
"Private seller (isPrivate)",
"Image (image)",
"Image count (imageCount)",
"Source URL (sourceUrl)",
"Scraped at (scrapedAt)",
"Listing title (listingTitle)",
"Province (province)",
"Macro zone (macrozone)",
"Micro zone (microzone)",
"Category (category)",
"Property class (propertyClass)",
"Condition (condition)",
"Heating (heating)",
"Garage / parking (garage)",
"Bedrooms (bedrooms)",
"Floor number (floorNumber)",
"Elevator (hasElevator)",
"Furnishing (furnishing)",
"Features (features)",
"Views (views)",
"Sea distance (seaDistance)",
"Description (description)",
"All photos (imageUrls)",
"Has virtual tour (hasVirtualTour)",
"Price per m2 (pricePerSqm)",
"Price band (priceRange)",
"Previous price (previousPrice)",
"Price drop % (priceDropPercent)",
"Price drop date (priceDropDate)",
"Listing tier (listingTier)",
"New listing (isNewListing)",
"Luxury (isLuxury)",
"Visit bookable (visitBookable)",
"Virtual visit (virtualVisitAvailable)",
"Agency id (agencyId)",
"Agency type (agencyType)",
"Agency page (agencyUrl)",
"Agency logo (agencyLogo)",
"Agency phone (agencyPhone)",
"Listing UUID (uuid)"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}