Listings

Retrieves residential listings matching the specified criteria.

Changed on

Search results are limited to the first 1000 results.

If the number of results is greater, the intention is to refine the search by adding more restrictive parameters, to find a relevant set of results.

post/v1/listings/residential/_search

Request

Request body

listingType'Sale' | 'Rent' | 'Share' | 'Sold' | 'NewHomes'
propertyTypesstring[]
propertyFeaturesstring[]
listingAttributesstring[]
propertyEstablishedType'Any' | 'New' | 'Established'
minBedroomsnumber float
maxBedroomsnumber float
minBathroomsnumber float
maxBathroomsnumber float
minCarspacesinteger
maxCarspacesinteger
minPriceinteger
maxPriceinteger
minLandAreainteger
maxLandAreainteger
advertiserIdsinteger[]
adIdsinteger[]
excludeAdIdsinteger[]
locationTermsstring
keywordsstring[]
newDevOnlyboolean
inspectionFromstring date-time
inspectionTostring date-time
auctionFromstring date-time
auctionTostring date-time
dateAvailableFromstring date-time
dateAvailableTostring date-time
ruralOnlyboolean
excludePriceWithheldboolean
excludeDepositTakenboolean
topspotKeywordsstring[]
pageSizeinteger
updatedSincestring date-time
listedSincestring date-time
includeInspectionAggregationsboolean
aggregationsstring[]
pageNumberinteger

Response

OK

type'PropertyListing' | 'Project'

Changes

    • breaking

      removed the enum value Proximity of the request property / (media type: application/json)

    • breaking

      removed the enum value Proximity of the request property / (media type: text/json)

    • breaking

      removed the enum value Proximity of the request property / (media type: text/html)

    • breaking

      removed the enum value Proximity of the request property / (media type: application/xml)

    • breaking

      removed the enum value Proximity of the request property / (media type: text/xml)

    • breaking

      removed the enum value Proximity of the request property / (media type: application/x-www-form-urlencoded)

    • warning

      removed the request property / (media type: application/json)

    • warning

      removed the request property / (media type: text/json)

    • warning

      removed the request property / (media type: text/html)

    • warning

      removed the request property / (media type: application/xml)

    • warning

      removed the request property / (media type: text/xml)

    • warning

      removed the request property / (media type: application/x-www-form-urlencoded)

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: text/json)

    • info

      added the new optional request property (media type: text/html)

    • info

      added the new optional request property (media type: application/xml)

    • info

      added the new optional request property (media type: text/xml)

    • info

      added the new optional request property (media type: application/x-www-form-urlencoded)