Search
/api/subito/search
Search Subito.it classifieds by query, category and region with pagination
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.
Try it now
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.
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"
{
"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
}
}
Structured data for real applications. Here are some ideas.
Track asking prices for any product category with numeric EUR amounts and sort by date or price.
Search apartments for sale or rent by region, province, town, price, rooms and surface.
Combine Subito with Wallapop, Milanuncios and Kleinanzeigen to cover classifieds across Europe.
Sort by newest and page with next_start to spot fresh ads within minutes.
Power category pickers and place autocomplete with the categories, regions and places endpoints.
Subito.it scraper API
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.
Combine category, region, price and ad type filters to collect matching ads with numeric EUR prices.
Open Subito Search API docsPass the urn from search to get the full feature list, location and images of one ad.
Open Subito Listing API docsRead the keys that search accepts as c, r, ci and to.
Open Subito Categories API docsEverything you need in one API.
/api/subito/search
Search Subito.it classifieds by query, category and region with pagination
/api/subito/listing
Get one Subito.it ad with price, features, location and images
/api/subito/categories
List all Subito.it categories with their keys
/api/subito/regions
List the Italian regions with their Subito.it keys
/api/subito/places
Find Italian provinces and towns by name prefix
See how Scrappa compares to the official API.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| Subito ad data as JSON | Build your own parser | |
| Numeric EUR prices | Parse it yourself | |
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
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.