---
title: "Get properties similar to the given seed property"
method: GET
path: "/properties/{property_id}/similar"
tags: ["Propertys"]
---

# Get properties similar to the given seed property

`GET /properties/{property_id}/similar`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/properties/{property_id}/similar`
- Auth: none declared

Get parks similar to the seed property, ranked by embedding cosine distance.

Phase 3 of the semantic-search roadmap: the first user-visible consumer
of ``properties.embedding``. Candidates are pulled via the HNSW index
and then re-ranked in Python to prefer same-state matches and to cap
same-management-group siblings at one in the result set.

Returns ``200`` with an empty list when the seed exists but has no
embedding yet — the PDP carousel renders nothing and degrades quietly.
Returns ``404`` when the seed is not found or hidden from public view.

## Path parameters

- `property_id` integer, required

## Query parameters

- `limit` integer: Maximum number of similar properties to return (1-12).
- `country` 'AU' | 'NZ': ISO country code used to scope public property inventory.

## Headers

- `API-Version` '1'

## Response `200`

Successful Response

- SuccessPayload
  - `msg` string, required
  - `data` union
    - object
    - unknown[]
      - unknown
    - string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/totalparks/apis/total-parks-public-api.md) · [All operations](https://skmtc.dev/totalparks/apis/total-parks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/totalparks/apis/total-parks-public-api/revisions/dcb4c822e2c6?raw)