# BezBaseina

> Latvian property portal. Owners and agencies manage listings (ads), photos,
> leads and AI assistance (text rewrite, quality analysis, price suggestions)
> via a REST API, a CLI (@bezbaseina/cli) and an MCP server.

## Getting started
- API base: https://bezbaseina.lv/api/v1
- Capabilities (JSON): https://bezbaseina.lv/api/v1/capabilities
- OpenAPI: https://bezbaseina.lv/api/v1/openapi.json
- Discovery: https://bezbaseina.lv/.well-known/bezbaseina.json
- Auth: Bearer bbk_ token, or connect an assistant with the device flow
  (POST https://bezbaseina.lv/api/v1/auth/device). Programmatic access needs the Pro plan.
- Scopes: ads:read, ads:write, ads:publish, photos:write, ai:assist, leads:read, leads:write, billing:read
- Risky actions (publish, pause, price change) are two-phase: the call returns
  a confirmation object; apply it with POST /api/v1/confirmations/{id}.

## Capabilities
- GET /api/v1/listings — List public listings (read,public)
- GET /api/v1/listings/{id} — Get a public listing (read,public)
- GET /api/v1/market/summary — Market summary (read,public)
- GET /api/v1/capabilities — Capability registry (read,public)
- GET /api/v1/me — Who am I (read)
- GET /api/v1/ads — List my ads (read) [ads:read]
- GET /api/v1/ads/{id} — Get one of my ads (read) [ads:read]
- POST /api/v1/ads/{id}/analyse — Analyse ad quality (read) [ai:assist]
- POST /api/v1/ads/{id}/improve-text — Improve ad text (read) [ai:assist]
- POST /api/v1/ads/{id}/suggest-price — Suggest a price (read) [ai:assist]
- POST /api/v1/ads/{id}/publish — Publish / re-activate an ad (write,confirm) [ads:publish]
- POST /api/v1/ads/{id}/pause — Pause an ad (write,confirm) [ads:publish]
- POST /api/v1/ads/{id}/price — Change an ad's price (write,confirm) [ads:write]
- POST /api/v1/photos/upload — Upload a photo (write) [photos:write]
- POST /api/v1/photos/{id}/enhance — Enhance a photo (write) [photos:write]
- GET /api/v1/leads — List leads (read) [leads:read]
- PATCH /api/v1/leads/{id} — Update a lead's status (write) [leads:write]
- POST /api/v1/leads/{id}/draft-reply — Draft a lead reply (read) [ai:assist leads:read]
- POST /api/v1/confirmations/{id} — Confirm a pending action (write)