GET
/
documents
/
properties

Query parameters

bedroomMax
number

Maximum number of bedrooms in the property.

bedroomMin
number

Minimum number of bedrooms in the property.

budgetMax
number

Maximum budget for the property.

budgetMin
number

Minimum budget for the property.

condominiumFeesMax
number

Maximum condominium fees for the property.

condominiumFeesMin
number

Minimum condominium fees for the property.

constructionYearMax
number

Maximum construction year of the property.

constructionYearMin
number

Minimum construction year of the property.

energyCategories
array

The energy efficiency categories of the property.

energyValueMax
number

Maximum energy value of the property.

energyValueMin
number

Minimum energy value of the property.

eventPriceVariationFromCreatedAt
date

Date from which an event of type price is created — inclusive.

eventPriceVariationMax
number

Maximum percent variation of an event of type price.

eventPriceVariationMin
number

Minimum percent variation of an event of type price.

eventPriceVariationToCreatedAt
date

Date before which an event of type price is created — inclusive.

eventSurfaceVariationFromCreatedAt
date

Date from which an event of type surface is created — inclusive.

eventSurfaceVariationMax
number

Maximum percent variation of an event of type surface.

eventSurfaceVariationMin
number

Minimum percent variation of an event of type surface.

eventSurfaceVariationToCreatedAt
date

Date before which an event of type surface is created — inclusive.

excludedCities
array

Cities to be excluded.

excludedInseeCodes
array

Insee codes to be excluded.

excludedProperties
array

Properties to be excluded.

excludedSites
array

Sources sites to be excluded.

excludedZipcodes
array

Zipcodes to be excluded.

expired
boolean
default: "null"

Whether to show properties that are expired. A property is considered expired when all its adverts are expired. Can be true, false or null. Default is null which returns all properties no matter if they’re expired or not.

expressions
array

Full text matching including/excluding words & phrases in the title or the description of the property. Example: expressions[0][0][word]=travaux&expressions[0][0][options][includes]=true&expressions[0][0][options][strict]=false&expressions[0][1][word]=lumineux&expressions[0][1][options][includes]=true&expressions[0][1][options][strict]=false which will search for properties that contain both the keywords lumineux and travaux.

feesPercentageMax
number

Maximum percentage of fees.

feesPercentageMin
number

Minimum percentage of fees.

feesResponsibility
number

Responsibility for fees. 0 for seller, 1 for buyer.

floorQuantityMax
number

Maximum number of floors in the property.

floorQuantityMin
number

Minimum number of floors in the property.

fromDate
date

Date from which the property is created — inclusive.

fromExpiredAt
date

Date from which the advert is expired — inclusive.

fromUpdatedAt
date

Date from which the property is updated — inclusive.

furnished
boolean

Filter for furnished properties.

greenHouseGasCategories
array

Green house gas performance letter array of the property.

greenHouseGasValueMax
number

Maximum value of green house gas of the property.

greenHouseGasValueMin
number

Minimum value of green house gas of the property.

includedCities
array

Located in given cities. Example: includedCities[]=/cities/30953&includedCities[]=/cities/30952. Use locations to get the desired city ids.

includedDepartments
array

Located in given departments. Example: includedDepartments[]=/departments/77. Use locations to get the desired department ids.

includedInseeCodes
array

Located in given insee codes. Example: includedInseeCodes[]=75117&includedInseeCodes[]=75118

includedSites
array

Sources sites to be included.

includedZipcodes
array

Located in given zipcodes. Example: includedZipcodes[]=75017&includedZipcodes[]=75018

inventoryPriceMax
number

Lower than or equal to given inventory price. Example: inventoryPriceMax=500

inventoryPriceMin
number

Greater than or equal to given inventory price. Example: inventoryPriceMin=250

itemsPerPage
number
default: "10"

The number of items per page. Max is 30.

landSurfaceMax
number

Maximum land surface.

landSurfaceMin
number

Minimum land surface.

lat
number

Latitude. Will work if latitude exists in the property. Example: lat=48.864716

lon
number

Longitude. Will work if latitude exists in the property. Example: lon=2.349014

lotCountMax
number

Lower than or equal to given lot count. Example: lotCountMax=12

lotCountMin
number

Greater than or equal to given lot count. Example: lotCountMin=4

order[createdAt]
string
default: "desc"

Order properties by creation date. Can be asc or desc.

order[pricePerMeter]
string
default: "desc"

Order properties by price per meter. Can be asc or desc.

order[price]
string

Order properties by price. Can be asc or desc.

order[surface]
string

Order properties by surface. Can be asc or desc.

order[updatedAt]
string

Order properties by update date. Can be asc or desc.

page
integer
default: "1"

The collection page number.

priceExcludingFeesMax
number

Lower than or equal to given price excluding fees. Example: priceExcludingFeesMax=427500

priceExcludingFeesMin
number

Greater than or equal to given price excluding fees. Example: priceExcludingFeesMin=405000

pricePerMeterMax
number

Lower than or equal to given price per meter. Example: pricePerMeterMax=11500

pricePerMeterMin
number

Greater than or equal to given price per meter. Example: pricePerMeterMin=9500

propertyTypes
array

Type of property. Apartment 0, House 1, Building 2, Parking 3, Office 4, Land 5, Shop 6. Example: propertyTypes[]=0&propertyTypes[]=1

publisherTypes
array

Type of publisher. Individual 0, Professional 1. Example: publisherTypes[]=0&publisherTypes[]=1

radius
integer

Distance expressed in kilometers. Will work if latitude & longitude parameters are also set. Example: radius=20

rentalChargesMax
number

Lower than or equal to given rental charges amount. Example: rentalChargesMax=100

rentalChargesMin
number

Greater than or equal to given rental charges amount. Example: rentalChargesMin=50

rentalPledgeMax
number

Lower than or equal to given rental pledge amount. Example: rentalPledgeMax=800

rentalPledgeMin
number

Greater than or equal to given rental pledge amount. Example: rentalPledgeMin=500

renterFeesMax
number

Lower than or equal to given renter fees. Example: renterFeesMax=80

renterFeesMin
number

Greater than or equal to given renter fees. Example: renterFeesMin=50

roomMax
number

Maximum rooms of the property. Example: roomMax=6

roomMin
number

Minimum rooms of the property. Example: roomMin=3

sortMode
string
default: "property"

Whether to sort results by properties or by adverts.

If property is chosen, fromDate and toDate parameters will be overridden so that the results will be sorted by the createdAt of each property.

If advert is chosen: fromDate and toDate parameters will be overridden so that the results will be sorted by createdAt of each advert.

Example: sortMode=property

Please check our glossary for more information about the distinction between adverts and properties.

surfaceMax
number

Lower than or equal to given surface. Example: surfaceMax=84

surfaceMin
number

Greater than or equal to given surface. Example: surfaceMin=42

toDate
date

Date until which the property is created — inclusive. Example: toDate=2021-05-07 12:42:42

toExpiredAt
date

Date from which the advert is expired — inclusive. Example: toExpiredAt=2021-05-07 12:42:42

toUpdatedAt
date

Date until which the property is updated — inclusive. Example: toUpdatedAt=2021-05-07 12:42:42

transactionType
integer

Type of transaction. Sell 0, Rent 1. Example: transactionType=0

withCoherentPrice
boolean
default: "true"

Filter properties with coherent price. Example: withCoherentPrice=true

withVirtualTour
boolean

Having a virtual tour video link. Example: withVirtualTour=true