Login

  • Comparabili Realgest
  • OAuth Method

Real Estate Research

This method allows you to extract the real estate ads closest to your location.

Resource

  • Production environment: https://comparabili.realgest.it/annunci
  • Testing environment: https://test.comparabili.realgest.it/annunci

Mandatory Parameters

Property name Type Description
lat double Latitude of the point where you want to center the search; should be between -90.00 and 90.00 degrees (example: 42.0458796).
lng double Longitude of the point where you want to center the search; should be between -180.00 and 180.00 degrees (example: 12.8488124).
limit int Maximum number of ads to return. The maximum limit of the ws is 30.
radius int Research radius expressed in meters with value >= 500.

Optional Parameters

Property name Type Description
tipologia Tipologia The type of property to be requested.
priceMin int The minimum price of the ads to search.
priceMax int The maximum price of the ads to search.
mqMin int The minimum area of ​​properties to search for.
mqMax int The maximum area of ​​properties to search for.
date_limit int The number of days to filter ad dates. For example, if it is 10, I get ads with a date no older than ten days.

Tipologia

Property name Type Description
Appartamento string Extract the records corresponding to the type Appartamento.
Villa string Extract the records corresponding to the type Villa.
Casa Indipendente string Extract the records corresponding to the type Casa Indipendente.
Villetta a Schiera string Extract the records corresponding to the type Villetta a Schiera.
Attico string Extract the records corresponding to the type Attico/Mansarda.
Mansarda string Extract the records corresponding to the type Attico/Mansarda.
Immobile string Extract the records corresponding to the type Immobile.
Loft string Extract the records corresponding to the type Loft/Open Space.
Stabile Residenziale string Extract the records corresponding to the type Palazzo/Stabile.
Abitazione Rurale string Extract the records corresponding to the type Rustico/Casale.
Cantina string Extract the records corresponding to the type Box/Garage.
Box string Extract the records corresponding to the type Box/Garage.
Posto Auto string Extract the records corresponding to the type Box/Garage.
Locale Commerciale string Extract the records corresponding to the type Negozio, Showroom, Ristorante.
Ufficio string Extract the records corresponding to the type Ufficio.
Magazzino string Extract the records corresponding to the type Magazzino.
Capannone string Extract the records corresponding to the type Capannone.
Fabbricati Agricoli string Extract the records corresponding to the type Azienda Agricola.
Casa di Cura string Extract the records corresponding to the type Casa di Cura.
Albergo string Extract the records corresponding to the type Albergo/Struttura.
Stabile Commerciale string Extract the records corresponding to the type Stabile/Palazzo.
Terreno string Extract the records corresponding to the type Terreno.

Request examples

Response

Token

Response Format

If successful, the response header HTTP status code will be 200 OK and the request will be answered.

If you try to get a request without authorization, you will receive an error 401 Unauthorized.

Additionally you should also handle the 400 Bad request status. For more info on HTTP status handling see dedicated section in Integration best practices page.

Request Response

Parameter Type Description
data AdResponseDetails Array of ads objects, one object per every ad.
count int Number of ads requested.
message string Number of total ads in the area.
success boolean True or false.
error int Only if there is an error.

Ad Response Details

Parameter Type Description
pk int It is the primary key of the record.
url string The ad's url.
title string Ad Title.
position object Location of the property contained in the ad expressed; a "coordinates" array contains longitude and latitude in integer format.
city string City ​​where the property is located.
provincia string Province where the property is located.
street_address string Address where the property is located.
description string Short description of the property.
zone string Area where the property is included.
tipologia string Type of property.
price int Price of the property.
mq string Surface of the building.
data_annuncio string Ad date.
feed_name string Indication of the ad source site.
distance int Distance in meters from the point where the search is centered.