Search
K
[dev] 🇫🇷/🇩🇪/🇧🇪 Property Valuation

Property Valuation API

1.30.4OAS 3.0

Provides real estate price estimation for AVIV platforms in FR, DE, and BE.
The sandbox is limited to specific cities: Montpellier for France, Karlsruhe for Germany and Gent for Belgium.

API Base URL
  • Server 1:https://api.aviv-group.com/property-valuation/v1/{country}
    Variables
    country:

    Production server

  • Server 2:https://api.aviv-group.com/sandbox/property-valuation/v1/{country}
    Variables
    country:

    Sandbox server

Security
bearerAuth (http)

JWT-based authorization. Required scopes per endpoint: property-valuation::sell:read, property-valuation::rent:read, or property-valuation:::read for full access.

Additional Information
Proprietary - AVIV Group License

Estimate selling price for an apartment

Returns the estimated market price range and square meter price for an apartment being sold.

get

Query Parameters

addressstringrequired

Example:10 Rue de Rivoli

citystringrequired

Example:Paris

postal_codeintegerrequired

>= 0

Example:75001

areanumberrequired

> 4

Example:65

room_countintegerrequired

> 0

Example:3

floorintegerrequired

>= 0

Example:3

floor_countintegerrequired

>= 0<= 30

Example:6

item_subtypestringrequired

Allowed values:APARTMENTLOFTDUPLEXTRIPLEX

Example:APARTMENT

bathroom_countinteger

Default:1

>= 0

Example:1

build_yearinteger

Default:0

>= 0

Example:1975

has_passenger_liftboolean

Default:false

Example:true

parking_countinteger

Default:0

>= 0

Example:0

bedroom_countinteger | null

>= 0

Example:2

orientationstring

Allowed values:EAST_NORTH_SOUTH_WESTEAST_NORTH_SOUTHEAST_NORTH_WESTEAST_NORTHEAST_SOUTH_WESTEAST_SOUTHEAST_WESTEASTNORTH_SOUTH_WESTNORTH_SOUTHNORTH_WESTNORTHSOUTH_WESTSOUTHWESTNA

Default:NA

Example:SOUTH

has_cellarboolean

Default:false

Example:false

terrace_areanumber

Default:0

>= 0

Example:8

balcony_areanumber

Default:0

>= 0

Example:5

cellar_areanumber | null

>= 0

Example:6

secured_parking_countinteger

Default:0

>= 0

Example:0

peacefulness_levelstring

Allowed values:VERY_NOISYNOISYSTANDARDPEACEFULVERY_PEACEFUL

Default:STANDARD

Example:STANDARD

brightness_levelstring

Allowed values:DARKSLIGHTLY_DARKSTANDARDBRIGHTVERY_BRIGHT

Default:STANDARD

Example:BRIGHT

transports_proximity_levelstring

Allowed values:VERY_FARFARSTANDARDCLOSEVERY_CLOSE

Default:STANDARD

Example:CLOSE

view_levelstring

Allowed values:VIS_A_VISSTANDARDEXCEPTIONAL

Default:STANDARD

Example:STANDARD

relative_perception_levelstring

Allowed values:INFERIORSTANDARDSUPERIOR

Default:STANDARD

Example:STANDARD

renovation_levelstring

Allowed values:HEAVY_WORK_REQUIREDLIGHT_WORK_REQUIREDSTANDARDGOOD_AS_NEW

Default:STANDARD

Example:STANDARD

ground_garden_areanumber

Default:0

>= 0

Example:0

has_secondary_roomboolean

Default:false

Example:false

has_renovated_facadeboolean

Default:false

Example:false

has_renovated_shared_partsboolean

Default:false

Example:false

yearly_condominium_feeinteger

Default:0

>= 0

Example:1200

portalstring | null

Allowed values:BellesDemeuresImmonetImmoWebImmoWeltImmoWeltAuLaCoteImmoLogicImmoLogicImmoConstruireLogicImmoNeufLuxeResidenceMeilleursAgentsSeLogerSeLogerBureauxCommercesSeLogerConstruireSeLogerNeufE2E

Example:SeLoger

Response

application/json

Successful Response

EstimaResult

valuenumberrequired

Value of the estima for the property

Example:150200.5

lownumberrequired

Estimated low value of the estima

Example:140050.3

highnumberrequired

Estimated high value of the estima

Example:165000

sqm_pricenumberrequired

Estimated value for a square meter of the dwelling

Example:2540

accuracyintegerrequired

Estimated accuracy of the estima value, how confident we are from 1 to 5 (5 means ‘highly confident’)

Allowed values:12345

Example:4

idstring(uuid)

