subito.it APIsubito.it ↗
Access Subito.it listings via API. Search classifieds, fetch real estate data, get item details, reveal seller phones, and browse dealer inventories.
curl -X GET 'https://api.parse.bot/scraper/e626a4f7-5ad6-47bb-93ad-28426d5a7b09/search_listings?limit=2&query=laptop&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for listings on Subito.it with various filters including keyword, category, location, and price range. Returns paginated results sorted by recency.
| Param | Type | Description |
|---|---|---|
| city | string | City/Provincia ID. |
| town | string | Town/Comune ID. |
| limit | integer | Number of results to return. |
| query | string | Search keyword. |
| offset | integer | Pagination offset (start index). |
| region | string | Region ID. |
| category | string | Category ID (e.g. 6 for Real Estate, 2 for Cars, 12 for Telefonia). Use get_categories to discover all IDs. |
| price_max | string | Maximum price filter. |
| price_min | string | Minimum price filter. |
| listing_type | string | Listing type: 's' for sale (vendita), 'a' for rent (affitto). |
| advertiser_type | string | Advertiser type: '0' for private, '1' for business. |
{
"type": "object",
"fields": {
"ads": "array of listing objects with urn, subject, body, category, geo, advertiser, features, images, urls",
"start": "next pagination offset",
"count_all": "total number of matching results"
},
"sample": {
"data": {
"ads": [
{
"geo": {
"city": {
"value": "Torino"
},
"region": {
"value": "Piemonte"
}
},
"urn": "id:ad:78303528-f19f-4237-9b8b-f19200fb9750:list:601314706",
"body": "Description text...",
"subject": "Apple iPhone 12 Pro Max 256GB",
"category": {
"key": "12",
"value": "Telefonia"
},
"features": [
{
"uri": "/price",
"values": [
{
"key": "449",
"value": "449 €"
}
]
}
],
"advertiser": {
"user_id": "11396168",
"shop_name": "TORINO HI-TECH"
}
}
],
"start": 3,
"count_all": 70451
},
"status": "success"
}
}About the subito.it API
The Subito.it API exposes 6 endpoints covering Italy's largest classifieds marketplace, letting you search listings across all categories, retrieve full item details, filter real estate by type and price range, and surface seller contact information. The search_listings endpoint accepts filters for keyword, category, region, city, and price, returning paginated arrays of ads with geo, advertiser, features, and image data. Real estate, dealer, and category discovery endpoints round out the surface.
Searching and Filtering Listings
The search_listings endpoint accepts up to eight parameters — query, category, region, city, town, price_max, limit, and offset — and returns a paginated list of ad objects. Each ad includes a urn identifier, subject (title), body (description), geo location breakdown, advertiser metadata, a features array covering price, condition, and shipping, and an images array with CDN URLs. The count_all field tells you the total number of matching results so you can implement pagination using offset and start.
Category IDs are not guessable; use get_categories first. It returns the full category tree as an array of objects with key (the ID to pass to other endpoints), value (display name), friendly_name, and an optional macrocategory_id linking sub-categories to their parent. Common IDs include 6 for Real Estate, 2 for Cars, and 12 for Telefonia.
Real Estate and Dealer Endpoints
get_real_estate_listings targets the Real Estate macro-category by default (ID 6) but accepts sub-category IDs like 7 (Appartamenti), 29 (Ville), 30 (Terreni), and 31 for additional types. It adds listing_type (s for sale, a for rent) and price_min/price_max range filters not available in the generic search. The response shape is identical to search_listings, giving you ads, start, and count_all.
get_dealer_listings takes a user_id (found in any ad's advertiser.user_id field) and returns all active listings from that advertiser, paginated the same way. get_listing_details accepts a numeric ad_id and returns the complete single-ad object, including the full body description, all images, urls for both desktop and mobile listing pages, and the advertiser object with shop_name and a company flag indicating whether the seller is a business. get_seller_phone takes a listing urn and returns the seller's phone_number as a plain string.
- Aggregate Italian real estate listings filtered by region and price range for a property search tool
- Monitor a dealer's full inventory over time using get_dealer_listings with their user_id
- Build a price-comparison tool for used electronics by searching category 12 (Telefonia) with price_max filters
- Extract seller phone numbers from high-value listings for a lead-generation workflow
- Index Subito.it car listings (category 2) by region for an automotive aggregator
- Discover and map the full category taxonomy using get_categories before building a category-scoped crawler
- Pull listing images and CDN URLs to populate a product card or alert system
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Subito.it have an official public developer API?+
What does get_seller_phone return, and when is it available?+
phone_number string for the listing identified by its urn. The urn is available in any search_listings or get_listing_details response under the urn field. The phone number is only present when the seller has chosen to display it on their listing; not all listings expose a phone number.How do I paginate through a large result set?+
start field alongside count_all. Pass the value of start as the offset parameter in your next request to advance to the next page. Use limit to control page size. Continue until start equals or exceeds count_all.Does the API cover Subito.it Motors (motorbikes, boats, commercial vehicles)?+
search_listings and get_real_estate_listings, but specific sub-category IDs for motorbikes, boats, and commercial vehicles are not pre-documented here — use get_categories to discover those IDs. Dedicated filter parameters for vehicle-specific attributes (year, mileage, fuel type) are not currently exposed as separate inputs. You can fork this API on Parse and revise it to add those vehicle-specific filter parameters.