{ "openapi": "3.0.1", "info": { "title": "Casa Property Search Scraper", "description": "[💰 $1.5 / 1K] Scrape comprehensive property listings from Casa.it with detailed features, pricing, locations, and agency contact information.", "version": "1.0", "x-build-id": "N3D6hmje15rKPSiGF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~casa-property-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-casa-property-search-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/solidcode~casa-property-search-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-casa-property-search-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/solidcode~casa-property-search-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-casa-property-search-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": "Paste Casa.it search result page URLs directly. You can copy URLs directly from Casa.it search results (e.g., results for property searches in Roma, Milano, etc.). Leave empty if using Search Location below.", "items": { "type": "string" } }, "searchLocation": { "title": "Search Location", "type": "string", "description": "Italian city or region name to search (e.g., 'Roma', 'Milano', 'Napoli', 'Toscana'). Must be the Italian name — English names like 'Rome' or 'Milan' will return no results. Leave empty if using Start URLs above." }, "propertyType": { "title": "Property Type", "enum": [ "all", "appartamento", "casa", "villa", "terreno", "locale" ], "type": "string", "description": "Type of property to search for. 'All Homes' covers every residential listing (apartments, houses, villas). Land and Commercial Space are separate categories on Casa.it, so pick them explicitly. Only applies when using Search Location — ignored when using URLs.", "default": "all" }, "priceMin": { "title": "Minimum Price (€)", "minimum": 0, "type": "integer", "description": "Only include properties at or above this price in euros. Leave empty for no minimum. Only applies to Search Location." }, "priceMax": { "title": "Maximum Price (€)", "minimum": 0, "type": "integer", "description": "Only include properties at or below this price in euros. Leave empty for no maximum. Only applies to Search Location." }, "maxResultsPerUrl": { "title": "Max Properties Per URL", "minimum": 0, "type": "integer", "description": "Maximum number of properties to collect from each URL or search, applied to every one separately. Starts at 20, which is a single page of Casa.it results — raise it to 50-100 for larger result sets, or set it to 0 to collect everything a search offers (Casa.it serves about 1,600 properties per search). This is the field to change if a run returns fewer properties than you expected.", "default": 20 }, "maxResults": { "title": "Max Results Overall", "minimum": 0, "type": "integer", "description": "Budget for the whole run, added up across every URL or search. Raising it does NOT raise the per-search limit: with Max Properties Per URL left at 20, one search returns 20 properties however high you set this. Raise that field too. Set this to 0 for no overall limit.", "default": 0 }, "ignoreUrlFailures": { "title": "Continue If URLs Fail", "type": "boolean", "description": "When enabled, the scraper will skip failed URLs and continue with the remaining ones. When disabled, the entire run stops if any URL fails.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "How this run connects to Casa.it. The default works well and needs no change. If a run finishes with no properties at all, or the log says the connection was refused, come back here, pick Residential under Apify Proxy, and run it again — that usually clears it.", "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 } } }, "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 } } } } } } } } } }