{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it Scraper: Italy Property Listings", "description": "Scrape Immobiliare.it homes for sale or rent in Italy by city, province or region slug. Price, surface, rooms, floor, address, coordinates, condition, photos, agency names and phones, agent contacts where listed. Filter by price, surface and rooms. Unofficial.", "version": "0.1", "x-build-id": "rICfN6c5InOt0weU7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~immobiliare-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-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/reventadata~immobiliare-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-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/reventadata~immobiliare-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-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": { "contract": { "title": "Buy or rent", "enum": [ "sale", "rent" ], "type": "string", "description": "Homes for sale (vendita-case) or for rent (affitto-case).", "default": "sale" }, "location": { "title": "Location slug", "type": "string", "description": "The place as it appears in an immobiliare.it search URL after /vendita-case/ or /affitto-case/, for example \"torino\", \"milano\" or \"lombardia\". Copy it from a real search URL. An unknown slug stops the run with an error.", "default": "torino" }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Sent to the site as its minimum price filter. On a rent search this is the monthly rent." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Optional. Sent to the site as its maximum price filter. On a rent search this is the monthly rent." }, "minSurface": { "title": "Minimum surface (m²)", "minimum": 0, "type": "integer", "description": "Optional. Sent to the site as its minimum surface filter." }, "minRooms": { "title": "Minimum rooms", "minimum": 0, "type": "integer", "description": "Optional. Sent to the site as its minimum number of rooms (locali) filter." }, "maxRooms": { "title": "Maximum rooms", "minimum": 0, "type": "integer", "description": "Optional. Sent to the site as its maximum number of rooms (locali) filter." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "priceAscending" ], "type": "string", "description": "The site's default relevance order, or price from lowest to highest.", "default": "relevance" }, "maxItems": { "title": "Maximum rows", "minimum": 1, "type": "integer", "description": "Hard cap on rows pushed.", "default": 1000 }, "maxPages": { "title": "Maximum pages", "minimum": 1, "maximum": 80, "type": "integer", "description": "Cap on result pages fetched (25 ads each). The site serves at most 80 pages (2,000 ads) per search, so narrow big searches with a smaller location or the filters above. Each page is one paid unblocking request on the Actor's side and takes about 30 seconds.", "default": 80 } } }, "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 } } } } } } } } } }