{ "openapi": "3.0.1", "info": { "title": "Immobiliare.it $1💰 Search By URLs and Keywords", "description": "From $1/1K. Extract property listings from Immobiliare.it with clean structured data including prices, descriptions, GPS coordinates, agency details, photos, and property attributes such as condition, heating, garage, floor, and features. Search by city, filters, or URL. Blazing fast, reliable.", "version": "1.0", "x-build-id": "U3yJFxJogiw10tzB9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~immobiliare-it-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-immobiliare-it-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/abotapi~immobiliare-it-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-immobiliare-it-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/abotapi~immobiliare-it-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-immobiliare-it-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", "required": [ "mode" ], "properties": { "mode": { "title": "Search mode", "enum": [ "search", "url" ], "type": "string", "description": "search = build searches from city names + filters. url = paste one or more listing-search URLs and walk them forward.", "default": "search" }, "locations": { "title": "Cities", "type": "array", "description": "City names to search, e.g. Roma, Milano, Torino. Slugification is automatic; accents are stripped. Only applies when mode = search.", "items": { "type": "string" } }, "contract": { "title": "Buy or rent", "enum": [ "sale", "rent" ], "type": "string", "description": "Listing contract type. Only applies when mode = search.", "default": "sale" }, "category": { "title": "Property type", "enum": [ "all", "apartments", "villas" ], "type": "string", "description": "Property category. 'All residential' covers every home type; 'Apartments' and 'Villas' narrow by building type. Only applies when mode = search.", "default": "all" }, "minPrice": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price in euro. Only applies when mode = search." }, "maxPrice": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price in euro. Only applies when mode = search." }, "minSurface": { "title": "Min surface (m²)", "minimum": 0, "type": "integer", "description": "Minimum surface in square metres. Only applies when mode = search." }, "maxSurface": { "title": "Max surface (m²)", "minimum": 0, "type": "integer", "description": "Maximum surface in square metres. Only applies when mode = search." }, "minRooms": { "title": "Min rooms", "minimum": 1, "type": "integer", "description": "Minimum number of rooms (locali). Only applies when mode = search." }, "maxRooms": { "title": "Max rooms", "minimum": 1, "type": "integer", "description": "Maximum number of rooms (locali). Only applies when mode = search." }, "excludeAuctions": { "title": "Exclude auctions", "type": "boolean", "description": "Hide auction listings (aste). Only applies when mode = search.", "default": false }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "price-asc", "price-desc", "newest", "surface-desc" ], "type": "string", "description": "Result ordering. Only applies when mode = search.", "default": "relevance" }, "urls": { "title": "Search URLs", "type": "array", "description": "Paste one or more immobiliare.it listing-search URLs. Multi-URL supported. Filter fields above are ignored in this mode. Pagination starts at the page in the URL and walks forward.", "items": { "type": "string" } }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many result pages to walk per city/URL (about 25 listings per page).", "default": 1 }, "maxListings": { "title": "Max listings (0 = unlimited)", "minimum": 0, "type": "integer", "description": "Hard cap on total listings across all searches. 0 means no cap (bounded by maxPages).", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy is strongly recommended. The actor defaults the country to Italy and rotates across EU pools when needed." } } }, "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 } } } } } } } } } }