Subito.it Scraper: auto, immobili (search, filters, alerts)

A Subito.it scraper for Italy's largest classifieds site: search subito.it by keyword, category, region and price — auto, moto, immobili, elettronica, biciclette, everything in annunci usato — and get each ad as one flat row. Monitor mode on a saved Task returns only the ads that are new or changed price since your last run, with an optional webhook or Telegram summary.

What you get — example output

One row per advertisement. Real values from the example dataset (query bici):

Field	Example value	What it is
id	subito-659437990	Stable row key (subito- + Subito ad id)
title	dedacciai temerario	Advertisement headline
price / priceLabel	500 / 500 €	Numeric price in euros and the label Subito prints
condition	Ottimo - poco usato e ben conservato	Condition exactly as the seller selected it
city / district / region	Alzate Brianza / Como / Lombardia	Comune, provincia and regione (lat 45.767095, lon 9.181678)
categoryPath	Biciclette	Category the ad sits in (categoryId 41)
sellerType	private	private or business — separate dealers from individuals
deliveryAvailable	true	Whether the seller ships (params.item_shipping_cost = 20 €)
params	{"item_condition": "Ottimo …", "bicycle_type": "Corsa"}	Every Subito attribute: mileage, year, rooms, size, shipping …

Full field list: id, url, platform, country, title, description, price, currency, priceLabel, priceType, categoryId, categoryPath, macroCategoryId, adType (In vendita / Cerco), condition, city, district, region, lat, lon, images[], sellerId, sellerName, sellerType, createdAt, validTo, deliveryAvailable, params{}, query, rank, source, scrapedAt.

Use cases

• Car and bike dealers: follow a make/model in one region and see every new ad and price cut the day it happens.
• Price research: pull a whole category with price, condition and attributes to benchmark what things actually fetch in Italy.
• Resale hunting: watch a keyword with a price ceiling and get alerted before the item is gone.

How it works

The actor calls Subito's own public search API, so each ad arrives as structured data with coordinates and attributes rather than HTML. Subito sits behind Akamai, so requests go out through Apify's residential proxy; you do not configure anything, but Apify bills that traffic on top (about 0.1 MB per page of 30 ads). Each query is paginated separately, 30 ads per page, up to maxPages or maxItems. In monitor mode the run is compared against the previous run of the same Task and only new or re-priced ads are pushed.

Input

Field	Meaning	Default
queries	Free-text searches, e.g. ["bici"]; each is paginated separately	["bici"]
categoryId	Subito numeric category key (c= in its filter URLs), e.g. 41 Biciclette, 2 Auto	—
regionId	Subito numeric region key (r=), e.g. 9 Lombardia	—
priceFrom / priceTo	Price range in whole euros, e.g. 100 / 1500	—
shippableOnly	Keep only ads the seller ships	false
sortBy	datedesc, priceasc, pricedesc, relevance	datedesc
maxPages	Pages per query, 30 ads each	5
maxItems	Stop after this many ads	20
mode	scrape, or monitor for new/changed only	scrape
webhookUrl, telegramBotToken, telegramChatId	Where monitor-mode change summaries are sent	—

Pricing

Event	Price
result	$0.001 per listing ($1 per 1,000)
monitor-check	$0.005 per monitor run
change	$0.001 per new/changed listing

Charged only for listings actually pushed — an empty run costs you nothing. Subito sits behind Akamai, so the actor uses residential proxy (Apify bills that traffic on top; ~0.1 MB per page of 30 listings).

Why this actor

• Every Subito vertical from one input: auto, moto, immobili, elettronica, arredamento, biciclette.
• Comune, provincia, regione and coordinates on every search row, so rows map without geocoding.
• Shipping fields kept (deliveryAvailable, shipping type and cost), which matters when you buy remotely.
• Monitor mode with new-ad and price-drop alerts, delivered by webhook or Telegram.
• Akamai handling is built in — no proxy setup, no cookies, no Subito account.

Limits

• Listing detail pages are not opened: seller phone and full photo sets are not included.
• Category / region keys are Subito's numeric ids (visible in the site's filter URLs as c= and r=).
• Residential traffic is billed by Apify on top of the per-result price.

FAQ

Can I monitor new listings for a search? Yes. Save the input as a Task, set mode: monitor and schedule it — each run returns only ads that appeared or changed price since the previous run, and can POST a summary to webhookUrl or a Telegram chat.

Can I scrape only one region or province? Set regionId to the Subito region key from the site's own filter URL (r=); every row also carries city, district (provincia) and region, so you can filter further downstream.

Do I need a Subito account or my own proxy? No. The actor talks to Subito's public search API and routes through Apify's residential proxy automatically.

Changelog

• 0.1: initial release — search, filters, monitor mode.

---

If this actor saved you time, please leave a review on its Store page — it is the main way other buyers find it. Bug reports and field requests are welcome in the Issues tab.