{ "openapi": "3.0.1", "info": { "title": "Italy Property Auctions API - PVP Judicial Auctions in English", "description": "[💵 $4.00 / 1K] Aste giudiziarie dal Portale delle Vendite Pubbliche: prezzo base, offerta minima, stato occupazione, tribunale. Clean English schema for international investors - base price, minimum offer, discount %, occupancy, coordinates & bidding links. Not a pvp.giustizia.it dump.", "version": "0.1", "x-build-id": "xOYHudkXtlOS3MGdp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~italy-pvp-auctions-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-italy-pvp-auctions-api", "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/webdata_labs~italy-pvp-auctions-api/runs": { "post": { "operationId": "runs-sync-webdata_labs-italy-pvp-auctions-api", "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/webdata_labs~italy-pvp-auctions-api/run-sync": { "post": { "operationId": "run-sync-webdata_labs-italy-pvp-auctions-api", "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": { "region": { "title": "Region", "type": "string", "description": "Italian region to search. Accepts Italian or English names: 'Lazio', 'Lombardia'/'Lombardy', 'Toscana'/'Tuscany', 'Sicilia'/'Sicily'... Leave empty to search all of Italy." }, "city": { "title": "City / comune (optional)", "type": "string", "description": "Optional locality filter, e.g. 'Roma', 'Milano', 'Firenze'. Combined with region." }, "assetType": { "title": "Asset type", "enum": [ "real-estate", "movable", "companies", "credits", "other" ], "type": "string", "description": "What kind of asset is being auctioned.", "default": "real-estate" }, "propertyCategory": { "title": "Property category", "enum": [ "any", "residential", "commercial", "industrial", "sports", "other" ], "type": "string", "description": "Narrow real estate to a category. Ignored for non-real-estate asset types.", "default": "any" }, "timeFilter": { "title": "Auction window", "enum": [ "on-sale", "recent-outcomes", "archive" ], "type": "string", "description": "On sale = auctions currently open or upcoming (what investors want). Recent outcomes = recently held auctions. Full archive = everything since 2010+ (includes concluded).", "default": "on-sale" }, "minBasePrice": { "title": "Min base price (EUR)", "minimum": 0, "type": "integer", "description": "Only auctions with a base price at or above this amount." }, "maxBasePrice": { "title": "Max base price (EUR)", "minimum": 0, "type": "integer", "description": "Only auctions with a base price at or below this amount." }, "searchQuery": { "title": "Free-text search (optional)", "type": "string", "description": "Free-text search over the announcement text, e.g. 'villa vista mare' or a street name." }, "auctionIds": { "title": "Specific auction IDs (optional)", "type": "string", "description": "Fetch specific auctions directly instead of searching. One or more PVP announcement IDs (the idAnnuncio number, e.g. '4600384'), separated by comma, space or new line. When set, the search filters above are ignored." }, "includeDetails": { "title": "Fetch full details", "type": "boolean", "description": "Fetch each auction's detail record (sale method, offer deadline, official bidding links, per-item descriptions). One extra light request per auction. Off = search rows only, twice as fast.", "default": true }, "maxResults": { "title": "Max auctions", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety cap on how many auctions to return in one run.", "default": 50 }, "includeRaw": { "title": "Include raw fields", "type": "boolean", "description": "Attach the original Italian API payloads under 'raw' for auditing. Off by default to keep rows clean.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The PVP portal is a public official source and works without a proxy; enable Apify Proxy only for very large batches.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }