# Propify

> Propify is a Kenyan property marketplace listing homes for sale, plots and land, and ready-to-build house designs. Every listing page is server-rendered HTML with schema.org RealEstateListing JSON-LD, so it can be read without JavaScript.

## Browse listings

- [Homes for sale](https://propify.co.ke/homes): filter with query parameters `q` (free text), `county`, `place`, `min` and `max` (price in KES), `type` (house type id), `beds`, `baths` (minimum), `sort` (`latest`, `low_price`, `high_price`) and `page`.
- [Plots & land](https://propify.co.ke/plots): same parameters as homes, plus `acres_min` and `acres_max`; `type` is a plot type id.
- [House designs](https://propify.co.ke/designs): same parameters as homes.
- [Building materials](https://propify.co.ke/materials): cement, steel, sand, roofing and more from suppliers. Parameters: `q`, `category` (slug, e.g. `cement-concrete`, `steel`, `roofing`), `county`, `delivery=1`, `sort` (`latest`, `low_price`, `high_price`, `low_minimum`). Product pages (`/materials/{id}/{slug}`) show the price per unit and the minimum order quantity, with `Product` JSON-LD.
- Listing URLs look like `/homes/{id}/{slug}`, `/plots/{id}/{slug}` and `/designs/{id}/{slug}`. Seller profiles look like `/business/profile/view/{id}/{slug}`.

Example: [https://propify.co.ke/homes?county=Nairobi&beds=3&max=20000000](https://propify.co.ke/homes?county=Nairobi&beds=3&max=20000000)

## Tools and guides

- [Area guides](https://propify.co.ke/areas): every county with median asking prices; county pages live at `/areas/{county-slug}` (e.g. `/areas/nairobi`).
- [Find an agent](https://propify.co.ke/agents): agents, developers and architects; filter with `q` (name), `type` (`agent`, `developer`, `architect`) and `area`.
- [Mortgage calculator](https://propify.co.ke/mortgage-calculator): monthly payment and affordability in KES; accepts a `price` query parameter.
- [Sell or list](https://propify.co.ke/sell): how professionals list properties.

## Structured data

- Listing pages embed `RealEstateListing` JSON-LD with price (KES), address, geo coordinates, bedrooms, bathrooms, floor area and the seller.
- Listing index pages embed an `ItemList` of the listings on the page and a `BreadcrumbList`.
- [Sitemap](/sitemap.xml) lists every public listing with its last-modified date.

## Public JSON API (read-only)

- `GET /api/frontend/homes`, `GET /api/frontend/plots/and/lands`, `GET /api/frontend/designs`: paginated listings (8 per page) accepting `min_price`, `max_price`, `bedrooms_min`, `bedrooms_max`, `county`, `place`, `sort_by` and `page`.
- `GET /api/frontend/{id}/property`: a single listing with images, features, seller and payment plans.
- `GET /api/frontend/search/place?search=`: place name lookup.

## Actions on behalf of a user

- Each listing page has a "Book a viewing" form (name, email, Kenyan phone number, a date from the offered visit days, and tour type `in-person` or `video-chat`) and a "Contact" form that reveals the seller's phone number or WhatsApp link after sharing name, email and phone.
- Only submit these forms with the user's explicit consent and their real contact details.

## Optional

- [Create an account](/register) to list properties or save favourites.