{ "openapi": "3.0.1", "info": { "title": "Subito.it Cars & Automotive Scraper", "description": "Scrape Subito.it cars, motorcycles, vans, campers, boats, and vehicle parts. Extract prices, mileage, year, specs, photos, location, seller details, and optional phone data for market research, dealer monitoring, and lead generation.", "version": "0.0", "x-build-id": "61SV2HaTTEhQRNwai" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~subito-automotive-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-subito-automotive-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/epicscrapers~subito-automotive-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-subito-automotive-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/epicscrapers~subito-automotive-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-subito-automotive-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": "URL di partenza", "type": "array", "description": "URL Subito.it o API dirette. Supporta URL di ricerca (es. /annunci-lazio/vendita/auto/), URL con filtri (?q=fiat+panda), URL dettaglio annuncio, e URL API dirette (hades.subito.it/...). Lascia vuoto se usi i filtri qui sotto.", "items": { "type": "string" } }, "searchQuery": { "title": "Cerca", "type": "string", "description": "Testo libero: marca, modello, o qualsiasi parola chiave (es. 'fiat panda', 'mercedes classe a 2008')." }, "category": { "title": "Categoria", "enum": [ "auto", "moto-e-scooter", "accessori-auto", "accessori-moto", "veicoli-commerciali", "caravan-e-camper", "nautica" ], "type": "string", "description": "Categoria di veicoli." }, "region": { "title": "Regione", "enum": [ "", "abruzzo", "basilicata", "calabria", "campania", "emilia-romagna", "friuli-venezia-giulia", "lazio", "liguria", "lombardia", "marche", "molise", "piemonte", "puglia", "sardegna", "sicilia", "toscana", "trentino-alto-adige", "umbria", "valle-d-aosta", "veneto" ], "type": "string", "description": "Filtra per regione italiana." }, "maxPrice": { "title": "Prezzo massimo (€)", "minimum": 0, "type": "integer", "description": "Prezzo massimo in Euro." }, "minPrice": { "title": "Prezzo minimo (€)", "minimum": 0, "type": "integer", "description": "Prezzo minimo in Euro." }, "minMileage": { "title": "Km minimi", "minimum": 0, "type": "integer", "description": "Chilometraggio minimo." }, "maxMileage": { "title": "Km massimi", "minimum": 0, "type": "integer", "description": "Chilometraggio massimo." }, "yearFrom": { "title": "Da anno", "minimum": 1980, "maximum": 2030, "type": "integer", "description": "Anno di immatricolazione minimo (es. 2018)." }, "yearTo": { "title": "A anno", "minimum": 1980, "maximum": 2030, "type": "integer", "description": "Anno di immatricolazione massimo (es. 2025)." }, "fuelType": { "title": "Carburante", "enum": [ "", "benzina", "diesel", "gpl", "metano", "ibrida", "elettrica", "mild-hybrid-benzina", "mild-hybrid-diesel", "full-hybrid-benzina", "full-hybrid-diesel", "plug-in-benzina", "plug-in-diesel" ], "type": "string", "description": "Tipo di alimentazione." }, "gearbox": { "title": "Cambio", "enum": [ "", "manuale", "automatico" ], "type": "string", "description": "Tipo di cambio." }, "condition": { "title": "Condizione", "enum": [ "", "nuovo", "usato", "km0" ], "type": "string", "description": "Stato del veicolo." }, "sortOrder": { "title": "Ordinamento", "enum": [ "relevance", "datedesc", "priceasc", "pricedesc", "yearasc", "yeardesc", "mileageasc", "mileagedesc", "hpasc", "hpdesc", "vlenasc", "vlendesc" ], "type": "string", "description": "Ordina i risultati. Anno e chilometraggio sono disponibili per Auto e Moto; potenza e lunghezza solo per Auto.", "default": "relevance" }, "maxResultPerQuery": { "title": "Risultati massimi per query", "minimum": 0, "type": "integer", "description": "Numero massimo di annunci da estrarre per ogni URL o ricerca. 0 = nessun limite.", "default": 100 }, "enrichPhone": { "title": "Numeri di telefono", "type": "boolean", "description": "Recupera il numero di telefono del venditore per ogni annuncio (richiede una richiesta extra per annuncio).", "default": false }, "enrichShop": { "title": "Dettagli negozio", "type": "boolean", "description": "Recupera i dettagli del negozio (indirizzo, orari, logo, sito web) per annunci di venditori professionali.", "default": false }, "enrichCarSpecs": { "title": "Specifiche tecniche", "type": "boolean", "description": "Recupera le specifiche tecniche dettagliate del veicolo (cilindrata, consumi, emissioni, dimensioni, dotazioni) quando disponibili.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Configurazione proxy Apify." } } }, "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 } } } } } } } } } }