# Aste Giudiziarie PVP — Portale Vendite Pubbliche (`promptica/aste-giudiziarie-pvp`) Actor Estrae le aste giudiziarie italiane (immobili e beni mobili) dal portale ufficiale pvp.giustizia.it. Filtra per tipo bene, tribunale, fascia di prezzo, scadenza e ricerca libera. Dati 100% pubblici, senza registrazione. - **URL**: https://apify.com/promptica/aste-giudiziarie-pvp.md - **Developed by:** [Lorenzo Talamucci](https://apify.com/promptica) (community) - **Categories:** Business - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Aste Giudiziarie PVP Estrae le **aste giudiziarie pubbliche italiane** (immobili e beni mobili) dal portale ufficiale **pvp.giustizia.it** (Portale delle Vendite Pubbliche, Ministero della Giustizia). ### Fonte dati | Attributo | Valore | |-----------|--------| | Ente | Ministero della Giustizia — Portale delle Vendite Pubbliche | | URL portale | https://pvp.giustizia.it | | API | `POST https://pvp.giustizia.it/ric-496b258c-986a1b71/ric-ms/ricerca/vendite` | | Autenticazione | Nessuna (endpoint pubblico, identico a quello usato dalla homepage) | | robots.txt | Assente (HTTP 404) — nessuna restrizione esplicita | | Dati | Interamente pubblici per legge (art. 490 c.p.c. e D.M. 32/2015) | | Volume | ~339.000 annunci storici; ~11.600 in scadenza (luglio 2026) | L'API è la stessa usata dal widget pubblico `area-annunci` presente sulla homepage del portale. La configurazione dei microservizi viene letta da `bo-ms/fe-config/area-annunci` (JSON pubblico) prima di ogni run, consentendo di aggiornare automaticamente gli URL dei servizi in caso di deploy. ### Esempio di record reale Risposta live testata il **2026-07-17** con: ```` POST https://pvp.giustizia.it/ric-496b258c-986a1b71/ric-ms/ricerca/vendite?page=0\&size=2\&sort=dataVendita,asc Body: {"filtroAnnunci": 1, "tipoLotto": "IMMOBILI"} ```` ```json { "id": 4561928, "tipoLotto": "IMMOBILI", "categoriaLotto": "IMMOBILE_COMMERCIALE", "categoriaBene": ["FABBRICATI_COMMERCIALI"], "prezzoBaseAsta": 67500.0, "offertaMinima": 50625.0, "rialzoMinimo": 500.0, "dataVendita": "2026-07-17", "orarioVendita": "10:00", "dataPubblicazione": "2026-06-16", "tribunale": "Tribunale di SIRACUSA", "codiceTribunale": "0190360094", "procedura": "382", "numeroLotto": "LOTTO UNICO", "disponibilita": ["LIBER"], "esito": null, "via": "Via Maestranza 105", "cap": "96100", "citta": "Siracusa", "provincia": "Siracusa", "latitudine": null, "longitudine": null, "url": "https://pvp.giustizia.it/pvp/it/detail_annuncio.page?idAnnuncio=4561928" } ```` ### Input | Campo | Tipo | Default | Descrizione | |-------|------|---------|-------------| | `tipoLotto` | enum | \`\` (tutti) | `IMMOBILI` o `MOBILI` | | `filtroAnnunci` | enum | `1` | `-1` = archivio completo; `0` = ultimi pubblicati; `1` = in scadenza | | `ricercaLibera` | string | — | Testo libero nel titolo/descrizione | | `prezzoMin` | integer | `0` | Prezzo base ≥ (€) | | `prezzoMax` | integer | `0` | Prezzo base ≤ (€) | | `tribunaleContiene` | string | — | Match parziale sul nome tribunale (es. `MILANO`) | | `maxResults` | integer | `200` | Massimo record estratti (1–10000) | ### Output Un record per lotto d'asta: | Campo | Descrizione | |-------|-------------| | `id` | ID univoco PVP | | `tipoLotto` | IMMOBILI / MOBILI | | `categoriaLotto` | Es. IMMOBILE\_RESIDENZIALE, ALTRA\_CATEGORIA\_M | | `categoriaBene` | Array di sotto-categorie (es. APPARTAMENTO, AUTOVETTURA) | | `prezzoBaseAsta` | Prezzo base d'asta in € | | `offertaMinima` | Offerta minima ammessa in € | | `rialzoMinimo` | Rialzo minimo in € | | `dataVendita` | Data dell'esperimento (YYYY-MM-DD) | | `orarioVendita` | Orario (HH:MM) | | `dataPubblicazione` | Data pubblicazione avviso | | `tribunale` | Tribunale competente | | `codiceTribunale` | Codice interno tribunale | | `procedura` | Numero procedura esecutiva | | `numeroLotto` | Identificativo lotto (es. LOTTO UNICO) | | `disponibilita` | Array: LIBER / OCCUP / NON\_SPECIFICATA | | `esito` | Esito se già aggiudicato (es. AGGIU, ASDES) | | `descLotto` | Descrizione testuale del bene | | `via`, `cap`, `citta`, `provincia` | Indirizzo del bene | | `latitudine`, `longitudine` | Coordinate GPS (quando disponibili) | | `url` | Link diretto alla scheda su pvp.giustizia.it | ### Note tecniche - **Nessun proxy obbligatorio**: l'API risponde regolarmente da IP datacenter. - **Rate limiting**: l'actor aggiunge 200 ms tra le pagine per rispetto del servizio. - **Dati storici**: `filtroAnnunci: -1` recupera l'intero archivio (~339k record); impostare `maxResults` di conseguenza. - **Prezzi e disponibilità**: filtri `prezzoMin`/`prezzoMax` e `tribunaleContiene` sono applicati lato actor (post-fetch) perché l'API pubblica non espone questi parametri nel body di ricerca. # Actor input Schema ## `tipoLotto` (type: `string`): Filtra per tipo di bene. IMMOBILI = appartamenti, capannoni, terreni ecc.; MOBILI = veicoli, macchinari, aziende ecc. Vuoto = tutti. ## `filtroAnnunci` (type: `string`): 0 = ultimi annunci pubblicati; 1 = aste in scadenza; -1 = tutti gli archivi. ## `ricercaLibera` (type: `string`): Testo libero cercato nel titolo/descrizione del lotto, es. appartamento, terreno, autovettura. ## `prezzoMin` (type: `integer`): Includi solo lotti con prezzo base d'asta ≥ a questo valore. 0 = nessun minimo. ## `prezzoMax` (type: `integer`): Includi solo lotti con prezzo base d'asta ≤ a questo valore. 0 = nessun massimo. ## `tribunaleContiene` (type: `string`): Match parziale sul nome del tribunale, es. MILANO, ROMA, NAPOLI. Case-insensitive. ## `maxResults` (type: `integer`): Quante aste estrarre al massimo (1–10000). ## Actor input object example ```json { "tipoLotto": "", "filtroAnnunci": "1", "ricercaLibera": "appartamento", "prezzoMin": 0, "prezzoMax": 0, "tribunaleContiene": "MILANO", "maxResults": 200 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("promptica/aste-giudiziarie-pvp").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("promptica/aste-giudiziarie-pvp").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call promptica/aste-giudiziarie-pvp --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=promptica/aste-giudiziarie-pvp", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Aste Giudiziarie PVP — Portale Vendite Pubbliche", "description": "Estrae le aste giudiziarie italiane (immobili e beni mobili) dal portale ufficiale pvp.giustizia.it. Filtra per tipo bene, tribunale, fascia di prezzo, scadenza e ricerca libera. Dati 100% pubblici, senza registrazione.", "version": "0.1", "x-build-id": "mBP0iWdtsUsgkUerN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/promptica~aste-giudiziarie-pvp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-promptica-aste-giudiziarie-pvp", "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/promptica~aste-giudiziarie-pvp/runs": { "post": { "operationId": "runs-sync-promptica-aste-giudiziarie-pvp", "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/promptica~aste-giudiziarie-pvp/run-sync": { "post": { "operationId": "run-sync-promptica-aste-giudiziarie-pvp", "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": { "tipoLotto": { "title": "Tipo lotto", "enum": [ "", "IMMOBILI", "MOBILI" ], "type": "string", "description": "Filtra per tipo di bene. IMMOBILI = appartamenti, capannoni, terreni ecc.; MOBILI = veicoli, macchinari, aziende ecc. Vuoto = tutti.", "default": "" }, "filtroAnnunci": { "title": "Stato annunci", "enum": [ "-1", "0", "1" ], "type": "string", "description": "0 = ultimi annunci pubblicati; 1 = aste in scadenza; -1 = tutti gli archivi.", "default": "1" }, "ricercaLibera": { "title": "Ricerca libera", "type": "string", "description": "Testo libero cercato nel titolo/descrizione del lotto, es. appartamento, terreno, autovettura." }, "prezzoMin": { "title": "Prezzo base minimo (€)", "type": "integer", "description": "Includi solo lotti con prezzo base d'asta ≥ a questo valore. 0 = nessun minimo.", "default": 0 }, "prezzoMax": { "title": "Prezzo base massimo (€)", "type": "integer", "description": "Includi solo lotti con prezzo base d'asta ≤ a questo valore. 0 = nessun massimo.", "default": 0 }, "tribunaleContiene": { "title": "Tribunale contiene", "type": "string", "description": "Match parziale sul nome del tribunale, es. MILANO, ROMA, NAPOLI. Case-insensitive." }, "maxResults": { "title": "Numero massimo di risultati", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Quante aste estrarre al massimo (1–10000).", "default": 200 } } }, "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 } } } } } } } } } } ```