{ "openapi": "3.0.1", "info": { "title": "Subito.it Classifieds Scraper - Italy Marketplace", "description": "Scrapes subito.it, Italy's largest classifieds marketplace: cars, property, electronics, jobs and 38 more categories across all 20 regions. Returns price, location, seller type, images and every category attribute, with honest reporting of subito's 9,000-item paging wall.", "version": "0.1", "x-build-id": "pBQrW1sqwRtbE5Nvx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~subito-classifieds-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-subito-classifieds-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/scrapyx~subito-classifieds-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-subito-classifieds-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/scrapyx~subito-classifieds-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-subito-classifieds-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": { "categories": { "title": "Categories", "type": "array", "description": "Which subito categories to search. Cars, motorbikes, property, electronics, jobs and more — 42 verified categories. An unknown one is refused up front, because subito answers it with a bare HTTP 404.", "items": { "type": "string", "enum": [ "auto", "moto-e-scooter", "veicoli-commerciali", "caravan-e-camper", "nautica", "accessori-auto", "accessori-moto", "motori", "immobili", "appartamenti", "ville-singole-e-a-schiera", "loft-mansarde", "terreni-e-rustici", "garage-e-box", "uffici-locali-commerciali", "elettronica", "informatica", "telefonia", "audio-video", "fotografia", "videogiochi", "elettrodomestici", "arredamento-casalinghi", "giardino-fai-da-te", "attrezzature", "abbigliamento-accessori", "casa-e-persona", "bambini-giocattoli", "animali", "accessori-per-animali", "sport", "sport-hobby", "biciclette", "hobby-collezionismo", "libri-riviste", "musica-film", "strumenti-musicali", "servizi", "usato", "lavoro", "offerte-lavoro", "cerco-lavoro" ], "enumTitles": [ "Auto", "Moto E Scooter", "Veicoli Commerciali", "Caravan E Camper", "Nautica", "Accessori Auto", "Accessori Moto", "Motori", "Immobili", "Appartamenti", "Ville Singole E A Schiera", "Loft Mansarde", "Terreni E Rustici", "Garage E Box", "Uffici Locali Commerciali", "Elettronica", "Informatica", "Telefonia", "Audio Video", "Fotografia", "Videogiochi", "Elettrodomestici", "Arredamento Casalinghi", "Giardino Fai Da Te", "Attrezzature", "Abbigliamento Accessori", "Casa E Persona", "Bambini Giocattoli", "Animali", "Accessori Per Animali", "Sport", "Sport Hobby", "Biciclette", "Hobby Collezionismo", "Libri Riviste", "Musica Film", "Strumenti Musicali", "Servizi", "Usato", "Lavoro", "Offerte Lavoro", "Cerco Lavoro" ] } }, "regions": { "title": "Regions", "type": "array", "description": "Italian regions to search, or 'italia' for the whole country. Each region x category pair runs as its own query with its own summary row.", "items": { "type": "string", "enum": [ "italia", "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": [ "Italia", "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" ] } }, "query": { "title": "Keyword", "type": "string", "description": "Free-text search, e.g. 'bmw serie 3'. A phrase that matches nothing returns an honest zero rather than the unfiltered list." }, "titleOnly": { "title": "Search titles only", "type": "boolean", "description": "Restrict the keyword to ad titles instead of titles and descriptions.", "default": false }, "advertiserType": { "title": "Advertiser", "enum": [ "any", "private", "dealer" ], "type": "string", "description": "Private sellers or dealers/businesses. Verified against upstream's own vocabulary — the two values partition the catalogue exactly (290,112 private + 240,815 dealer against a 530,881 baseline).", "default": "any" }, "minPrice": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Lower bound on the listing price." }, "maxPrice": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Upper bound on the listing price." }, "sortOrder": { "title": "Sort order", "enum": [ "default", "datedesc", "relevance", "priceasc", "pricedesc", "yearasc", "yeardesc", "mileageasc", "mileagedesc" ], "type": "string", "description": "Result ordering. Only the values subito publishes for the category are honoured; year and mileage sorts apply to vehicle categories.", "default": "default" }, "maxItemsPerQuery": { "title": "Max listings per query", "minimum": 0, "type": "integer", "description": "Stop each region x category query after this many listings. Set 0 for as many as subito will serve — but note its hard wall of 9,000 items (300 pages) per query regardless of how many it says exist. The summary row reports the gap.", "default": 120 }, "extraFilters": { "title": "Extra filters (advanced, raw)", "type": "object", "description": "Raw subito query parameters for category-specific filters, e.g. {\"fl\":\"2\"} for diesel or {\"gr\":\"2\"} for automatic. These are passed through UNVERIFIED — subito silently ignores names it does not recognise — so the run also fetches the same search without them and reports both totals in `extraFiltersChangedTotal`, letting you see whether your filter did anything.", "default": {} }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Page fetches in flight at once across all queries.", "default": 3 }, "minRequestInterval": { "title": "Min seconds between request starts", "minimum": 0, "maximum": 30, "type": "integer", "description": "Politeness pacing shared across all workers.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional and OFF by default. DataDome is present on the domain but never fired during recon; an Italian or European residential proxy is the first thing to try if it ever does.", "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 } } } } } } } } } }