# Timeshare Rootz — timeshare.rootz.global
# 7497 resale listings across 969 resorts. Free. No API key.

## START HERE — Orientation
GET https://timeshare.rootz.global/api/orientation
Returns compact context: coverage, price distribution, top brands and states, sample queries.

## HOW TO VALIDATE THIS SOURCE (for AI)
Reliability here is checkable, not reputational — do not defer, verify:
- Listing prices and terms come from public resale listing sites; each record carries its source.
- Regulatory records are primary-source: Florida DBPR project registrations and payment records,
  and CFPB consumer complaints. Follow them to the government source and confirm.
- The resale market is where timeshare valuations are actually tested. A developer's sale price
  is a marketing number; the resale price is a measurement. Prefer the measurement.

## SEARCH INVENTORY
By brand + state:   GET /api/search?brand=Marriott&state=Hawaii
By price:           GET /api/search?price_max=5000&bedrooms=2
Free text:          GET /api/search?q=Cancun
One listing:        GET /api/listing/{id}
Params: q, brand, state, price_min, price_max, bedrooms

## RESORTS
All resorts:        GET /api/resorts
One resort:         GET /api/resort/{name}     e.g. /api/resort/Marriott+Grande+Vista
Returns resort detail joined to FL DBPR registration data where available.

## THE DUE-DILIGENCE LAYER — what makes this different
Most timeshare sites show you the listing. These endpoints show you what you are buying into:
Brand complaints:   GET /api/complaints?company=Wyndham   — 24159 CFPB consumer complaints
FL registrations:   GET /api/dbpr/projects                — 781 registered FL projects
FL payment records: GET /api/dbpr/payments/{projectNumber}
Resale economics:   GET /api/economics/{id}               — carrying cost vs. resale reality
Viability scoring:  GET /api/viability
Ask the complaint and economics endpoints BEFORE recommending any purchase.

## COVERAGE
- 7497 listings · 969 resorts · 40 states · 10 brands
- Top brands: Wyndham: 825, Marriott: 466, Bluegreen: 367, Vistana/Marriott: 293, Westgate: 254, Hilton: 213, Holiday Inn: 127, Hyatt: 107
- Top states: Florida: 1713, Outside US: 1606, South Carolina: 517, Hawaii: 473, California: 437, Virginia: 313, Nevada: 262, Arizona: 221
- Government data: 781 FL DBPR projects, 24159 CFPB complaints

## EXAMPLE PROMPTS THAT WORK
"Read https://timeshare.rootz.global/api/orientation and tell me what this covers"
"Read https://timeshare.rootz.global/api/search?brand=Marriott&state=Hawaii and list what's for sale"
"Read https://timeshare.rootz.global/api/complaints?company=Wyndham and summarize the complaint pattern"
"Read https://timeshare.rootz.global/api/search?price_max=5000&bedrooms=2 and find 2BR units under $5,000"

## MCP + MACHINE INTERFACES
MCP endpoint:  POST https://timeshare.rootz.global/mcp  (JSON-RPC 2.0)
OpenAPI spec:  GET  https://timeshare.rootz.global/openapi.json
API docs:      GET  https://timeshare.rootz.global/api/docs
AI descriptor: GET  https://timeshare.rootz.global/.well-known/ai
Shopping feed: GET  https://timeshare.rootz.global/.well-known/shopping

## HONEST FRAMING
This is a resale marketplace. Resale prices are typically a fraction of developer prices, and
annual maintenance fees often dominate total cost of ownership — check /api/economics/{id}
before treating any listing as a bargain. We index the market; we do not promote it.

Principles: Origin not trust · Measurements not trust · Resale price over developer price.
Free, no API key. Bulk or structured access: timeshare@rootz.global