APIs / SuperCasa / Search

SuperCasa: Search

Search from SuperCasa as JSON. 1 credit per successful call.

GET /v1/supercasa/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
locationstringOptionalUp to 120 characters
location_levelstringOptionalstate, town, neighborhood, zone
location_selection_tokenstringOptionalUp to 120 characters
businessstringOptionalsale, rent, holiday_rent
categorystringOptionalUp to 60 characters
category_ids[]list of integerOptionalAny
conditionintegerOptionalAny
min_pricenumberOptionalAny
max_pricenumberOptionalAny
min_areanumberOptionalAny
max_areanumberOptionalAny
min_bedroomsintegerOptionalAny
max_bedroomsintegerOptionalAny
bathroomsintegerOptionalAny
features[]list of stringOptionalUp to 60 characters
sortstringOptionalrelevance, newest, price_asc, price_desc
pageintegerOptionalAny

Example request

cURLshell
curl "https://api.perceptlayer.com/v1/supercasa/search?location=Lisboa&business=sale&category=property&max_price=350000&page=1" \
  -H "X-API-Key: $API_KEY"

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.