{ "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": "2usAZllbHhzJb8uap" }, "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: ricerche (es. /annunci-lazio/vendita/auto/roma/roma/fiat/panda/), ricerche con filtri (?ps=5000&pe=15000&ys=2018), annunci singoli (...-664976640.htm) o URL API (hades.subito.it/v1/search/items?...).", "items": { "type": "string" } }, "searchQueries": { "title": "Parole chiave", "type": "array", "description": "Una ricerca per ogni parola chiave: marca, modello o testo libero (es. 'fiat panda', 'golf gti'). I filtri qui sotto valgono per tutte. Lascia vuoto (e senza URL) per cercare solo con i filtri.", "items": { "type": "string" } }, "category": { "title": "Categoria", "enum": [ "auto", "moto-e-scooter", "accessori-auto", "accessori-moto", "veicoli-commerciali", "caravan-e-camper", "nautica" ], "type": "string", "description": "Categoria di veicoli. Carburante e cambio esistono solo per Auto; km, anno e condizione per Auto, Moto, Veicoli commerciali e Camper.", "default": "auto" }, "regions": { "title": "Regioni", "type": "array", "description": "Una o più regioni (vuoto = tutta Italia).", "items": { "type": "string", "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" ], "enumTitles": [ "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" ] } }, "minPrice": { "title": "Prezzo minimo (€)", "minimum": 0, "type": "integer", "description": "Prezzo minimo in Euro." }, "maxPrice": { "title": "Prezzo massimo (€)", "minimum": 0, "type": "integer", "description": "Prezzo massimo in Euro." }, "minMileage": { "title": "Km minimi", "minimum": 0, "type": "integer", "description": "Chilometraggio minimo (esatto)." }, "maxMileage": { "title": "Km massimi", "minimum": 0, "type": "integer", "description": "Chilometraggio massimo (esatto). 0 = solo veicoli a Km 0." }, "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)." }, "fuelTypes": { "title": "Carburante", "type": "array", "description": "Uno o più tipi di alimentazione (solo Auto).", "items": { "type": "string", "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", "altro" ], "enumTitles": [ "Benzina", "Diesel", "Benzina/GPL", "Benzina/Metano", "Ibrida", "Elettrica (BEV)", "Mild Hybrid Benzina", "Mild Hybrid Diesel", "Full Hybrid Benzina", "Full Hybrid Diesel", "Plug-in Hybrid Benzina", "Plug-in Hybrid Diesel", "Altro" ] } }, "gearbox": { "title": "Cambio", "enum": [ "", "manuale", "automatico" ], "type": "string", "description": "Tipo di cambio (solo Auto)." }, "conditions": { "title": "Condizione", "type": "array", "description": "Uno o più stati del veicolo.", "items": { "type": "string", "enum": [ "nuovo", "usato", "km0" ], "enumTitles": [ "Nuovo", "Usato", "Km 0" ] } }, "sellerType": { "title": "Venditore", "enum": [ "", "privato", "azienda" ], "type": "string", "description": "Solo privati o solo rivenditori (concessionari)." }, "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 } } } } } } } } } }