Subito.it API

Subito.it API for Italian Classifieds Search, Real Estate, and Ad Details

Scrappa's Subito.it API returns structured JSON from Subito, the largest classifieds marketplace in Italy. Search ads by query, category and region in every category including real estate, motorbikes and electronics, open any ad for its price, features, location and images, and read the full category, region and place taxonomy. Private contact data is never returned. Scrappa is an independent service and is not affiliated with or endorsed by Subito.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
5
Endpoints
45
Categories
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Request preview
Request
curl -X GET "https://scrappa.co/api/subito/search?c=7&t=s&r=4&lim=2&sort=datedesc" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response
{
  "success": true,
  "data": {
    "count_all": 21578,
    "lines": 2,
    "start": 0,
    "next_start": 2,
    "has_more": true,
    "ads": [
      {
        "urn": "id:ad:612919294:list:664696487",
        "id": "612919294",
        "subject": "Appartamento Milano [G.B. - STOPPANIVRG]",
        "url": "https://www.subito.it/appartamenti/appartamento-milano-g-b-stoppanivrg-milano-664696487.htm",
        "price": { "amount": 565000, "currency": "EUR" },
        "location": { "region": "Lombardia", "province": "Milano", "town": "Milano" },
        "dates": { "published_at": "2026-10-15T19:08:06Z" }
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "billable": true
  }
}

What you can build

Structured data for real applications. Here are some ideas.

Italian Price Monitoring

Track asking prices for any product category with numeric EUR amounts and sort by date or price.

Real Estate Research

Search apartments for sale or rent by region, province, town, price, rooms and surface.

Marketplace Aggregation

Combine Subito with Wallapop, Milanuncios and Kleinanzeigen to cover classifieds across Europe.

New Ad Alerts

Sort by newest and page with next_start to spot fresh ads within minutes.

Search Features

Power category pickers and place autocomplete with the categories, regions and places endpoints.

Subito.it scraper API

Subito.it API for Italian classifieds, real estate ads, and categories

The Subito.it API is built for price research, real estate monitoring and marketplace aggregation. Each search result includes the ad urn, subject, body, public url, category, numeric EUR price, features such as rooms and surface, location with coordinates, images and the public advertiser summary.

Search by free text, category, ad type, region, province, town, price, rooms and surface.

Page with an offset up to 10000 and read next_start and has_more.

Open any ad for all features, images and publish and expiry dates.

Resolve provinces and towns with the places endpoint.

Private phone numbers and contact details are never returned.

Choose the right Subito.it API endpoint

Use Search for market coverage

Combine category, region, price and ad type filters to collect matching ads with numeric EUR prices.

Open Subito Search API docs

Use Listing for full ad records

Pass the urn from search to get the full feature list, location and images of one ad.

Open Subito Listing API docs

Use Categories, Regions and Places for filters

Read the keys that search accepts as c, r, ci and to.

Open Subito Categories API docs

Available endpoints

Everything you need in one API.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

Subito ad data as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Numeric EUR prices
Scrappa:
ScrapingBee / ScraperAPI: Parse it yourself
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits

Key features

Search all Subito.it categories except Auto with query, category, ad type, region, province, town, price, rooms and surface filters
Numeric EUR prices, features, coordinates and images for every ad
Offset pagination with next_start and has_more
Category, region and place lookup for the search filters
Private contact data is never returned

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Subito. The Subito.it API returns structured JSON from public ads through a Scrappa API key.

Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan. Failed requests are never charged.

Use the start offset with a limit up to 100. Subito serves results up to offset 10000. The response returns has_more and next_start. A valid empty search is a successful response.

No. An unknown or expired ad urn answers a non-billable 404 with error code NOT_FOUND. Only successful 2xx responses are billed.

Start using the Subito.it API

Sign up and get 500 free credits. No credit card required.