tecnocasa.it APItecnocasa.it ↗
Search Tecnocasa.it properties for sale or rent across Italy. Retrieve listings, agency contacts, pricing, energy data, and location autocomplete via 4 endpoints.
curl -X GET 'https://api.parse.bot/scraper/7aac2acc-9f50-45a6-9ee8-4322b3252092/search_properties?page=1&limit=5®ion=lom&contract=acquis&province=MI' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for properties available for sale or rent by location (province/region). Returns paginated results with property summaries including price, surface area, rooms, and detail URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Results per page. |
| region | string | Region code (e.g., 'taa' for Trentino Alto Adige, 'lom' for Lombardia, 'vda' for Valle d'Aosta, 'ven' for Veneto). |
| contract | string | Contract type: 'acquis' for sale, 'affitto' for rent. |
| province | string | Province code (e.g., 'TN', 'MI', 'RM', 'FI', 'BZ'). |
| typology | string | Property typology filter. |
| max_price | integer | Maximum price filter in euros. |
| min_price | integer | Minimum price filter in euros. |
{
"type": "object",
"fields": {
"total": "integer total count of matching properties",
"estates": "array of property summary objects with id, title, price, surface, rooms, detail_url, images, agency"
},
"sample": {
"data": {
"total": 0,
"estates": [
{
"id": 61209621,
"price": "€ 535.000",
"rooms": "4 locali",
"title": "Quadrilocale in vendita",
"agency": {
"id": "tnhs0"
},
"ad_type": "estate",
"country": "it",
"surface": "121 Mq",
"bathrooms": "2 bagni",
"best_offer": false,
"detail_url": "https://www.tecnocasa.it/vendita/appartamenti/trento/riva-del-garda/61209621.html"
}
]
},
"status": "success"
}
}About the tecnocasa.it API
The Tecnocasa.it API provides 4 endpoints to search and retrieve property listings and agency data from Italy's largest real estate franchising network. The search_properties endpoint returns paginated results filtered by region, province, contract type, and price range, while get_property_details returns a full property record including surface area, room count, energy data, media, and mortgage information.
Property Search and Filtering
The search_properties endpoint accepts filters for region (e.g., lom for Lombardia, ven for Veneto), province (e.g., RM for Rome, MI for Milan), contract (acquis for sale, affitto for rent), and price bounds via min_price and max_price in euros. Results are paginated via page and limit parameters. Each item in the estates array includes an id, title, price, surface, rooms, detail_url, thumbnail images, and a summary agency object.
Property Detail Data
Passing a full Tecnocasa.it property URL to get_property_details returns a richer record. The media object contains an images array, video, and virtual_tour link when available. The features object covers floor, box, bedrooms, and heating. The agency object includes the listing agency's name, email, phone, address, and a team array of individual agents. Price is returned as a formatted string or a reserved-negotiation label when the seller has withheld the figure. The data array provides address label/value pairs such as municipality and neighborhood.
Agency Lookup
The get_agency_details endpoint accepts an agency URL and returns the agency's full contact record: name, email, phone, address, district, latitude, longitude, and nested region and province objects each carrying an id and title. The team array lists staff members when published.
Location Autocomplete
The get_location_autocomplete endpoint accepts a partial place name via the query parameter and returns a precise array of suggestions. Each suggestion includes a type (province, city, or district), an id, a name, and a placeholder string suitable for display in a search input.
- Aggregate Italian property listings by region and contract type for a real estate comparison portal
- Monitor price changes on specific provinces by periodically calling search_properties with min_price/max_price filters
- Build a map-based property browser using latitude/longitude from get_agency_details responses
- Populate a CRM with Tecnocasa agency contact details including phone, email, and team members
- Feed an investment analysis tool with surface area, room count, and price data from search_properties
- Implement a location-aware search UI using get_location_autocomplete to resolve partial city or district names
- Enrich property listings with virtual tour links, energy data, and mortgage information from get_property_details
| 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.