Subito.it Classifieds Search & Price Extractor

Subito.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).

What this actor does

• Searches all of Subito.it or narrows to cars, electronics, real estate, jobs, or general items for sale.
• 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.
• Sorts by relevance, newest, or price ascending/descending.
• Paginates up to 10,000 listings per query slice.
• Scrapes specific ad URLs and search-result URLs directly.
• Returns full descriptions and all image URLs without extra detail-page requests.
• Exposes every upstream listing feature through typed fields plus a generic attributes map, so niche categories are covered too.

Modes

Mode	What it searches
searchAll	Every category. Combine with category to target any of the 45 categories.
searchItems	General items for sale across all categories.
searchCars	Cars and vehicles (category Auto).
searchElectronics	The whole electronics tree (phones, computers, audio/video, gaming, cameras).
searchRealEstate	The whole property tree (apartments, villas, rooms, land, garages, holiday homes, offices).
searchJobs	Job offers.
searchByUrls	Specific Subito.it ad URLs and/or search-result URLs from startUrls.

Output per listing

Field	Description
adId	Numeric Subito.it ad ID.
title	Listing title.
description	Full ad text.
adType / adTypeKey	Listing kind, e.g. In vendita / s, In affitto / u.
price	Numeric price in EUR, when the ad publishes one.
priceText	Price exactly as displayed, e.g. 600 €.
currency	EUR when a price exists.
condition	Item/vehicle/building condition as labelled by Subito.it.
category, categoryId, categorySlug, macroCategoryId	Category hierarchy.
publishedDate, publishedAt, expiresAt	Display date, ISO publish timestamp, ISO expiry.
city, province, region, regionId, regionSlug, location	Location hierarchy.
seller, sellerType, sellerId, shopId, shopName, isCompany	Seller/shop metadata (private or professional).
imageUrl, imageUrls, imageCount	First photo, all photos, count.
adUrl	Canonical listing URL.
attributes	Every upstream feature label/value for the listing.
shippable, shippingCost, shippingMethod, shippingCarriers	Shipping details when offered.
brand, model, year, mileageKm, fuel, gearbox, powerKw, powerHp, color, doors, seats, bodyType, pollutionClass, vehicleType, motoType, shipType, caravanType, bicycleType	Vehicle fields when present.
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.
jobSector, contractType, workHours, workLevel, educationLevel	Job fields when present.
urgent, availability, warrantyMonths, referenceCode, cin, size, registrationDate	Other upstream flags and codes, when present.
mode, scrapedAt	Which mode produced the record and when it was fetched.

Fields 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.

Input

Field	Type	Default	Description
mode	Select	searchItems	Search scope; see the modes table.
query	String	–	Keyword. The prefill uses iPhone; leave empty to browse a category without a keyword. Ignored in searchByUrls.
category	Select	all	Any of the 45 Subito.it categories; overrides the mode's category.
region	Select	all Italy	One of the 20 Italian regions.
priceMin, priceMax	Integer	–	Price range in EUR.
sort	Select	relevance	Relevance, newest first, price low→high, price high→low.
adType	Select	all	For sale, for rent, give away, holiday rental, wanted.
advertiserType	Select	all	Private sellers or companies.
condition	Select	all	New, like new, excellent, good, damaged.
shippableOnly	Boolean	false	Only ads offering shipping.
titleOnly	Boolean	false	Match the keyword in titles only.
urgentOnly	Boolean	false	Only urgent ads (mainly jobs).
startUrls	Array	–	(mode=searchByUrls) Ad URLs (...-123456789.htm) and/or search URLs (/annunci-lazio/vendita/auto/?q=bmw).
maxItems	Integer	20	Maximum records to return (1–10,000).

Example: cars in Lombardy under €20,000

{
    "mode": "searchCars",
    "query": "BMW",
    "region": "lombardia",
    "priceMin": 5000,
    "priceMax": 20000,
    "sort": "priceasc",
    "maxItems": 50
}

Example: shippable like-new electronics

{
    "mode": "searchElectronics",
    "query": "laptop",
    "condition": "20",
    "shippableOnly": true,
    "maxItems": 100
}

Example: apartments for rent in Lazio

{
    "mode": "searchRealEstate",
    "query": "trilocale",
    "region": "lazio",
    "adType": "u",
    "maxItems": 50
}

Example: specific ads and a saved search

{
    "mode": "searchByUrls",
    "startUrls": [
        { "url": "https://www.subito.it/telefonia/iphone-16-256-gb-udine-667511057.htm" },
        { "url": "https://www.subito.it/annunci-lazio/vendita/auto/?q=bmw&ps=5000&pe=20000" }
    ],
    "maxItems": 30
}

Use cases

• Price monitoring — track a model or keyword and compare asking prices over time.
• Reseller sourcing — find private-seller cars or electronics below a threshold.
• Market research — measure listing volume and price bands by category and region.
• Property and job boards — pull structured listings into a sheet, CRM, or dashboard.
• Deal alerts — run frequently on datedesc and watch new ads for your saved searches.

FAQ

Do I need a Subito.it account? No. The actor reads public listings and needs no login, cookies, or API key.

Do I need to configure a proxy? No. The actor picks its network route automatically.

How many listings can I get in one run? Up 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.

Why is price missing on some records? Some ads are give-aways, swaps, or "price on request". Subito.it publishes no price for them, so the field is omitted.

Why are there no latitude/longitude fields? Subito.it does not publish coordinates in its public listing data. Use city, province, and region for location analysis.

Why is seller empty for some ads? Private users can hide their name. Company sellers usually expose a shop name, which the actor returns.

Does URL mode work with expired ads? Expired or removed ads are skipped; the run continues with the remaining URLs and reports how many were unavailable.

Are all Subito.it categories covered? Yes — the category dropdown contains the full 45-entry taxonomy, from Auto to Collezionismo, plus property, job, and service categories.

Is this affiliated with Subito.it? No. This is an independent tool that reads publicly available listings and is not affiliated with or endorsed by Subito.it.