# Subito.it Listings Scraper

> Subito.it Listings Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured product listings from Subito.it search result pages, returning titles, prices, URLs, and metadata for up to 10,000 items per call.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/subito?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/subito-it-listings-scraper-9329f8fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PFgZccBPvnTr239k7PxD1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability subito-it-listings-scraper-9329f8fc -d '<json body>'
```

Example prompt: Scrape the top 200 used iPhone listings from this Subito.it search URL and give me the title, price, and link for each one: https://www.subito.it/annunci-italia/vendita/telefonia/?q=iphone

## When to prefer this

Use this endpoint when you need structured data from Subito.it specifically — Italy's largest classifieds marketplace — and want pay-per-result pricing with no charge for failed runs. Prefer this over generic web scrapers when you need consistent field extraction (price, title, URL, date) from Subito search pages and want to collect up to 10,000 listings in a single call.

## Known failure modes

- Invalid or malformed Subito.it search URL returns empty results or error
- Search URL pointing to a non-search page (e.g. a single listing) may yield 0 results
- maxItems exceeding 10,000 or below 1 is rejected by schema validation
- Subito.it blocking or rate-limiting the scraper may result in partial or empty results
- Network timeout may cause a failed run (not charged)

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object containing a count of items found and an array of listing objects, each with fields: id, url, price, title, searchUrl, description, publishedAt, and priceCurrency. Only populated listings are returned; failed or empty runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxItems": {
   "type": "integer",
   "default": 100,
   "maximum": 10000,
   "minimum": 1,
   "description": "Maximum number of unique listings to save from the search URL."
  },
  "searchUrl": {
   "type": "string",
   "description": "Full Subito search results URL. Select a category, location, and filters on the site, then paste the URL here."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "url": null,
    "price": null,
    "title": null,
    "searchUrl": null,
    "description": null,
    "publishedAt": null,
    "priceCurrency": null
   }
  ],
  "product": "subito"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/subito-it-listings-scraper-9329f8fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)
