# Similar listings

> Find listings similar to one listing, for a "you might also like" row on a property page.

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 |

Source: https://www.fondaro.com/docs/api/properties/similar