# Treeple.kz (LLM / Agent Notes)

Treeple.kz is a tour booking platform focused on tours and adventures in Kazakhstan.

## Source Of Truth
- Published tour pages:
  - `https://treeple.kz/{lang}/tours/{slug}`
- Catalog (published tours only):
  - `https://treeple.kz/{lang}/tours`
- Backend API (content source):
  - `https://backend.treeple.kz/api/v1/public/*`

## Sitemaps / Robots
- Robots: `https://treeple.kz/robots.txt`
- Sitemap index: `https://treeple.kz/sitemap-index.xml`

## Supported Languages
Language is always present in the URL:
- `en, ru, kk, zh-hans, ja, ko, ms, hi, bn, ur, ar, de, fr, it, pt, es, id, sw`

If a translation for a given language is not published, the corresponding URL returns `404` (no implicit fallback rendering in a different language).

## Pricing / Currency
- Public currency: `USD`.
- Prices in structured data and UI are expressed in `USD`.

## Dates / Last Updated
- Tour dates are ISO date strings (`YYYY-MM-DD`) and represent a calendar tour date (not a precise timestamp).
- Each tour page exposes a "Last updated" date and a stable identifier (`tourId`).

## API Access
Base URL: `https://backend.treeple.kz/api/v1`

Public endpoints (no auth required):
- `GET /public/tours` (list; language via `?locale=...`)
- `GET /public/tours/{slug}` (detail; `{slug}` is localized for the requested language)
- `GET /public/tours/{slug}/related`
- `GET /public/tours/{slug}/reviews`
- `GET /public/directions`
- `GET /public/tour-types`
- `GET /public/collections`
- `GET /public/sitemap/tours` (all published tour slugs for sitemap generation)

## Policies / Contact
- Privacy: `https://treeple.kz/en/privacy` (and `https://treeple.kz/ru/privacy` if available)
- Terms / public offer: `https://treeple.kz/en/agreement` (and `https://treeple.kz/ru/agreement` if available)
- Refund: `https://treeple.kz/en/refund` (and `https://treeple.kz/ru/refund` if available)
- Contact: `support@treeple.kz`