Unique transaction identifier

Example:886313e1-3b8a-5372-9b90-0c9aee199e5d

creation_datetimestring(date-time)

Date and time of creation

price_datestringrequired

Price_date used for the estima, in YYYY-MM-DD format

Example:2025-06-01

get/apartment/sell
 
application/json

Estimate selling price for a house

Returns the estimated selling price range and square meter price for a house.

get

Query Parameters

addressstringrequired

Example:12 Avenue des Champs-Élysées

citystringrequired

Example:Paris

postal_codeintegerrequired

>= 0

Example:75008

areanumberrequired

> 4

Example:120

room_countintegerrequired

> 0

Example:5

floor_countintegerrequired

>= 0<= 30

Example:2

item_subtypestringrequired

Allowed values:HOUSEPRIVATEMANSION

Example:HOUSE

bathroom_countinteger

Default:1

>= 0

Example:1

build_yearinteger

Default:0

>= 0

Example:1988

site_areanumber | null

>= 0

Example:250

parking_countinteger

Default:0

>= 0

Example:1

orientationstring

Allowed values:EAST_NORTH_SOUTH_WESTEAST_NORTH_SOUTHEAST_NORTH_WESTEAST_NORTHEAST_SOUTH_WESTEAST_SOUTHEAST_WESTEASTNORTH_SOUTH_WESTNORTH_SOUTHNORTH_WESTNORTHSOUTH_WESTSOUTHWESTNA

Default:NA

Example:SOUTH

has_swimming_poolboolean

Default:false

Example:false

energy_efficiency_ratingstring

Allowed values:ABCDEFGNA

Default:NA

Example:D

bedroom_countinteger | null

>= 0

Example:4

peacefulness_levelstring

Allowed values:VERY_NOISYNOISYSTANDARDPEACEFULVERY_PEACEFUL

Default:STANDARD

Example:PEACEFUL

brightness_levelstring

Allowed values:DARKSLIGHTLY_DARKSTANDARDBRIGHTVERY_BRIGHT

Default:STANDARD

Example:BRIGHT

transports_proximity_levelstring

Allowed values:VERY_FARFARSTANDARDCLOSEVERY_CLOSE

Default:STANDARD

Example:CLOSE

relative_perception_levelstring

Allowed values:INFERIORSTANDARDSUPERIOR

Default:STANDARD

Example:STANDARD

view_levelstring

Allowed values:VIS_A_VISSTANDARDEXCEPTIONAL

Default:STANDARD

Example:STANDARD

balcony_areanumber

Default:0

>= 0

Example:10

cellar_areanumber | null

>= 0

Example:15

secured_parking_countinteger

Default:0

>= 0

Example:1

renovation_levelstring

Allowed values:HEAVY_WORK_REQUIREDLIGHT_WORK_REQUIREDSTANDARDGOOD_AS_NEW

Default:STANDARD

Example:STANDARD

shared_wall_countinteger

Default:0

>= 0<= 3

Example:0

site_buildable_areanumber

Default:0

>= 0

Example:0

basement_areanumber

Default:0

>= 0

Example:20

secondary_building_areanumber | null

>= 0

Example:0

has_secondary_buildingboolean

Default:false

Example:false

has_sewerageboolean

Default:true

Example:true

living_room_areanumber | null

>= 0

Example:28

roof_renovation_levelstring

Allowed values:WORK_REQUIREDSTANDARDGOOD_AS_NEW

Default:STANDARD

Example:STANDARD

portalstring | null

Allowed values:BellesDemeuresImmonetImmoWebImmoWeltImmoWeltAuLaCoteImmoLogicImmoLogicImmoConstruireLogicImmoNeufLuxeResidenceMeilleursAgentsSeLogerSeLogerBureauxCommercesSeLogerConstruireSeLogerNeufE2E

Example:SeLoger

Response

application/json

Successful Response

EstimaResult

valuenumberrequired

Value of the estima for the property

Example:150200.5

lownumberrequired

Estimated low value of the estima

Example:140050.3

highnumberrequired

Estimated high value of the estima

Example:165000

sqm_pricenumberrequired

Estimated value for a square meter of the dwelling

Example:2540

accuracyintegerrequired

Estimated accuracy of the estima value, how confident we are from 1 to 5 (5 means ‘highly confident’)

Allowed values:12345

Example:4

idstring(uuid)

Unique transaction identifier

Example:886313e1-3b8a-5372-9b90-0c9aee199e5d

creation_datetimestring(date-time)

Date and time of creation

price_datestringrequired

Price_date used for the estima, in YYYY-MM-DD format

Example:2025-06-01

get/house/sell
 
application/json