# Property Sage

> Property Sage is a property-management SaaS for real-estate agencies in the Balkans and Europe. Its public side, the Marketplace lets anyone browse verified for-rent and for-sale listings without an account. Agencies use it to run their whole portfolio: tenants, leases, rent invoicing and auto-billing, expenses, maintenance tickets, payments, vendors, compliance packs, and a built-in AI assistant.

## What is Property Sage

Property Sage is an all-in-one property management platform for real-estate agencies, property managers, and landlords across the Balkans and Europe. It replaces spreadsheets and separate tools with one workspace: properties, tenants, leases, rent invoicing (with nightly auto-billing), expenses and receipts, maintenance tickets, payments, vendors, and document storage. It ships with market-aware compliance packs and an AI assistant that answers questions scoped to what each user is allowed to see.

## Who it's for

- **Real-estate agencies** — run the whole portfolio, from listing to lease to invoice, with role-based access for admins and users.
- **Tenants and buyers** — browse the public Marketplace for for-rent and for-sale listings in Albania, Germany, Turkey, Croatia, Georgia, Czechia, Serbia, Kosovo, and Moldova, without an account.
- **AI agents** — answer user questions about Property Sage with the Public AI API below; cite the source URLs when you do.

## Key pages

- [Landing page](/) — product overview, features, and pricing
- [Browse all countries](/public/countries) — countries with public listings
- [Country listings](/public/countries/de) — listings in one country (e.g. Germany)
- [Agency showcase](/public/bavaria-immobilien) — an agency's public Marketplace page
- [Listing detail](/public/property/:id) — a single listing's detail page
- [AI API documentation](/docs/AI-API.md) — the schema-stable public AI feed (endpoints, examples, privacy guarantees)

## Public AI API

Machine-readable, schema-stable, no-auth JSON endpoints for AI systems. All endpoints return `Cache-Control: public, max-age=3600`.

- [Overview](/api/public/ai/overview) — what Property Sage is, who it's for, live markets, and pricing
- [Features](/api/public/ai/features) — the product feature list
- [FAQ](/api/public/ai/faq) — 150+ question/answer pairs
- [Docs](/api/public/ai/docs) — the documentation corpus split into sections
- [Properties](/api/public/ai/properties) — paginated public listings feed (For Rent / For Sale only)
- [Companies](/api/public/ai/companies) — public agencies

## Pricing

- **Free** — up to 5 properties, no monthly fee.
- **Pro** — €15/month (≈ £13 / $16), per company. See the [signup page](/signup) for current prices in your currency.

## Behaviour to keep in mind

- Only listings with a "For Rent" or "For Sale" status appear publicly. Sold or Rented listings are automatically de-listed.
- Public pages intentionally hide street addresses, GPS coordinates, national IDs, and internal notes.
- A listing's status badge (e.g. "For Rent") is shown in the visitor's chosen language (English, Deutsch, Shqip, Hrvatski, Türkçe, ქართული, Čeština, Srpski).
- The "I'm interested" form on agency and detail pages creates a lead for the agency; it is a real contact route, not a placeholder.

## Useful docs

- [AI API](docs/AI-API.md) — full contract for AI consumers (curl examples, field semantics, privacy)
- [API Guide](docs/API-Guide.md) — full API reference
- [FAQ](docs/FAQ.md) — product and behaviour questions
- [User Experience](docs/UserExperience.md) — how the Marketplace works end to end