Similar listings

Ta strona nie została jeszcze przetłumaczona na Twój język. Wyświetlamy wersję angielski (Wielka Brytania).

Returns listings that resemble one listing, for a "you might also like" row on a property page. Needs the properties:read scope.

Find similar listings

`GET /properties/:id/similar`

Parameter	In	Default	Meaning
`id`	path		The reference listing's UUID
`limit`	query	5	How many to return
`filterByOrganization`	query	`false`	Only your own listings
`includeBranding`	query	`false`	Add the agency's branding and the agent card
`includeAdCount`, `includeAdCreatives`	query	`false`	Add the ad creative count or the creatives

bash

curl "https://api.fondaro.com/properties/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d/similar?limit=4" \  -H "Authorization: Bearer fondaro_pk_abc123"

json

[  {    "id": "f1e2d3c4-5b6a-4789-8c0d-1e2f3a4b5c6d",    "referenceNumber": "FDR-7KQ2MX9B",    "listingType": "sale",    "propertyType": "house_detached",    "city": "Marbella",    "countryCode": "ES",    "price": 1350000,    "currency": "EUR",    "bedrooms": 4,    "status": "active"  }]

How listings are matched

Fondaro widens the match in seven steps until it has limit listings: same town, type, bedrooms and price band; then same town; province; region; country; same type anywhere; then any active listing. Within a step, the most recently published come first.

Results include other agencies' active listings, without their private commission, viewing instructions or lead group.

Errors

Status	When
`400`	`id` is not a UUID
`404`	The reference listing is another agency's and not active