# 💰 \[1.5$/1k] Subito.it 🧡 Scraper by Search URL ⚡ (`nogards95/subito-scraper-by-url`) Actor

Scrape Subito.it listings at scale. Extract titles, prices, locations, seller info, images and URLs from Italy's largest classifieds marketplace. Supports URLs search and pagination.

- **URL**: https://apify.com/nogards95/subito-scraper-by-url.md
- **Developed by:** [Nogards](https://apify.com/nogards95) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

### What does Subito.it Scraper — By Search URL do?

This Actor scrapes **[Subito.it](https://www.subito.it)** search results using any search URL you already have open in your browser. Paste the URL, set the number of pages, and get structured listing data — no need to configure keywords, categories, or locations manually.

Works with all Subito.it categories: electronics, real estate, vehicles, fashion, musical instruments, and more. It is a **Subito.it API alternative** that works without an official API.

### Why scrape Subito.it?

Subito.it is Italy's largest classifieds marketplace with millions of listings across every category. Scraping it lets you:

- 📦 **Monitor prices** for specific products or properties
- 🔁 **Track resale opportunities** — find underpriced listings before competitors
- 📊 **Build market research datasets** for pricing and trend analysis
- 🏷️ **Automate inventory sourcing** for resellers and dealers
- 🔔 **Power price alert tools** by running the Actor on a schedule

Unlike the keyword-based [Subito.it Scraper](https://apify.com/nogards95/subito-scraper), this Actor accepts the **exact URL** from your browser — including any filters (location, price range, category) you've already applied. It's designed for users who already monitor specific Subito.it searches.

### What data can Subito.it Scraper extract?

| Field | Type | Description |
|-------|------|-------------|
| `title` | string | Listing title |
| `price` | number | Numeric price in EUR (null if free or negotiable) |
| `priceRaw` | string | Price as shown on the page (e.g. "750 €") |
| `currency` | string | Always "EUR" |
| `location` | string | City and/or region of the seller |
| `images` | array | Thumbnail image URLs for the listing |
| `link` | string | Direct URL to the full listing page |

### How to scrape Subito.it

1. Open [Subito.it](https://www.subito.it) in your browser
2. Search for what you want — apply any filters (category, province, price range)
3. Copy the full URL from your browser address bar
4. Paste it into the **Search URL** field in the Actor input
5. Set **Max pages** (each page has ~30 listings; default is 1 page for the free test run)
6. Click **Start** and wait for results

### How much will it cost to scrape Subito.it?

This Actor uses **pay-per-result** pricing at **$1.50 per 1,000 listings**.

- Scraping 1 page (~30 listings) costs less than **$0.05**
- Scraping 100 listings costs **$0.15**
- Scraping 1,000 listings costs **$1.50**

You are only charged for successfully scraped listings. Failed or skipped items are free. The Apify Free plan includes $5 of usage per month, enough for ~3,300 listings.

### Input

See the **Input tab** for full configuration options.

| Field | Required | Default | Description |
|-------|----------|---------|-------------|
| `searchUrl` | Yes | `https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone` | Subito.it search URL from your browser |
| `maxPages` | No | `1` | Number of result pages to scrape (~30 listings per page, up to 50 pages) |

### Output

You can download the dataset in various formats such as **JSON, HTML, CSV, or Excel** from the Output tab or via the [Apify API](https://docs.apify.com/api/v2).

```json
[
  {
    "title": "iPhone 15 Pro Max 256GB - Blu Titanio",
    "price": 950,
    "priceRaw": "950 €",
    "currency": "EUR",
    "location": "Milano, Lombardia",
    "images": ["https://images.subito.it/annunci/..."],
    "link": "https://www.subito.it/annunci/lombardia/vendita/usato/..."
  }
]
````

### FAQ, Disclaimers, and Support

#### Is this Actor legal to use?

> Our Actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our Actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend reviewing [Subito.it's Terms of Service](https://www.subito.it/terms-of-service.htm) before use.

#### What URL formats are supported?

Any standard Subito.it search URL — for example:

- `https://www.subito.it/annunci-italia/vendita/usato/?q=iphone`
- `https://www.subito.it/annunci-lombardia/vendita/elettronica/?q=macbook&ps=500&pe=1500`
- `https://www.subito.it/annunci-lazio/affitti/immobili/roma/`

The Actor preserves all your filter parameters and simply appends the pagination parameter (`&o=2`, `&o=3`, etc.) for subsequent pages.

#### Why does the Actor use Playwright (a browser)?

Subito.it renders listings with JavaScript, so a simple HTTP request returns a blocked page. Playwright launches a real browser in headless mode to load the page content. This makes the Actor slightly slower but reliable.

#### The Actor returned fewer results than expected

If a page returns no listings (e.g. the search has fewer results than `maxPages × 30`), the Actor logs a warning and stops early. Try reducing `maxPages` or broadening your search filters.

#### How do I run this on a schedule?

Use the **Schedules** feature in Apify Console to run this Actor automatically (e.g. daily or hourly) and monitor your saved searches. Results are stored in the dataset and accessible via API.

#### I found a bug or need help

Please use the **Issues tab** on the Actor page to report bugs or request features. For programmatic access, see the **API tab**.

# Actor input Schema

## `searchUrl` (type: `string`):

Paste the Subito.it search URL directly from your browser (e.g. https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone).

## `maxPages` (type: `integer`):

Maximum number of result pages to scrape. Each page contains ~30 listings.

## Actor input object example

```json
{
  "searchUrl": "https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone",
  "maxPages": 1
}
```

# Actor output Schema

## `results` (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 = {
    "searchUrl": "https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone"
};

// Run the Actor and wait for it to finish
const run = await client.actor("nogards95/subito-scraper-by-url").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 = { "searchUrl": "https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone" }

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

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

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

```

## CLI example

```bash
echo '{
  "searchUrl": "https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone"
}' |
apify call nogards95/subito-scraper-by-url --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nogards95/subito-scraper-by-url",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "💰 [1.5$/1k] Subito.it 🧡 Scraper by Search URL ⚡",
        "description": "Scrape Subito.it listings at scale. Extract titles, prices, locations, seller info, images and URLs from Italy's largest classifieds marketplace. Supports URLs search and pagination.",
        "version": "1.0",
        "x-build-id": "7lvVNfBK2bTjKyPmz"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nogards95~subito-scraper-by-url/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nogards95-subito-scraper-by-url",
                "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/nogards95~subito-scraper-by-url/runs": {
            "post": {
                "operationId": "runs-sync-nogards95-subito-scraper-by-url",
                "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/nogards95~subito-scraper-by-url/run-sync": {
            "post": {
                "operationId": "run-sync-nogards95-subito-scraper-by-url",
                "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",
                "required": [
                    "searchUrl"
                ],
                "properties": {
                    "searchUrl": {
                        "title": "Search URL",
                        "type": "string",
                        "description": "Paste the Subito.it search URL directly from your browser (e.g. https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone).",
                        "default": "https://www.subito.it/annunci-lombardia/vendita/usato/?q=iphone"
                    },
                    "maxPages": {
                        "title": "Max pages",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "Maximum number of result pages to scrape. Each page contains ~30 listings.",
                        "default": 1
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```