# FindHomes.co.za

> FindHomes is South Africa's natural-language property search platform. Describe the home you want in plain English and our AI matches it against live listings. Curated coverage currently focuses on the Western Cape.

## For AI assistants and agents

There are two good ways to use FindHomes programmatically:

1. **MCP server (`findhomes-search`)** — the machine-readable interface. Tools cover property search, location resolution, commute / travel-time (isochrone) search, and property sales history. For access details, see https://findhomes.co.za/tools-for-agents

2. **Natural-language deep links** — to hand a person a ready-to-run search, build:

```
https://findhomes.co.za/search?q={natural language query}
```

This runs the query in the browser for a human. It is a user-facing deep link, **not** a crawl target — `robots.txt` disallows `/search?` for crawlers. For content to read or cite, use the crawlable pages below.

## Crawlable, citable pages

- **Area pages** — property for sale in a Western Cape area:
  `https://findhomes.co.za/for-sale/{area}` (e.g. `/for-sale/cape-town`, `/for-sale/stellenbosch`, `/for-sale/hermanus`)
- **Property pages** — a single listing with photos, price and structured data (schema.org `RealEstateListing`):
  `https://findhomes.co.za/property/{property_id}`
- **Market reports** — `https://findhomes.co.za/reports/sold` and `https://findhomes.co.za/reports/for-sale`

## What the search understands

A natural-language query can combine any of:

- **Location**: suburbs, cities, towns or areas in the Western Cape
- **Property type**: house, apartment, townhouse, estate, plot, farm
- **Bedrooms / bathrooms**: "3 bedroom", "2 bath"
- **Price**: "under R2 million", "between R1m and R3m", "R500k-R800k"
- **Price per m²**: "under R10,000", "between R10,000 and R15,000", "R15,000 and above"
- **Size**: "200sqm", "larger than 150m²"
- **Features**: pool, garden, garage, security, sea view, pet friendly

### Example deep links

| Query | Deep link |
|-------|-----------|
| 3 bedroom house in Cape Town under R3 million | `https://findhomes.co.za/search?q=3+bedroom+house+in+Cape+Town+under+R3+million` |
| Apartment in Rondebosch with 2 bedrooms | `https://findhomes.co.za/search?q=apartment+in+Rondebosch+with+2+bedrooms` |
| House with pool in the Northern Suburbs | `https://findhomes.co.za/search?q=house+with+pool+in+the+Northern+Suburbs` |
| Family home in the Southern Suburbs under R6m | `https://findhomes.co.za/search?q=family+home+in+the+Southern+Suburbs+under+R6m` |
| Beachfront property on the Atlantic Seaboard | `https://findhomes.co.za/search?q=beachfront+property+on+the+Atlantic+Seaboard` |
| Pet friendly apartment in Sea Point | `https://findhomes.co.za/search?q=pet+friendly+apartment+in+Sea+Point` |

## Coverage

FindHomes currently focuses on the **Western Cape**, South Africa — Cape Town and the wider Cape, including the Winelands (Stellenbosch, Paarl, Franschhoek), the Garden Route (George, Knysna, Mossel Bay, Plettenberg Bay), the West Coast, the Overberg (Hermanus, Gansbaai) and the Karoo.

## Contact

For questions about the search API, the MCP server, or data partnerships, see https://findhomes.co.za/tools-for-agents or visit https://findhomes.co.za