{ "data": { "id": "kb08eNncinzBQOc1Q", "actId": "TnesfgqCgPfjeqcoR", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-11-12T09:24:15.275Z", "finishedAt": "2026-11-12T09:24:28.156Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 12813, "runTimeSecs": 12.813, "computeUnits": 0.014236666666666667, "imageSizeBytes": 358294528 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "6GwdnIcc2aWR7LzCS", "exitCode": 0, "inputSchema": "{\n \"title\": \"Subito.it Scraper Input\",\n \"description\": \"Search Subito.it — Italy's largest classifieds marketplace — for items, cars, electronics, property, jobs, or scrape specific listing URLs.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Mode\",\n \"type\": \"string\",\n \"description\": \"What to fetch from Subito.it. searchByUrls takes listing or search-result URLs in startUrls.\",\n \"editor\": \"select\",\n \"enum\": [\n \"searchAll\",\n \"searchItems\",\n \"searchCars\",\n \"searchElectronics\",\n \"searchRealEstate\",\n \"searchJobs\",\n \"searchByUrls\"\n ],\n \"enumTitles\": [\n \"Search all categories\",\n \"Search general items for sale\",\n \"Search cars & vehicles\",\n \"Search electronics\",\n \"Search real estate\",\n \"Search jobs\",\n \"Scrape listing or search URLs\"\n ],\n \"default\": \"searchItems\",\n \"prefill\": \"searchItems\"\n },\n \"query\": {\n \"title\": \"Search query\",\n \"type\": \"string\",\n \"description\": \"Keyword to search for, e.g. iPhone, divano, BMW. Leave empty to browse a category without a keyword. Ignored in searchByUrls mode.\",\n \"editor\": \"textfield\",\n \"prefill\": \"iPhone\"\n },\n \"category\": {\n \"title\": \"Category\",\n \"type\": \"string\",\n \"description\": \"Optional category filter. Overrides the category implied by the mode.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"1\",\n \"2\",\n \"5\",\n \"3\",\n \"36\",\n \"22\",\n \"34\",\n \"4\",\n \"6\",\n \"7\",\n \"43\",\n \"29\",\n \"30\",\n \"31\",\n \"32\",\n \"33\",\n \"8\",\n \"24\",\n \"26\",\n \"50\",\n \"42\",\n \"25\",\n \"9\",\n \"10\",\n \"44\",\n \"11\",\n \"40\",\n \"12\",\n \"13\",\n \"14\",\n \"37\",\n \"15\",\n \"16\",\n \"17\",\n \"18\",\n \"23\",\n \"100\",\n \"19\",\n \"38\",\n \"39\",\n \"20\",\n \"41\",\n \"21\",\n \"27\",\n \"28\"\n ],\n \"enumTitles\": [\n \"All categories\",\n \"MOTORI\",\n \"Auto\",\n \"Accessori Auto\",\n \"Moto e Scooter\",\n \"Accessori Moto\",\n \"Nautica\",\n \"Caravan e Camper\",\n \"Veicoli commerciali\",\n \"IMMOBILI\",\n \"Appartamenti\",\n \"Camere/Posti letto\",\n \"Ville singole e a schiera\",\n \"Terreni e rustici\",\n \"Garage e box\",\n \"Loft, mansarde e altro\",\n \"Case vacanza\",\n \"Uffici e Locali commerciali\",\n \"LAVORO E SERVIZI\",\n \"Offerte di lavoro\",\n \"Servizi\",\n \"Candidati in cerca di lavoro\",\n \"Attrezzature di lavoro\",\n \"ELETTRONICA\",\n \"Informatica\",\n \"Console e Videogiochi\",\n \"Audio/Video\",\n \"Fotografia\",\n \"Telefonia\",\n \"PER LA CASA e LA PERSONA\",\n \"Arredamento e Casalinghi\",\n \"Elettrodomestici\",\n \"Giardino e Fai da te\",\n \"Abbigliamento e Accessori\",\n \"Tutto per i bambini\",\n \"SPORTS E HOBBY\",\n \"Animali\",\n \"Accessori per animali\",\n \"Musica e Film\",\n \"Libri e Riviste\",\n \"Strumenti Musicali\",\n \"Sports\",\n \"Biciclette\",\n \"Collezionismo\",\n \"ALTRI ANNUNCI\",\n \"Altri\"\n ],\n \"default\": \"\",\n \"prefill\": \"\"\n },\n \"region\": {\n \"title\": \"Region\",\n \"type\": \"string\",\n \"description\": \"Italian region to filter by (friendly name). Leave empty to search all of Italy.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"abruzzo\",\n \"basilicata\",\n \"calabria\",\n \"campania\",\n \"emilia-romagna\",\n \"friuli-venezia-giulia\",\n \"lazio\",\n \"liguria\",\n \"lombardia\",\n \"marche\",\n \"molise\",\n \"piemonte\",\n \"puglia\",\n \"sardegna\",\n \"sicilia\",\n \"toscana\",\n \"trentino-alto-adige\",\n \"umbria\",\n \"valle-d-aosta\",\n \"veneto\"\n ],\n \"enumTitles\": [\n \"All Italy\",\n \"Abruzzo\",\n \"Basilicata\",\n \"Calabria\",\n \"Campania\",\n \"Emilia-Romagna\",\n \"Friuli-Venezia Giulia\",\n \"Lazio\",\n \"Liguria\",\n \"Lombardia\",\n \"Marche\",\n \"Molise\",\n \"Piemonte\",\n \"Puglia\",\n \"Sardegna\",\n \"Sicilia\",\n \"Toscana\",\n \"Trentino-Alto Adige\",\n \"Umbria\",\n \"Valle d'Aosta\",\n \"Veneto\"\n ],\n \"default\": \"\",\n \"prefill\": \"\"\n },\n \"priceMin\": {\n \"title\": \"Min price (EUR)\",\n \"type\": \"integer\",\n \"description\": \"Minimum listing price in Euro.\",\n \"minimum\": 0,\n \"maximum\": 100000000\n },\n \"priceMax\": {\n \"title\": \"Max price (EUR)\",\n \"type\": \"integer\",\n \"description\": \"Maximum listing price in Euro.\",\n \"minimum\": 0,\n \"maximum\": 100000000\n },\n \"sort\": {\n \"title\": \"Sort by\",\n \"type\": \"string\",\n \"description\": \"Result ordering.\",\n \"editor\": \"select\",\n \"enum\": [\n \"relevance\",\n \"datedesc\",\n \"priceasc\",\n \"pricedesc\"\n ],\n \"enumTitles\": [\n \"Relevance\",\n \"Newest first\",\n \"Price: low to high\",\n \"Price: high to low\"\n ],\n \"default\": \"relevance\",\n \"prefill\": \"relevance\"\n },\n \"adType\": {\n \"title\": \"Ad type\",\n \"type\": \"string\",\n \"description\": \"Filter by listing kind: for sale, for rent, give away, holiday rental or wanted.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"s\",\n \"u\",\n \"g\",\n \"h\",\n \"k\"\n ],\n \"enumTitles\": [\n \"All ad types\",\n \"For sale\",\n \"For rent\",\n \"Give away\",\n \"Holiday rental\",\n \"Wanted\"\n ],\n \"default\": \"\",\n \"prefill\": \"\"\n },\n \"advertiserType\": {\n \"title\": \"Seller type\",\n \"type\": \"string\",\n \"description\": \"Filter by private sellers or companies.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"0\",\n \"1\"\n ],\n \"enumTitles\": [\n \"All sellers\",\n \"Private\",\n \"Company\"\n ],\n \"default\": \"\",\n \"prefill\": \"\"\n },\n \"condition\": {\n \"title\": \"Condition\",\n \"type\": \"string\",\n \"description\": \"Item condition filter (most useful for goods and electronics).\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"10\",\n \"20\",\n \"30\",\n \"40\",\n \"50\"\n ],\n \"enumTitles\": [\n \"All conditions\",\n \"New\",\n \"Like new\",\n \"Excellent\",\n \"Good\",\n \"Damaged\"\n ],\n \"default\": \"\",\n \"prefill\": \"\"\n },\n \"shippableOnly\": {\n \"title\": \"Shippable only\",\n \"type\": \"boolean\",\n \"description\": \"Only listings that offer shipping.\",\n \"default\": false,\n \"prefill\": false\n },\n \"titleOnly\": {\n \"title\": \"Search titles only\",\n \"type\": \"boolean\",\n \"description\": \"Match the keyword against listing titles instead of title and description.\",\n \"default\": false,\n \"prefill\": false\n },\n \"urgentOnly\": {\n \"title\": \"Urgent only\",\n \"type\": \"boolean\",\n \"description\": \"Only listings marked urgent (mainly job ads).\",\n \"default\": false,\n \"prefill\": false\n },\n \"startUrls\": {\n \"title\": \"Listing or search URLs\",\n \"type\": \"array\",\n \"description\": \"(mode=searchByUrls) Subito.it ad URLs (...-123456789.htm) and/or search-result URLs (/annunci-lazio/vendita/auto/?q=bmw).\",\n \"editor\": \"requestListSources\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"url\": {\n \"type\": \"string\",\n \"title\": \"URL\",\n \"description\": \"Subito.it listing or search-result URL.\"\n }\n },\n \"required\": [\n \"url\"\n ]\n }\n },\n \"maxItems\": {\n \"title\": \"Max items\",\n \"type\": \"integer\",\n \"description\": \"Maximum number of listings to return (1–10,000).\",\n \"minimum\": 1,\n \"maximum\": 10000,\n \"default\": 20,\n \"prefill\": 3\n }\n },\n \"required\": [\n \"mode\"\n ]\n}", "readme": "# Subito.it Classifieds Search & Price Extractor\n\nSubito.it is Italy's largest classifieds marketplace, with millions of ads spanning cars, electronics, property, jobs and everyday second-hand goods. This actor searches Subito.it and returns one structured record per listing — price, full description, condition, location, seller, every photo, and the category-specific details buyers actually compare (km, year and fuel for cars; surface, rooms and energy class for property; sector and contract for jobs).\n\n## What this actor does\n\n- Searches all of Subito.it or narrows to cars, electronics, real estate, jobs, or general items for sale.\n- Filters by any of the 45 Subito.it categories, all 20 Italian regions, price range, ad type, private/company seller, condition, shipping availability, title-only matching, and urgent-only ads.\n- Sorts by relevance, newest, or price ascending/descending.\n- Paginates up to 10,000 listings per query slice.\n- Scrapes specific ad URLs and search-result URLs directly.\n- Returns full descriptions and all image URLs without extra detail-page requests.\n- Exposes every upstream listing feature through typed fields plus a generic `attributes` map, so niche categories are covered too.\n\n## Modes\n\n| Mode | What it searches |\n|---|---|\n| `searchAll` | Every category. Combine with `category` to target any of the 45 categories. |\n| `searchItems` | General items for sale across all categories. |\n| `searchCars` | Cars and vehicles (category `Auto`). |\n| `searchElectronics` | The whole electronics tree (phones, computers, audio/video, gaming, cameras). |\n| `searchRealEstate` | The whole property tree (apartments, villas, rooms, land, garages, holiday homes, offices). |\n| `searchJobs` | Job offers. |\n| `searchByUrls` | Specific Subito.it ad URLs and/or search-result URLs from `startUrls`. |\n\n## Output per listing\n\n| Field | Description |\n|---|---|\n| `adId` | Numeric Subito.it ad ID. |\n| `title` | Listing title. |\n| `description` | Full ad text. |\n| `adType` / `adTypeKey` | Listing kind, e.g. `In vendita` / `s`, `In affitto` / `u`. |\n| `price` | Numeric price in EUR, when the ad publishes one. |\n| `priceText` | Price exactly as displayed, e.g. `600 €`. |\n| `currency` | `EUR` when a price exists. |\n| `condition` | Item/vehicle/building condition as labelled by Subito.it. |\n| `category`, `categoryId`, `categorySlug`, `macroCategoryId` | Category hierarchy. |\n| `publishedDate`, `publishedAt`, `expiresAt` | Display date, ISO publish timestamp, ISO expiry. |\n| `city`, `province`, `region`, `regionId`, `regionSlug`, `location` | Location hierarchy. |\n| `seller`, `sellerType`, `sellerId`, `shopId`, `shopName`, `isCompany` | Seller/shop metadata (`private` or `professional`). |\n| `imageUrl`, `imageUrls`, `imageCount` | First photo, all photos, count. |\n| `adUrl` | Canonical listing URL. |\n| `attributes` | Every upstream feature label/value for the listing. |\n| `shippable`, `shippingCost`, `shippingMethod`, `shippingCarriers` | Shipping details when offered. |\n| `brand`, `model`, `year`, `mileageKm`, `fuel`, `gearbox`, `powerKw`, `powerHp`, `color`, `doors`, `seats`, `bodyType`, `pollutionClass`, `vehicleType`, `motoType`, `shipType`, `caravanType`, `bicycleType` | Vehicle fields when present. |\n| `surfaceSqm`, `rooms`, `bathrooms`, `floor`, `totalFloors`, `furnished`, `elevator`, `balcony`, `garden`, `parking`, `heating`, `airConditioning`, `energyClass`, `buildingCondition`, `availableNow`, `holidayRental`, `lastFloor`, `reception`, `multiLevel`, `noAgency`, `roomType`, `officeType` | Property fields when present. |\n| `jobSector`, `contractType`, `workHours`, `workLevel`, `educationLevel` | Job fields when present. |\n| `urgent`, `availability`, `warrantyMonths`, `referenceCode`, `cin`, `size`, `registrationDate` | Other upstream flags and codes, when present. |\n| `mode`, `scrapedAt` | Which mode produced the record and when it was fetched. |\n\nFields the source does not publish for a listing (for example a give-away with no price, or a private seller who hides their name) are omitted from that record — never filled with placeholders.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | Select | `searchItems` | Search scope; see the modes table. |\n| `query` | String | – | Keyword. The prefill uses `iPhone`; leave empty to browse a category without a keyword. Ignored in `searchByUrls`. |\n| `category` | Select | all | Any of the 45 Subito.it categories; overrides the mode's category. |\n| `region` | Select | all Italy | One of the 20 Italian regions. |\n| `priceMin`, `priceMax` | Integer | – | Price range in EUR. |\n| `sort` | Select | `relevance` | Relevance, newest first, price low→high, price high→low. |\n| `adType` | Select | all | For sale, for rent, give away, holiday rental, wanted. |\n| `advertiserType` | Select | all | Private sellers or companies. |\n| `condition` | Select | all | New, like new, excellent, good, damaged. |\n| `shippableOnly` | Boolean | `false` | Only ads offering shipping. |\n| `titleOnly` | Boolean | `false` | Match the keyword in titles only. |\n| `urgentOnly` | Boolean | `false` | Only urgent ads (mainly jobs). |\n| `startUrls` | Array | – | `(mode=searchByUrls)` Ad URLs (`...-123456789.htm`) and/or search URLs (`/annunci-lazio/vendita/auto/?q=bmw`). |\n| `maxItems` | Integer | `20` | Maximum records to return (1–10,000). |\n\n### Example: cars in Lombardy under €20,000\n\n```json\n{\n \"mode\": \"searchCars\",\n \"query\": \"BMW\",\n \"region\": \"lombardia\",\n \"priceMin\": 5000,\n \"priceMax\": 20000,\n \"sort\": \"priceasc\",\n \"maxItems\": 50\n}\n```\n\n### Example: shippable like-new electronics\n\n```json\n{\n \"mode\": \"searchElectronics\",\n \"query\": \"laptop\",\n \"condition\": \"20\",\n \"shippableOnly\": true,\n \"maxItems\": 100\n}\n```\n\n### Example: apartments for rent in Lazio\n\n```json\n{\n \"mode\": \"searchRealEstate\",\n \"query\": \"trilocale\",\n \"region\": \"lazio\",\n \"adType\": \"u\",\n \"maxItems\": 50\n}\n```\n\n### Example: specific ads and a saved search\n\n```json\n{\n \"mode\": \"searchByUrls\",\n \"startUrls\": [\n { \"url\": \"https://www.subito.it/telefonia/iphone-16-256-gb-udine-667511057.htm\" },\n { \"url\": \"https://www.subito.it/annunci-lazio/vendita/auto/?q=bmw&ps=5000&pe=20000\" }\n ],\n \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **Price monitoring** — track a model or keyword and compare asking prices over time.\n- **Reseller sourcing** — find private-seller cars or electronics below a threshold.\n- **Market research** — measure listing volume and price bands by category and region.\n- **Property and job boards** — pull structured listings into a sheet, CRM, or dashboard.\n- **Deal alerts** — run frequently on `datedesc` and watch new ads for your saved searches.\n\n## FAQ\n\n**Do I need a Subito.it account?**\nNo. The actor reads public listings and needs no login, cookies, or API key.\n\n**Do I need to configure a proxy?**\nNo. The actor picks its network route automatically.\n\n**How many listings can I get in one run?**\nUp to 10,000 per query slice. Subito.it stops serving results beyond 10,000 per search, so split broad searches by category, region, price band, or sort order to reach more.\n\n**Why is `price` missing on some records?**\nSome ads are give-aways, swaps, or \"price on request\". Subito.it publishes no price for them, so the field is omitted.\n\n**Why are there no latitude/longitude fields?**\nSubito.it does not publish coordinates in its public listing data. Use `city`, `province`, and `region` for location analysis.\n\n**Why is `seller` empty for some ads?**\nPrivate users can hide their name. Company sellers usually expose a shop name, which the actor returns.\n\n**Does URL mode work with expired ads?**\nExpired or removed ads are skipped; the run continues with the remaining URLs and reports how many were unavailable.\n\n**Are all Subito.it categories covered?**\nYes — the `category` dropdown contains the full 45-entry taxonomy, from `Auto` to `Collezionismo`, plus property, job, and service categories.\n\n**Is this affiliated with Subito.it?**\nNo. This is an independent tool that reads publicly available listings and is not affiliated with or endorsed by Subito.it.\n", "actorDefinition": { "actorSpecification": 1, "name": "subito-it-classifieds-search-and-price-extractor", "title": "Subito.it Classifieds Search & Price Extractor", "description": "Search Subito.it classifieds for cars, electronics, property, jobs, or general items by keyword, Italian region, and price range, and get price, condition, location, seller, images, and category-specific details for each result.", "version": "1.0", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# Subito.it Classifieds Search & Price Extractor\n\nSubito.it is Italy's largest classifieds marketplace, with millions of ads spanning cars, electronics, property, jobs and everyday second-hand goods. This actor searches Subito.it and returns one structured record per listing — price, full description, condition, location, seller, every photo, and the category-specific details buyers actually compare (km, year and fuel for cars; surface, rooms and energy class for property; sector and contract for jobs).\n\n## What this actor does\n\n- Searches all of Subito.it or narrows to cars, electronics, real estate, jobs, or general items for sale.\n- Filters by any of the 45 Subito.it categories, all 20 Italian regions, price range, ad type, private/company seller, condition, shipping availability, title-only matching, and urgent-only ads.\n- Sorts by relevance, newest, or price ascending/descending.\n- Paginates up to 10,000 listings per query slice.\n- Scrapes specific ad URLs and search-result URLs directly.\n- Returns full descriptions and all image URLs without extra detail-page requests.\n- Exposes every upstream listing feature through typed fields plus a generic `attributes` map, so niche categories are covered too.\n\n## Modes\n\n| Mode | What it searches |\n|---|---|\n| `searchAll` | Every category. Combine with `category` to target any of the 45 categories. |\n| `searchItems` | General items for sale across all categories. |\n| `searchCars` | Cars and vehicles (category `Auto`). |\n| `searchElectronics` | The whole electronics tree (phones, computers, audio/video, gaming, cameras). |\n| `searchRealEstate` | The whole property tree (apartments, villas, rooms, land, garages, holiday homes, offices). |\n| `searchJobs` | Job offers. |\n| `searchByUrls` | Specific Subito.it ad URLs and/or search-result URLs from `startUrls`. |\n\n## Output per listing\n\n| Field | Description |\n|---|---|\n| `adId` | Numeric Subito.it ad ID. |\n| `title` | Listing title. |\n| `description` | Full ad text. |\n| `adType` / `adTypeKey` | Listing kind, e.g. `In vendita` / `s`, `In affitto` / `u`. |\n| `price` | Numeric price in EUR, when the ad publishes one. |\n| `priceText` | Price exactly as displayed, e.g. `600 €`. |\n| `currency` | `EUR` when a price exists. |\n| `condition` | Item/vehicle/building condition as labelled by Subito.it. |\n| `category`, `categoryId`, `categorySlug`, `macroCategoryId` | Category hierarchy. |\n| `publishedDate`, `publishedAt`, `expiresAt` | Display date, ISO publish timestamp, ISO expiry. |\n| `city`, `province`, `region`, `regionId`, `regionSlug`, `location` | Location hierarchy. |\n| `seller`, `sellerType`, `sellerId`, `shopId`, `shopName`, `isCompany` | Seller/shop metadata (`private` or `professional`). |\n| `imageUrl`, `imageUrls`, `imageCount` | First photo, all photos, count. |\n| `adUrl` | Canonical listing URL. |\n| `attributes` | Every upstream feature label/value for the listing. |\n| `shippable`, `shippingCost`, `shippingMethod`, `shippingCarriers` | Shipping details when offered. |\n| `brand`, `model`, `year`, `mileageKm`, `fuel`, `gearbox`, `powerKw`, `powerHp`, `color`, `doors`, `seats`, `bodyType`, `pollutionClass`, `vehicleType`, `motoType`, `shipType`, `caravanType`, `bicycleType` | Vehicle fields when present. |\n| `surfaceSqm`, `rooms`, `bathrooms`, `floor`, `totalFloors`, `furnished`, `elevator`, `balcony`, `garden`, `parking`, `heating`, `airConditioning`, `energyClass`, `buildingCondition`, `availableNow`, `holidayRental`, `lastFloor`, `reception`, `multiLevel`, `noAgency`, `roomType`, `officeType` | Property fields when present. |\n| `jobSector`, `contractType`, `workHours`, `workLevel`, `educationLevel` | Job fields when present. |\n| `urgent`, `availability`, `warrantyMonths`, `referenceCode`, `cin`, `size`, `registrationDate` | Other upstream flags and codes, when present. |\n| `mode`, `scrapedAt` | Which mode produced the record and when it was fetched. |\n\nFields the source does not publish for a listing (for example a give-away with no price, or a private seller who hides their name) are omitted from that record — never filled with placeholders.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | Select | `searchItems` | Search scope; see the modes table. |\n| `query` | String | – | Keyword. The prefill uses `iPhone`; leave empty to browse a category without a keyword. Ignored in `searchByUrls`. |\n| `category` | Select | all | Any of the 45 Subito.it categories; overrides the mode's category. |\n| `region` | Select | all Italy | One of the 20 Italian regions. |\n| `priceMin`, `priceMax` | Integer | – | Price range in EUR. |\n| `sort` | Select | `relevance` | Relevance, newest first, price low→high, price high→low. |\n| `adType` | Select | all | For sale, for rent, give away, holiday rental, wanted. |\n| `advertiserType` | Select | all | Private sellers or companies. |\n| `condition` | Select | all | New, like new, excellent, good, damaged. |\n| `shippableOnly` | Boolean | `false` | Only ads offering shipping. |\n| `titleOnly` | Boolean | `false` | Match the keyword in titles only. |\n| `urgentOnly` | Boolean | `false` | Only urgent ads (mainly jobs). |\n| `startUrls` | Array | – | `(mode=searchByUrls)` Ad URLs (`...-123456789.htm`) and/or search URLs (`/annunci-lazio/vendita/auto/?q=bmw`). |\n| `maxItems` | Integer | `20` | Maximum records to return (1–10,000). |\n\n### Example: cars in Lombardy under €20,000\n\n```json\n{\n \"mode\": \"searchCars\",\n \"query\": \"BMW\",\n \"region\": \"lombardia\",\n \"priceMin\": 5000,\n \"priceMax\": 20000,\n \"sort\": \"priceasc\",\n \"maxItems\": 50\n}\n```\n\n### Example: shippable like-new electronics\n\n```json\n{\n \"mode\": \"searchElectronics\",\n \"query\": \"laptop\",\n \"condition\": \"20\",\n \"shippableOnly\": true,\n \"maxItems\": 100\n}\n```\n\n### Example: apartments for rent in Lazio\n\n```json\n{\n \"mode\": \"searchRealEstate\",\n \"query\": \"trilocale\",\n \"region\": \"lazio\",\n \"adType\": \"u\",\n \"maxItems\": 50\n}\n```\n\n### Example: specific ads and a saved search\n\n```json\n{\n \"mode\": \"searchByUrls\",\n \"startUrls\": [\n { \"url\": \"https://www.subito.it/telefonia/iphone-16-256-gb-udine-667511057.htm\" },\n { \"url\": \"https://www.subito.it/annunci-lazio/vendita/auto/?q=bmw&ps=5000&pe=20000\" }\n ],\n \"maxItems\": 30\n}\n```\n\n## Use cases\n\n- **Price monitoring** — track a model or keyword and compare asking prices over time.\n- **Reseller sourcing** — find private-seller cars or electronics below a threshold.\n- **Market research** — measure listing volume and price bands by category and region.\n- **Property and job boards** — pull structured listings into a sheet, CRM, or dashboard.\n- **Deal alerts** — run frequently on `datedesc` and watch new ads for your saved searches.\n\n## FAQ\n\n**Do I need a Subito.it account?**\nNo. The actor reads public listings and needs no login, cookies, or API key.\n\n**Do I need to configure a proxy?**\nNo. The actor picks its network route automatically.\n\n**How many listings can I get in one run?**\nUp to 10,000 per query slice. Subito.it stops serving results beyond 10,000 per search, so split broad searches by category, region, price band, or sort order to reach more.\n\n**Why is `price` missing on some records?**\nSome ads are give-aways, swaps, or \"price on request\". Subito.it publishes no price for them, so the field is omitted.\n\n**Why are there no latitude/longitude fields?**\nSubito.it does not publish coordinates in its public listing data. Use `city`, `province`, and `region` for location analysis.\n\n**Why is `seller` empty for some ads?**\nPrivate users can hide their name. Company sellers usually expose a shop name, which the actor returns.\n\n**Does URL mode work with expired ads?**\nExpired or removed ads are skipped; the run continues with the remaining URLs and reports how many were unavailable.\n\n**Are all Subito.it categories covered?**\nYes — the `category` dropdown contains the full 45-entry taxonomy, from `Auto` to `Collezionismo`, plus property, job, and service categories.\n\n**Is this affiliated with Subito.it?**\nNo. This is an independent tool that reads publicly available listings and is not affiliated with or endorsed by Subito.it.\n", "input": { "title": "Subito.it Scraper Input", "description": "Search Subito.it — Italy's largest classifieds marketplace — for items, cars, electronics, property, jobs, or scrape specific listing URLs.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Mode", "type": "string", "description": "What to fetch from Subito.it. searchByUrls takes listing or search-result URLs in startUrls.", "editor": "select", "enum": [ "searchAll", "searchItems", "searchCars", "searchElectronics", "searchRealEstate", "searchJobs", "searchByUrls" ], "enumTitles": [ "Search all categories", "Search general items for sale", "Search cars & vehicles", "Search electronics", "Search real estate", "Search jobs", "Scrape listing or search URLs" ], "default": "searchItems", "prefill": "searchItems" }, "query": { "title": "Search query", "type": "string", "description": "Keyword to search for, e.g. iPhone, divano, BMW. Leave empty to browse a category without a keyword. Ignored in searchByUrls mode.", "editor": "textfield", "prefill": "iPhone" }, "category": { "title": "Category", "type": "string", "description": "Optional category filter. Overrides the category implied by the mode.", "editor": "select", "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": [ "All categories", "MOTORI", "Auto", "Accessori Auto", "Moto e Scooter", "Accessori Moto", "Nautica", "Caravan e Camper", "Veicoli commerciali", "IMMOBILI", "Appartamenti", "Camere/Posti letto", "Ville singole e a schiera", "Terreni e rustici", "Garage e box", "Loft, mansarde e altro", "Case vacanza", "Uffici e Locali commerciali", "LAVORO E SERVIZI", "Offerte di lavoro", "Servizi", "Candidati in cerca di lavoro", "Attrezzature di lavoro", "ELETTRONICA", "Informatica", "Console e Videogiochi", "Audio/Video", "Fotografia", "Telefonia", "PER LA CASA e LA PERSONA", "Arredamento e Casalinghi", "Elettrodomestici", "Giardino e Fai da te", "Abbigliamento e Accessori", "Tutto per i bambini", "SPORTS E HOBBY", "Animali", "Accessori per animali", "Musica e Film", "Libri e Riviste", "Strumenti Musicali", "Sports", "Biciclette", "Collezionismo", "ALTRI ANNUNCI", "Altri" ], "default": "", "prefill": "" }, "region": { "title": "Region", "type": "string", "description": "Italian region to filter by (friendly name). Leave empty to search all of Italy.", "editor": "select", "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": [ "All Italy", "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" ], "default": "", "prefill": "" }, "priceMin": { "title": "Min price (EUR)", "type": "integer", "description": "Minimum listing price in Euro.", "minimum": 0, "maximum": 100000000 }, "priceMax": { "title": "Max price (EUR)", "type": "integer", "description": "Maximum listing price in Euro.", "minimum": 0, "maximum": 100000000 }, "sort": { "title": "Sort by", "type": "string", "description": "Result ordering.", "editor": "select", "enum": [ "relevance", "datedesc", "priceasc", "pricedesc" ], "enumTitles": [ "Relevance", "Newest first", "Price: low to high", "Price: high to low" ], "default": "relevance", "prefill": "relevance" }, "adType": { "title": "Ad type", "type": "string", "description": "Filter by listing kind: for sale, for rent, give away, holiday rental or wanted.", "editor": "select", "enum": [ "", "s", "u", "g", "h", "k" ], "enumTitles": [ "All ad types", "For sale", "For rent", "Give away", "Holiday rental", "Wanted" ], "default": "", "prefill": "" }, "advertiserType": { "title": "Seller type", "type": "string", "description": "Filter by private sellers or companies.", "editor": "select", "enum": [ "", "0", "1" ], "enumTitles": [ "All sellers", "Private", "Company" ], "default": "", "prefill": "" }, "condition": { "title": "Condition", "type": "string", "description": "Item condition filter (most useful for goods and electronics).", "editor": "select", "enum": [ "", "10", "20", "30", "40", "50" ], "enumTitles": [ "All conditions", "New", "Like new", "Excellent", "Good", "Damaged" ], "default": "", "prefill": "" }, "shippableOnly": { "title": "Shippable only", "type": "boolean", "description": "Only listings that offer shipping.", "default": false, "prefill": false }, "titleOnly": { "title": "Search titles only", "type": "boolean", "description": "Match the keyword against listing titles instead of title and description.", "default": false, "prefill": false }, "urgentOnly": { "title": "Urgent only", "type": "boolean", "description": "Only listings marked urgent (mainly job ads).", "default": false, "prefill": false }, "startUrls": { "title": "Listing or search URLs", "type": "array", "description": "(mode=searchByUrls) Subito.it ad URLs (...-123456789.htm) and/or search-result URLs (/annunci-lazio/vendita/auto/?q=bmw).", "editor": "requestListSources", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "Subito.it listing or search-result URL." } }, "required": [ "url" ] } }, "maxItems": { "title": "Max items", "type": "integer", "description": "Maximum number of listings to return (1–10,000).", "minimum": 1, "maximum": 10000, "default": 20, "prefill": 3 } }, "required": [ "mode" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "Subito.it Classifieds Search & Price Extractor Output", "description": "Subito.it classified listings with title, price, description, condition, category, location, seller, images and category-specific attributes.", "properties": { "listings": { "type": "string", "title": "Subito.it listings", "description": "Dataset containing all scraped Subito.it listings.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "Subito.it Listings", "transformation": { "fields": [ "title", "price", "priceText", "condition", "location", "category", "sellerType", "adUrl" ] }, "display": { "component": "table", "properties": {} } } } } }, "environmentVariables": {} }, "buildNumber": "1.0.2", "imageDigest": "155ba42121b5e5cb1ae13e184e9567aaa113010555c361421f2b5c3b8c646049", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.014236666666666667 } } }