# Subito.it Scraper: Property, Cars and All Listings with Prices (`themineworks/subito-scraper`) Actor

Scrape Subito.it by keyword or search link: one row per listing with price, region, province, town, private or business seller, agency or dealer name, full description and photos, plus size, rooms and energy class for property and make, model, mileage, year and fuel for cars. No login.

- **URL**: https://apify.com/themineworks/subito-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Real estate, E-commerce, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.62 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Subito.it Scraper: Property, Cars and All Listings with Prices

[![30 Subito.it apartment listings with price, size, rooms and agency in 2 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/subito-scraper-hero.png)](https://console.apify.com/actors/JsFMU4Hbqeabp2ZWs/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Subito.it listings by keyword or search link, one row per listing with price, region, province, town, private or business seller, agency or dealer name, full description and every photo, plus size, rooms and energy class for property and make, model, mileage, year, fuel and power for cars and motorbikes. No login, no cookies, no API key. You pay $2.25 per 1,000 listings on the Free plan and $1.62 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

From **The Mine Works**, with over 335,000 runs across 330+ public actors.

**Part of The Mine Works Real estate family:** [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [99acres Scraper](https://apify.com/themineworks/99acres-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [MagicBricks Scraper](https://apify.com/themineworks/magicbricks-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

Updated 12 Nov 2026: first release. Keywords with category, region, province, sale or rent, price range, private or business sellers and sort; pasted Subito search links with every filter you set on the site; all categories in one actor (Immobili, Motori, Market, Lavoro). Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **One actor for every Subito category.** Apartments, houses, rooms, garages, cars, motorbikes, vans, campers, boats, phones, furniture, jobs. Rivals sell property and cars as separate actors; here a property search and a car search go in the same run.
- **The fields a buyer compares, in columns.** Property rows carry `size_sqm`, `price_per_sqm_eur`, `rooms`, `bathrooms`, `floor`, `energy_class`, `heating`, `furnished`, `elevator`. Vehicle rows carry `make`, `model`, `version`, `mileage_km`, `registration_year`, `fuel`, `gearbox`, `power_kw`, `power_hp`, `emission_class`. Every other feature Subito lists is kept in `features`.
- **Private or business, with the agency or dealer name.** `seller_type` says private or business on every row; `shop_name` names the agency, dealership or shop. Filter on Subito's side with `sellerType` so you only pay for the rows you want.
- **Search from the form or paste a link.** Type keywords and pick category, region or province, sale or rent, price range and sort, or paste any Subito results link with filters you set on the site (town, rooms, make, mileage).
- **Pay per listing, nothing for errors.** Listings found twice in one run, error rows and the summary row are never charged.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/JsFMU4Hbqeabp2ZWs/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the newest 30 apartments for sale in Milano. It took 2 seconds in our test run on Apify:

```json
{
  "startUrls": ["https://www.subito.it/annunci-lombardia/vendita/appartamenti/milano/"],
  "maxItems": 30
}
```

Apify's free plan includes $5 of credit every month, which covers about 2,200 listings at this actor's price.

#### Copy to your AI assistant

```text
themineworks/subito-scraper on Apify. Reads Subito.it (Italy) search results and returns one flat row per listing, no login. Call ApifyClient("TOKEN").actor("themineworks/subito-scraper").call(run_input={"searchQueries": ["fiat panda"], "category": "auto", "province": "Roma", "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give searchQueries (keywords), startUrls (Subito links that start with https://www.subito.it/annunci-), or no keyword and a category with a region or province. Optional: category (Subito slug: usato for all, auto, moto-e-scooter, appartamenti, ville-singole-e-a-schiera, offerte-lavoro, telefonia and more), adType (vendita, affitto, affitto-vacanze, cerco, regalo), region (italia or a region slug), province (name or code, e.g. Milano, MI), minPrice, maxPrice, sellerType (all, private, business), sort (datedesc, relevance, priceasc, pricedesc), titleOnly, shippableOnly, maxItems (default 100, 1 to 5000, per search). Listing rows have no _type field and carry listing_id, title, url, price_eur, price_raw, ad_type, category, category_id, category_slug, region, province, province_code, town, town_istat, published_at, description, seller_type, seller_id, shop_id, shop_name, seller_name, condition, shippable, shipping_cost_eur, is_featured, is_urgent, cover_image, image_count, images, size_sqm, price_per_sqm_eur, rooms, bathrooms, floor, energy_class, heating, furnished, elevator, parking, no_agencies, make, model, version, mileage_km, registration_year, registration_date, fuel, gearbox, body_type, power_kw, power_hp, emission_class, dealer_ref, contract_type, job_sector, features, keyword, search_url, page, position, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when listings were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~subito-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
```

### Key features

- **Every category.** The category list is Subito's own: all categories, Motori (auto, moto e scooter, veicoli commerciali, caravan e camper, nautica, accessories), Immobili (appartamenti, ville, camere, terreni, garage, uffici e locali, case vacanza), Lavoro e servizi, Elettronica, Casa e persona, Sports e hobby.
- **Where.** All Italy, one of the 20 regions, or a province by name or code (Milano, MI, Monza, Pesaro e Urbino). For a single town or a radius, set it on Subito and paste the link.
- **Sale, rent, holiday rent, wanted, free.** `adType` maps to Subito's own sections.
- **Up to 5,000 listings per search.** Subito shows 30 listings a page; the actor reads page after page until your `maxItems` or the end of the results.
- **Dates in Italian time.** `published_at` is ISO 8601 with the Rome offset, so it sorts and converts cleanly.
- **Stops cleanly.** A refused page is retried on a new IP; six failed pages in a row end the run; the run stops before its time limit and keeps every row. The summary row says why a run delivered fewer rows than asked.

### How to use it

#### Cars from one province, private sellers only

```json
{
  "searchQueries": ["fiat panda", "volkswagen golf"],
  "category": "auto",
  "province": "Roma",
  "sellerType": "private",
  "maxPrice": 8000,
  "maxItems": 200
}
```

#### Every flat for rent in a province, no keyword

```json
{
  "category": "appartamenti",
  "adType": "affitto",
  "province": "Roma",
  "maxItems": 1000
}
```

#### Agencies and dealers as leads

```json
{
  "category": "appartamenti",
  "region": "lombardia",
  "sellerType": "business",
  "maxItems": 2000
}
```

Group the rows by `shop_id` to get each agency once with its listing count and price range.

#### Your own Subito search, filters and all

```json
{
  "startUrls": [
    "https://www.subito.it/annunci-lombardia/vendita/auto/milano/?advt=1&ps=10000&pe=20000",
    "https://www.subito.it/annunci-italia/vendita/usato/?q=iphone+13&shp=true"
  ],
  "maxItems": 500
}
```

#### Price tracking every morning

Save one of the inputs above as a task, schedule it daily with `sort` on `datedesc`, and compare `listing_id` and `price_eur` between runs to see new listings and price drops.

### Input parameters

| Field | Type | What it does |
|---|---|---|
| `startUrls` | array | Subito search links (they start with `https://www.subito.it/annunci-`). Each link is one search with all its filters. |
| `searchQueries` | array | Keywords, one search each, using the filters below. |
| `category` | string | Subito category slug, default `usato` (all categories). |
| `adType` | string | `vendita` (default), `affitto`, `affitto-vacanze`, `cerco`, `regalo`. |
| `region` | string | `italia` (default) or a region slug such as `lombardia`. |
| `province` | string | Province name or two letter code. The region is filled in for you. |
| `minPrice`, `maxPrice` | integer | Price range in euros. |
| `sellerType` | string | `all` (default), `private` or `business`. |
| `sort` | string | `datedesc` (default), `relevance`, `priceasc`, `pricedesc`. |
| `titleOnly` | boolean | Keyword in the title only. |
| `shippableOnly` | boolean | Only listings shipped with TuttoSubito. |
| `maxItems` | integer | Most listings per search, 1 to 5,000 (default 100). |
| `proxyConfiguration` | object | Apify datacenter proxy by default; residential is not needed. |

With no keyword, a category, region or province you pick is a search of its own, next to any links you paste.

### What data do you get?

| Group | Fields |
|---|---|
| Listing | `listing_id`, `title`, `url`, `ad_type`, `category`, `category_id`, `category_slug`, `published_at`, `description`, `condition`, `is_featured`, `is_urgent` |
| Price | `price_eur`, `price_raw`, `price_per_sqm_eur` (property), `shippable`, `shipping_cost_eur` |
| Place | `region`, `province`, `province_code`, `town`, `town_istat` |
| Seller | `seller_type` (private or business), `seller_id`, `shop_id`, `shop_name`, `seller_name`, `no_agencies` |
| Property | `size_sqm`, `rooms`, `bathrooms`, `floor`, `energy_class`, `heating`, `furnished`, `elevator`, `parking` |
| Vehicles | `make`, `model`, `version`, `mileage_km`, `registration_year`, `registration_date`, `fuel`, `gearbox`, `body_type`, `power_kw`, `power_hp`, `emission_class`, `dealer_ref` |
| Jobs | `contract_type`, `job_sector` |
| Photos | `cover_image`, `image_count`, `images` (every photo) |
| All features | `features`: every feature Subito lists, name to value |
| Run | `keyword`, `search_url`, `page`, `position`, `scraped_at` |

Fields that do not apply to a listing are left out of that row (a phone has no `mileage_km`).

#### Output example

A car from a dealer (description and photos shortened):

```json
{
  "listing_id": "656440678",
  "title": "Fiat Panda 1.2 4x4 Climbing *98.000 KM REALI* UNIC",
  "url": "https://www.subito.it/auto/fiat-panda-1-2-4x4-climbing-98-000-km-reali-unic-frosinone-656440678.htm",
  "price_eur": 4700,
  "ad_type": "In vendita",
  "category": "Auto",
  "region": "Lazio",
  "province": "Frosinone",
  "province_code": "FR",
  "seller_type": "business",
  "make": "FIAT",
  "model": "Panda 2ª serie",
  "mileage_km": 98000,
  "fuel": "Benzina",
  "image_count": 9
}
```

An apartment from an agency:

```json
{
  "listing_id": "668029310",
  "title": "Appartamento Milano [Cod. rif 3394133VRG]",
  "url": "https://www.subito.it/appartamenti/appartamento-milano-cod-rif-3394133vrg-milano-668029310.htm",
  "price_eur": 220000,
  "ad_type": "In vendita",
  "category": "Appartamenti",
  "region": "Lombardia",
  "province": "Milano",
  "province_code": "MI",
  "town": "Milano",
  "town_istat": "015146",
  "published_at": "2026-11-11T20:47:34+01:00",
  "seller_type": "business",
  "shop_id": "42240",
  "shop_name": "Professionecasa Milano S. Rita",
  "size_sqm": 60,
  "price_per_sqm_eur": 3666.67,
  "rooms": "2",
  "bathrooms": "1",
  "floor": "1",
  "energy_class": "B",
  "heating": "Centralizzato",
  "furnished": true,
  "elevator": true,
  "image_count": 21
}
```

### Pricing

Pay per event: you pay for the listings you receive, plus a flat $0.001 per run, whatever memory you choose.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `listing-scraped` | Once per listing row stored in your dataset | $2.25 per 1,000 | $2.00 per 1,000 | $1.80 per 1,000 | $1.62 per 1,000 |
| `run-start` | Once per run, after the first page returned listings | $0.001 | $0.001 | $0.001 | $0.001 |

Never charged:

- links that are not Subito search links (each gets an error row);
- a listing that a second search of the same run finds again;
- listings past your `maxItems`;
- the summary, info and error rows;
- a run whose searches return no listings: the start fee is charged only once listings came back;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.

### How it compares

| Actor | Price per 1,000 on the Free plan | Categories | Input | Seller type and agency name |
|---|---|---|---|---|
| **This actor** | $2.25, plus $0.001 per run | All in one actor | Keywords with filters, province, or search links | Yes |
| [Subito.it Real Estate Scraper by emastra](https://apify.com/emastra/subito-it-immobili?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.50, phone numbers $2.00 per 1,000 found | Property only | Search or listing links | Yes |
| [Subito.it Automotive Scraper by emastra](https://apify.com/emastra/subito-it-motori?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.50, phone numbers $2.00 per 1,000 found | Motors only | Search or listing links | Yes |
| [Subito.it Universal Scraper by azzouzana](https://apify.com/azzouzana/subito-scraper-pro-by-search-url?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.00, plus $0.005 per run | All | One search link per run; free plan runs give 5 listings | Not stated |

Checked 12 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `listing_id` and `price_eur` to see new listings and price drops.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

Subito.it search result pages, the same pages you see in a browser, 30 listings each. Everything in a row is on the public page.

#### How many listings can I get?

Up to 5,000 per search, and up to 100 searches per run. Subito itself lists hundreds of thousands of cars and apartments; split a very large area into provinces or price bands to cover it.

#### Why do some rows have no price?

The seller did not give a price on Subito (common for jobs, wanted ads and some agency listings). `price_eur` is then left out; the rest of the row is complete.

#### Does it return phone numbers or emails?

No. Subito shows a private seller's phone only after a click, and this actor does not collect personal contact details. Business rows carry the agency or dealer name and Subito shop id.

#### Are featured (Vetrina) listings included?

Yes, in the place Subito shows them in the results, with `is_featured` true. A listing is delivered once even if it appears twice.

#### Can I paste a single listing link?

Not in this version: paste the results link it came from and every listing on it comes back with the same fields. A single listing link gets an error row and is not charged.

#### How long does a run take?

About 2 seconds for 30 listings and about 90 seconds for 1,200 in our tests on Apify.

#### Do I need an account, cookies or an API key?

No. You need only an Apify account to run the actor. No Subito account, no cookies, no API key.

#### Which formats can I download?

JSON, CSV, Excel, XML, HTML and RSS from the Output tab or the API. Use the Property and Vehicles views for ready made column sets.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes. Add `https://mcp.apify.com/?actors=themineworks/subito-scraper` as an MCP server in your client, sign in with your Apify token, and ask for listings in plain words.

#### Is it legal to scrape Subito.it?

The actor reads only listings that anyone can see without logging in, and it does not collect phone numbers or emails. Laws differ by country and by use, especially for personal data under GDPR, so check with your own legal adviser before you use the data, for example for direct marketing.

### Integrations

- **Google Sheets**: send each run's listings to a sheet with Apify's Google Sheets integration; one row per listing fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new private car listings under 8,000 euros in Roma to Slack every morning".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [99acres Scraper](https://apify.com/themineworks/99acres-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [MagicBricks Scraper](https://apify.com/themineworks/magicbricks-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Property Scraper](https://apify.com/themineworks/zillow-property-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Photos Scraper](https://apify.com/themineworks/zillow-photos?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Real Estate MCP](https://apify.com/themineworks/real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Airbnb Scraper](https://apify.com/themineworks/airbnb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Domain.com.au Property Scraper](https://apify.com/themineworks/domain-property-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [realestate.com.au Scraper](https://apify.com/themineworks/realestate-com-au-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a search that returns fewer listings than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search Subito.it by keyword, area or link and get every listing back as one row, with price, place, seller type, agency or dealer, description, photos and the property or vehicle details, no login.*

# Actor input Schema

## `startUrls` (type: `array`):

Subito.it search result links copied from your browser, with any filters you set on the site (category, area, price, rooms, make, mileage, private sellers). Example: https://www.subito.it/annunci-lombardia/vendita/appartamenti/milano/ . Each link is one search; the pages after the first are read for you.

## `searchQueries` (type: `array`):

Words to search for, as you would type them in the Subito search box, for example iphone 13, fiat panda, bilocale. Each keyword is one search and uses the filters below. Up to 100 searches per run.

## `category` (type: `string`):

Category for keyword searches. With no keyword and no link, a category together with a region or province is a search on its own (for example every car for sale in Lazio).

## `adType` (type: `string`):

For sale (vendita), for rent (affitto), holiday rent (affitto-vacanze), wanted (cerco) or for free (regalo). Rent works for property and some market categories; holiday rent for holiday homes.

## `region` (type: `string`):

Italian region to search in. Leave on All Italy to search everywhere or to use the province field alone.

## `province` (type: `string`):

Optional province, by name or two letter code, for example Milano, Roma, TO, Monza. The region is filled in for you. For a single town, set it on Subito and paste the link instead.

## `minPrice` (type: `integer`):

Lowest price to include, in euros.

## `maxPrice` (type: `integer`):

Highest price to include, in euros.

## `sellerType` (type: `string`):

Private sellers only, businesses only (agencies, dealers, shops), or both.

## `sort` (type: `string`):

Order of results: newest first, most relevant, cheapest first or most expensive first.

## `titleOnly` (type: `boolean`):

On: only listings with the keyword in the title. Off: the title or the description.

## `shippableOnly` (type: `boolean`):

On: only listings the seller ships with TuttoSubito.

## `maxItems` (type: `integer`):

The most listings to return for each keyword or link, 1 to 5,000. A results page holds 30 listings.

## `proxyConfiguration` (type: `object`):

Apify datacenter proxy works for Subito and is the default. Residential is not needed.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.subito.it/annunci-lombardia/vendita/appartamenti/milano/"
  ],
  "category": "usato",
  "adType": "vendita",
  "region": "italia",
  "sellerType": "all",
  "sort": "datedesc",
  "titleOnly": false,
  "shippableOnly": false,
  "maxItems": 30,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        "https://www.subito.it/annunci-lombardia/vendita/appartamenti/milano/"
    ],
    "maxItems": 30,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/subito-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": ["https://www.subito.it/annunci-lombardia/vendita/appartamenti/milano/"],
    "maxItems": 30,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/subito-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    "https://www.subito.it/annunci-lombardia/vendita/appartamenti/milano/"
  ],
  "maxItems": 30,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call themineworks/subito-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/subito-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/JsFMU4Hbqeabp2ZWs/builds/SGRG5hbKI9DsXkocK/openapi.json
