{ "openapi": "3.0.1", "info": { "title": "Subito.it Scraper", "description": "Scrape Subito.it ads: price, cars (brand, model, km, year, fuel, power), real estate (m², rooms, energy class), jobs, seller, location, photos. Every Subito filter, no 10,000 result cap. Seller ratings and dealer details as an add-on.", "version": "1.0", "x-build-id": "TYUPqtkbyaT39i1bQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~subito-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-subito-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/normdata~subito-scraper/runs": { "post": { "operationId": "runs-sync-normdata-subito-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/normdata~subito-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-subito-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": { "maxItems": { "title": "Maximum ads", "minimum": 1, "type": "integer", "description": "Stop after this many ads in total. Leave empty for no limit (every matching ad, even past the 10,000 results Subito shows per search). The Apify Free plan is always capped at 10." }, "searchTerms": { "title": "Search terms", "type": "array", "description": "One search per line, e.g. \"iphone 15\", \"golf 7\", \"bilocale\". Leave empty to browse a whole category or all of Subito.", "items": { "type": "string" } }, "urls": { "title": "...or paste Subito links", "type": "array", "description": "Search results pages, e.g. https://www.subito.it/annunci-lombardia/vendita/auto/milano/?q=golf. Every filter in the link is kept. Ignored filters below do not change links.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categories": { "title": "Categories", "type": "array", "description": "Pick one or more of the 45 Subito categories. Each one is searched separately. Car, real estate and job filters below need a matching category.", "items": { "type": "string", "enum": [ "1", "2", "5", "3", "36", "22", "34", "4", "6", "7", "43", "29", "30", "31", "32", "33", "8", "24", "26", "50", "42", "25", "9", "10", "44", "11", "40", "12", "13", "14", "37", "15", "16", "17", "18", "23", "100", "19", "38", "39", "20", "41", "21", "27", "28" ], "enumTitles": [ "Motori (all)", "Motori > Auto", "Motori > Accessori Auto", "Motori > Moto e Scooter", "Motori > Accessori Moto", "Motori > Nautica", "Motori > Caravan e Camper", "Motori > Veicoli commerciali", "Immobili (all)", "Immobili > Appartamenti", "Immobili > Camere/Posti letto", "Immobili > Ville singole e a schiera", "Immobili > Terreni e rustici", "Immobili > Garage e box", "Immobili > Loft, mansarde e altro", "Immobili > Case vacanza", "Immobili > Uffici e Locali commerciali", "Lavoro e servizi (all)", "Lavoro e servizi > Offerte di lavoro", "Lavoro e servizi > Servizi", "Lavoro e servizi > Candidati in cerca di lavoro", "Lavoro e servizi > Attrezzature di lavoro", "Elettronica (all)", "Elettronica > Informatica", "Elettronica > Console e Videogiochi", "Elettronica > Audio/Video", "Elettronica > Fotografia", "Elettronica > Telefonia", "Per la casa e la persona (all)", "Per la casa e la persona > Arredamento e Casalinghi", "Per la casa e la persona > Elettrodomestici", "Per la casa e la persona > Giardino e Fai da te", "Per la casa e la persona > Abbigliamento e Accessori", "Per la casa e la persona > Tutto per i bambini", "Sports e hobby (all)", "Sports e hobby > Animali", "Sports e hobby > Accessori per animali", "Sports e hobby > Musica e Film", "Sports e hobby > Libri e Riviste", "Sports e hobby > Strumenti Musicali", "Sports e hobby > Sports", "Sports e hobby > Biciclette", "Sports e hobby > Collezionismo", "Altri annunci (all)", "Altri annunci > Altri" ] } }, "adType": { "title": "Ad type", "enum": [ "s", "u", "h", "k", "g" ], "type": "string", "description": "For sale, for rent, wanted, free or holiday rental. Leave empty for every type." }, "titleOnly": { "title": "Search in titles only", "type": "boolean", "description": "Match the search terms in the ad title only, not the description. Fewer, more precise results.", "default": false }, "regions": { "title": "Regions", "type": "array", "description": "Keep only ads in ANY of these regions.", "items": { "type": "string", "enum": [ "13", "17", "18", "15", "8", "7", "11", "3", "4", "12", "14", "2", "16", "19", "20", "9", "5", "10", "1", "6" ], "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" ] } }, "provinces": { "title": "Provinces", "type": "array", "description": "Keep only ads in these provinces. Each province is searched separately. Overrides Regions.", "items": { "type": "string", "enum": [ "20:1", "2:1", "12:1", "1:1", "9:1", "12:2", "2:2", "15:1", "16:1", "16:6", "6:1", "15:2", "4:1", "2:3", "8:1", "5:1", "4:2", "16:2", "19:1", "20:2", "14:1", "15:3", "20:3", "18:1", "13:2", "4:3", "18:2", "4:4", "18:3", "2:4", "20:4", "12:3", "8:2", "9:3", "16:3", "8:3", "11:1", "19:3", "3:1", "7:1", "9:2", "3:2", "14:2", "13:1", "3:3", "11:2", "16:4", "4:5", "9:4", "4:6", "9:5", "12:4", "4:7", "9:6", "17:1", "19:2", "20:5", "4:8", "8:4", "4:9", "15:4", "2:5", "19:4", "19:5", "19:7", "6:2", "20:6", "8:5", "4:10", "10:1", "12:5", "13:3", "8:6", "9:7", "9:8", "7:2", "17:2", "9:9", "20:7", "8:7", "18:4", "8:8", "11:3", "8:9", "11:4", "6:3", "15:5", "19:8", "3:4", "9:10", "20:8", "4:11", "19:6", "16:5", "13:4", "10:2", "2:6", "20:9", "5:2", "6:4", "7:3", "7:4", "4:12", "6:5", "2:7", "2:8", "6:6", "18:5", "6:7", "11:5" ], "enumTitles": [ "Agrigento (AG), Sicilia", "Alessandria (AL), Piemonte", "Ancona (AN), Marche", "Aosta (AO), Valle d'Aosta", "Arezzo (AR), Toscana", "Ascoli Piceno (AP), Marche", "Asti (AT), Piemonte", "Avellino (AV), Campania", "Bari (BA), Puglia", "Barletta-Andria-Trani (BT), Puglia", "Belluno (BL), Veneto", "Benevento (BN), Campania", "Bergamo (BG), Lombardia", "Biella (BI), Piemonte", "Bologna (BO), Emilia-Romagna", "Bolzano (BZ), Trentino-Alto Adige", "Brescia (BS), Lombardia", "Brindisi (BR), Puglia", "Cagliari (CA), Sardegna", "Caltanissetta (CL), Sicilia", "Campobasso (CB), Molise", "Caserta (CE), Campania", "Catania (CT), Sicilia", "Catanzaro (CZ), Calabria", "Chieti (CH), Abruzzo", "Como (CO), Lombardia", "Cosenza (CS), Calabria", "Cremona (CR), Lombardia", "Crotone (KR), Calabria", "Cuneo (CN), Piemonte", "Enna (EN), Sicilia", "Fermo (FM), Marche", "Ferrara (FE), Emilia-Romagna", "Firenze (FI), Toscana", "Foggia (FG), Puglia", "Forlì-Cesena (FC), Emilia-Romagna", "Frosinone (FR), Lazio", "Gallura (OT), Sardegna", "Genova (GE), Liguria", "Gorizia (GO), Friuli-Venezia Giulia", "Grosseto (GR), Toscana", "Imperia (IM), Liguria", "Isernia (IS), Molise", "L'Aquila (AQ), Abruzzo", "La Spezia (SP), Liguria", "Latina (LT), Lazio", "Lecce (LE), Puglia", "Lecco (LC), Lombardia", "Livorno (LI), Toscana", "Lodi (LO), Lombardia", "Lucca (LU), Toscana", "Macerata (MC), Marche", "Mantova (MN), Lombardia", "Massa-Carrara (MS), Toscana", "Matera (MT), Basilicata", "Medio Campidano (VS), Sardegna", "Messina (ME), Sicilia", "Milano (MI), Lombardia", "Modena (MO), Emilia-Romagna", "Monza e della Brianza (MB), Lombardia", "Napoli (NA), Campania", "Novara (NO), Piemonte", "Nuoro (NU), Sardegna", "Ogliastra (OG), Sardegna", "Oristano (OR), Sardegna", "Padova (PD), Veneto", "Palermo (PA), Sicilia", "Parma (PR), Emilia-Romagna", "Pavia (PV), Lombardia", "Perugia (PG), Umbria", "Pesaro e Urbino (PU), Marche", "Pescara (PE), Abruzzo", "Piacenza (PC), Emilia-Romagna", "Pisa (PI), Toscana", "Pistoia (PT), Toscana", "Pordenone (PN), Friuli-Venezia Giulia", "Potenza (PZ), Basilicata", "Prato (PO), Toscana", "Ragusa (RG), Sicilia", "Ravenna (RA), Emilia-Romagna", "Reggio Calabria (RC), Calabria", "Reggio Emilia (RE), Emilia-Romagna", "Rieti (RI), Lazio", "Rimini (RN), Emilia-Romagna", "Roma (RM), Lazio", "Rovigo (RO), Veneto", "Salerno (SA), Campania", "Sassari (SS), Sardegna", "Savona (SV), Liguria", "Siena (SI), Toscana", "Siracusa (SR), Sicilia", "Sondrio (SO), Lombardia", "Sulcis Iglesiente (SU), Sardegna", "Taranto (TA), Puglia", "Teramo (TE), Abruzzo", "Terni (TR), Umbria", "Torino (TO), Piemonte", "Trapani (TP), Sicilia", "Trento (TN), Trentino-Alto Adige", "Treviso (TV), Veneto", "Trieste (TS), Friuli-Venezia Giulia", "Udine (UD), Friuli-Venezia Giulia", "Varese (VA), Lombardia", "Venezia (VE), Veneto", "Verbano-Cusio-Ossola (VB), Piemonte", "Vercelli (VC), Piemonte", "Verona (VR), Veneto", "Vibo Valentia (VV), Calabria", "Vicenza (VI), Veneto", "Viterbo (VT), Lazio" ] } }, "towns": { "title": "Towns", "type": "array", "description": "Town (comune) names, e.g. \"Bergamo\", \"Sesto San Giovanni\" or \"Reggio nell'Emilia\". Add the province code to pick between towns with the same name, e.g. \"Calliano (TN)\". Each town is searched separately. Overrides Regions and Provinces.", "items": { "type": "string" } }, "sellerType": { "title": "Seller", "enum": [ "all", "private", "company" ], "type": "string", "description": "Private sellers, or verified companies (car dealers, real estate agencies, shops, employers).", "default": "all" }, "minPrice": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Ads priced at least this much. Ads with no price are dropped." }, "maxPrice": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Ads priced at most this much." }, "itemCondition": { "title": "Item condition", "type": "array", "description": "Keep only items in ANY of these conditions. For goods (electronics, home, fashion, sports and more).", "items": { "type": "string", "enum": [ "10", "20", "30", "40", "50" ], "enumTitles": [ "Nuovo", "Come nuovo", "Ottimo", "Buono", "Danneggiato" ] } }, "shippingOnly": { "title": "Shipping available only", "type": "boolean", "description": "Keep only items the seller ships with TuttoSubito. Works for goods categories.", "default": false }, "urgentOnly": { "title": "Urgent ads only", "type": "boolean", "description": "Keep only ads marked urgent.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevance", "price_low", "price_high", "year_new", "year_old", "mileage_low", "mileage_high", "power_high", "power_low" ], "type": "string", "description": "Order of the results. Matters most when you set a Maximum. Year, mileage and power sorting only work for cars and motorbikes. Lowest price puts ads with no price first.", "default": "newest" }, "brands": { "title": "Brands", "type": "array", "description": "Car or motorbike brands, e.g. \"Volkswagen\", \"Fiat\", \"BMW\", \"Ducati\". Each brand is searched separately.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Models of the brands above, e.g. \"Golf\", \"Panda\", \"Serie 3\". Needs a brand.", "items": { "type": "string" } }, "vehicleCondition": { "title": "Vehicle condition", "type": "array", "description": "Used, Km 0 or new.", "items": { "type": "string", "enum": [ "1", "2", "3" ], "enumTitles": [ "Used (Usato)", "Km 0", "New (Nuovo)" ] } }, "fuel": { "title": "Fuel", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "6", "8", "9", "10", "11", "12", "13", "7", "5" ], "enumTitles": [ "Benzina", "Diesel", "Gpl", "Elettrica", "Ibrida", "Mild Hybrid Benzina", "Mild Hybrid Diesel", "Full Hybrid Benzina", "Full Hybrid Diesel", "PHEV - Ibrido Plug-in Benzina", "PHEV - Ibrido Plug-in Diesel", "Metano", "Altro" ] } }, "gearbox": { "title": "Gearbox", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Manual, automatic or sequential." }, "minYear": { "title": "Year from", "minimum": 0, "type": "integer", "description": "First registration year, e.g. 2018." }, "maxYear": { "title": "Year to", "minimum": 0, "type": "integer", "description": "First registration year, e.g. 2022." }, "minMileage": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "At least this many kilometres." }, "maxMileage": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "At most this many kilometres, e.g. 100000." }, "minPowerHp": { "title": "Min power (hp)", "minimum": 0, "type": "integer", "description": "Cars only." }, "maxPowerHp": { "title": "Max power (hp)", "minimum": 0, "type": "integer", "description": "Cars only." }, "bodyType": { "title": "Body type", "type": "array", "description": "Cars: keep only ANY of these.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "10" ], "enumTitles": [ "Utilitaria", "Berlina", "Station Wagon", "Monovolume", "SUV/Fuoristrada", "Cabrio", "Coupé", "City Car", "Altro" ] } }, "emissionClass": { "title": "Emission class", "type": "array", "description": "Euro class: keep only ANY of these.", "items": { "type": "string", "enum": [ "13", "12", "11", "10", "9", "8", "7", "6", "5", "4", "3", "2", "1" ], "enumTitles": [ "Euro 6e", "Euro 6d", "Euro 6d-TEMP", "Euro 6c", "Euro 6b", "Euro 6a", "Euro 6", "Euro 5", "Euro 4", "Euro 3", "Euro 2", "Euro 1", "Pre-Euro" ] } }, "colors": { "title": "Colour", "type": "array", "description": "Cars: keep only ANY of these.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10" ], "enumTitles": [ "Bianco", "Grigio", "Marrone", "Nero", "Rosso", "Giallo", "Verde", "Blu-Azzurro", "Arancione", "Viola" ] } }, "doors": { "title": "Doors", "enum": [ "1", "2", "3" ], "type": "string", "description": "Cars only." }, "minSeats": { "title": "Min seats", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8" ], "type": "string", "description": "Cars only." }, "maxSeats": { "title": "Max seats", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8" ], "type": "string", "description": "Cars only." }, "newDriversOnly": { "title": "OK for new drivers", "type": "boolean", "description": "Cars a new driver (neopatentato) may drive.", "default": false }, "vatDeductibleOnly": { "title": "VAT deductible only", "type": "boolean", "description": "Vehicles sold with VAT shown (IVA esposta), handy for companies.", "default": false }, "motoType": { "title": "Motorbike type", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8" ], "type": "string", "description": "Moto e Scooter only." }, "minCc": { "title": "Min engine size (cc)", "enum": [ "50", "125", "150", "250", "600", "750", "900", "1000", "1100", "1200" ], "type": "string", "description": "Moto e Scooter only." }, "maxCc": { "title": "Max engine size (cc)", "enum": [ "50", "125", "150", "250", "600", "750", "900", "1000", "1100", "1200" ], "type": "string", "description": "Moto e Scooter only." }, "commercialType": { "title": "Commercial vehicle type", "enum": [ "1", "8", "2", "3", "4", "5", "6" ], "type": "string", "description": "Veicoli commerciali only." }, "boatType": { "title": "Boat type", "enum": [ "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Nautica only." }, "propertyCondition": { "title": "Property condition", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "10", "20", "30", "40" ], "enumTitles": [ "Nuova costruzione", "Ottimo", "Buono", "Da ristrutturare" ] } }, "minSize": { "title": "Min size (m²)", "minimum": 0, "type": "integer", "description": "Floor area in square metres." }, "maxSize": { "title": "Max size (m²)", "minimum": 0, "type": "integer", "description": "Floor area in square metres." }, "minRooms": { "title": "Min rooms", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11" ], "type": "string", "description": "Rooms (locali), kitchen and living room included." }, "maxRooms": { "title": "Max rooms", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11" ], "type": "string", "description": "Rooms (locali)." }, "minBathrooms": { "title": "Min bathrooms", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "At least this many bathrooms." }, "maxBathrooms": { "title": "Max bathrooms", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "At most this many bathrooms." }, "minFloor": { "title": "Floor from", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ], "type": "string", "description": "Lowest floor." }, "maxFloor": { "title": "Floor to", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12" ], "type": "string", "description": "Highest floor." }, "furnished": { "title": "Furnished", "type": "boolean", "description": "Furnished properties only.", "default": false }, "elevator": { "title": "Elevator", "type": "boolean", "description": "With an elevator only.", "default": false }, "balcony": { "title": "Balcony", "type": "boolean", "description": "With a balcony only.", "default": false }, "topFloor": { "title": "Top floor", "type": "boolean", "description": "Top floor only.", "default": false }, "availableNow": { "title": "Available now", "type": "boolean", "description": "Available immediately only.", "default": false }, "airConditioning": { "title": "Air conditioning", "type": "boolean", "description": "With air conditioning only.", "default": false }, "parking": { "title": "Parking", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "Box privato", "Posto auto riservato", "Posto auto libero", "Posto bici", "Posto moto" ] } }, "heating": { "title": "Heating", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Heating type." }, "minEnergyClass": { "title": "Energy class from", "enum": [ "1500", "1400", "1300", "1200", "1100", "1000", "900", "800", "700", "600", "500", "400", "300", "200", "100" ], "type": "string", "description": "Worst energy class to keep, e.g. G." }, "maxEnergyClass": { "title": "Energy class to", "enum": [ "1500", "1400", "1300", "1200", "1100", "1000", "900", "800", "700", "600", "500", "400", "300", "200", "100" ], "type": "string", "description": "Best energy class to keep, e.g. A4." }, "roomType": { "title": "Room type", "enum": [ "1", "2" ], "type": "string", "description": "Camere/Posti letto only: single or double room." }, "rentTo": { "title": "Rents to", "enum": [ "1", "2", "3" ], "type": "string", "description": "Camere/Posti letto only." }, "smokers": { "title": "Smokers", "enum": [ "1", "2", "3" ], "type": "string", "description": "Camere/Posti letto only." }, "officeType": { "title": "Commercial property type", "enum": [ "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Uffici e Locali commerciali only." }, "jobSectors": { "title": "Job sector", "type": "array", "description": "Keep only ANY of these.", "items": { "type": "string", "enum": [ "100", "101", "102", "103", "104", "105", "106", "107", "108", "109", "110", "111", "112", "113", "114", "115", "116", "117", "118", "119", "120", "121", "122", "123", "124" ], "enumTitles": [ "Acquisti - Logistica - Trasporti", "Affari legali", "Amministrazione - Segreteria", "Architettura - Arti grafiche - Design", "Assistenza anziani e/o disabili", "Commerciale", "Commercio - Negozi", "Contabilità - Finanza", "Direzione - Consulenza", "Edilizia", "Editoria - Giornalismo", "Estetica - Cura della persona", "Formazione - Istruzione", "Informatica - Telecomunicazioni", "Ingegneria", "Marketing - Comunicazione", "Medicina - Salute", "Produzione - Operai", "Project Management", "Qualità - Ambiente", "Risorse Umane", "Sicurezza - Vigilanza", "Supporto al cliente", "Turismo - Ristorazione", "Altro - Lavoro domestico" ] } }, "contractType": { "title": "Contract", "enum": [ "agent", "apprentice", "ind", "project", "stage", "tdet", "zzzzzother" ], "type": "string", "description": "Contract type." }, "workHours": { "title": "Working hours", "enum": [ "fulltime", "parttime", "shift", "zzzzzother" ], "type": "string", "description": "Full time, part time and so on." }, "jobLevel": { "title": "Job level", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Seniority level." }, "education": { "title": "Education", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Required education." }, "fashionType": { "title": "Clothing type", "enum": [ "12", "5", "6", "2", "10", "9", "7", "1", "4", "8", "3", "11" ], "type": "string", "description": "Abbigliamento e Accessori only." }, "fashionGender": { "title": "Clothing for", "enum": [ "1", "2", "3" ], "type": "string", "description": "Abbigliamento e Accessori only." }, "phoneType": { "title": "Phone type", "enum": [ "1", "2", "3" ], "type": "string", "description": "Telefonia only." }, "bicycleType": { "title": "Bicycle type", "enum": [ "1", "2", "3", "4", "5", "7", "8", "9", "10", "6" ], "type": "string", "description": "Biciclette only." }, "animalType": { "title": "Animal", "enum": [ "1", "2", "4", "5", "6", "3" ], "type": "string", "description": "Animali only." }, "titleIncludes": { "title": "Title must contain", "type": "array", "description": "Keep only ads whose title contains ANY of these words, e.g. \"128gb\", \"garanzia\". Not case sensitive.", "items": { "type": "string" } }, "titleExcludes": { "title": "Title must not contain", "type": "array", "description": "Drop ads whose title contains any of these words, e.g. \"rotto\", \"ricambi\", \"cover\".", "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted in the last (days)", "minimum": 0, "type": "integer", "description": "Keep only ads posted or renewed in the last N days, e.g. 7." }, "withPhotosOnly": { "title": "With photos only", "type": "boolean", "description": "Drop ads without photos.", "default": false }, "includeSellerDetails": { "title": "Seller details", "type": "boolean", "description": "Add the seller rating (stars out of 5), number of reviews, usual reply time, reply rate and last activity. For shops and dealers also the address, opening hours, number of active ads, Google rating and shop page. Charged as an add-on per ad that has them.", "default": false }, "includePhone": { "title": "Phone numbers", "type": "boolean", "description": "Add the phone number for ads whose seller shows it on Subito (many dealers, agencies and some private sellers). Charged as an add-on only per ad where a number is found.", "default": false }, "onlyNew": { "title": "New ads only", "type": "boolean", "description": "For scheduled runs: save only ads this same search has not saved before. The first run saves everything; later runs save just what is new. Kept per search (terms, links and filters).", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. Give \"New ads only\" a fixed name to keep its memory even after you change the filters." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional, off by default. Subito works fine without one. Turn it on only if your runs get blocked. Proxy traffic is billed to your Apify account." } } }, "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 } } } } } } } } } }