L'API a été remplacée par les nouveaux points de terminaison disponibles dans Immobiler
Vérifiez la valeur réelle des biens immobiliers grâce aux achats et aux ventes effectués dans une zone donnée.
Deprecated starting from 2024-12-31
Toutes les connaissances dont vous avez besoin
Vous trouverez ici quelques conseils à prendre en compte pour aborder cette API. Si vous préférez, nous fournissons des exemples de code, la documentation OAS3, la possibilité d'essayer l'API en direct via Swagger UI ou d'importer l'intégralité de la collection dans Postman. Nous proposons également un environnement Sandbox où vous pouvez expérimenter toutes sortes de requêtes de manière totalement gratuite.
Obtenir le Token dans la section appropriée avant de commencer.
- Oas file url https://console.openapi.com/oas/fr/compravenditeimmobiliari.openapi.json
- Fork or import with Postman
- Production domain compravenditeimmobiliari.openapi.it
- Sandbox domain test.compravenditeimmobiliari.openapi.it
- Production Scopes 2
-
Sandbox Scopes 2
- POST test.compravenditeimmobiliari.openapi.it/search
- GET test.compravenditeimmobiliari.openapi.it/categories
Compravendite Immobiliari (1.0.0)
Ce service vous permet de rechercher des informations sur les actes de vente de divers biens immobiliers en Italie.
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://compravenditeimmobiliari.openapi.it/categories"); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- "data": [
- {
- "tipologia": "residenziale",
- "categorie_catastali": [
- "A01",
- "A02",
- "A03"
- {
- "tipologia": "pertinenziale",
- "categorie_catastali": [
- "C02",
- "C06"
- "success": true,
- "message": "",
- "error": null
Recherche de ventes autour d'un point géographique donné
Ce point d'accès vous permet de rechercher les actes de vente qui correspondent à votre requête. Les résultats seront toujours renvoyés par ordre de distance à partir du point de départ que vous avez fourni et seront du plus récent au plus ancien qui correspond aux paramètres de la requête.
Veuillez noter que les distances et les superficies sont toujours exprimées en mètres, sauf indication contraire.
Pour obtenir toutes les tipologie et catégorie _catastali disponibles, veuillez utiliser le point de terminaison /catégories.
Si vous avez besoin de connaître les coordonnées d'un lieu spécifique, veuillez jeter un coup d'œil à l'API Geocoding API
Environnement de test
L'environnement de test est chargé avec un ensemble de données plus petit qui vous permet d'effectuer des requêtes de test pendant le développement du service. Tous les actes de vente dans l'environnement de test sont placés autour de 40.85571, 14.23040
Authorizations:
Request Body schema: application/json
dry_run | boolean Default: false Permet d'estimer le coût de la demande en renvoyant le nombre de documents trouvés. Voir l'exemple de réponse Dry run ci-dessous. Le tableau result sera vide. |
object | |
limit | integer Default: 50 Le nombre de résultats qui peuvent être renvoyés lors d'un seul appel à l'API. Vous ne serez facturé que sur le nombre de résultats renvoyés. |
tipologia | string (CategoriaImmobili) Enum: "residenziale" "non_residenziale" "pertinenziale" |
categorie_catastali | Array of strings Si null est indiqué, toutes les catégories disponibles seront prises en compte. |
search_radius | integer Rayon de recherche à partir du "point de départ |
max_surface | integer |
min_surface | integer |
max_price | integer Valeur maximale en euros |
min_price | integer Default: 0 |
object | |
object |
Responses
Response Schema: application/json
Array of objects (SearchResponse) | |
success | boolean |
message | string |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "dry_run": false,
- "starting_point": {
- "lat": 40.8582,
- "long": 14.169901
- "tipologia": "residenziale",
- "search_radius": 15000,
- "max_surface": 100000000,
- "max_price": 900000,
- "from_date": {
- "year": 2019,
- "month": 1
- "to_date": {
- "year": 2021,
- "month": 12
Response samples
- 200
- 401
- 404
- "data": {
- "found": 1,
- "result": [
- {
- "immobili": [
- {
- "CODCAT": "B285",
- "dizione": "BUSCA",
- "tipologiaAtto": "Residenziale",
- "zonaOmi": "C1",
- "decodificaAtto": "Residenziale singolo",
- "tipologia": "Residenziale",
- "categoriaCat": "C06",
- "settoreMercato": "PER",
- "anno": 2019,
- "coduff": "CN00",
- "regpart": "720",
- "totaleImmobili": 2,
- "quotaFavore": "1",
- "indirizzo": "CORSO GIUSEPPE ROMITA 000051",
- "consistenza": "23 mq",
- "regione": "Piemonte",
- "provincia": "CN",
- "citta": "Busca",
- "zona": "ZONA SEMICENTRALE NORD-OVEST",
- "superfice": 23,
- "location_point": {
- "type": "Point",
- "coordinates": [
- 44.519777036017324,
- 7.477693098507002
- "distanza": 0.849734280082744,
- "mese": 1
- {
- "CODCAT": "B285",
- "dizione": "BUSCA",
- "tipologiaAtto": "Residenziale",
- "zonaOmi": "C1",
- "decodificaAtto": "Residenziale singolo",
- "tipologia": "Residenziale",
- "categoriaCat": "A02",
- "settoreMercato": "RES",
- "anno": 2019,
- "coduff": "CN00",
- "regpart": "720",
- "totaleImmobili": 2,
- "quotaFavore": "1",
- "indirizzo": "CORSO GIUSEPPE ROMITA 000051",
- "consistenza": "4 vani",
- "regione": "Piemonte",
- "provincia": "CN",
- "citta": "Busca",
- "zona": "ZONA SEMICENTRALE NORD-OVEST",
- "superfice": 64,
- "location_point": {
- "type": "Point",
- "coordinates": [
- 44.519777036017324,
- 7.477693098507002
- "distanza": 0.849734280082744,
- "mese": 1
- "atto_vendita": "CN002019000720",
- "totale_immobili": 2,
- "prezzo": 111797
- "success": true,
- "message": ""