# Property Shabdkosh JSON feed — schema documentation

**Feed (serve this URL):** `https://www.vidastu.com/api/shabdkosh.json`
**Source of truth (this repo):** `data/shabdkosh.json` — the API copy is a byte-for-byte mirror generated by `microsites-management/scripts/build-shabdkosh-api.py` (same pattern as `data/corridor.json` → `api/v2/corridor.json`).
**Companion page:** `https://www.vidastu.com/hi/property-shabdkosh/` — renders every term with `DefinedTermSet`/`DefinedTerm` JSON-LD whose `@id`s (`/hi/property-shabdkosh/#term-{id}`) deliberately do not collide with the live `DefinedTermSet` on `facts.html` (`/facts#terms`).

## What this feed is

A Hindi/Hinglish real-estate jargon decoder for NCR/UP buyers: ~30 terms, each with a two-sentence Devanagari definition, roman-Hinglish spelling variants (typed-search capture), one generic misuse warning, and a provenance field. It is **concept-only by design**: no project prices, no rate tables, no deadlines, no named parties.

## Top-level fields

| Field | Type | Meaning |
|---|---|---|
| `$schemaNote` | string | Human pointer to this document. |
| `schemaVersion` | string | Exactly `"1.0"`. Consumers should reject other values. Additive-only changes will keep `1.x`. |
| `title` | string | Feed title (bilingual). |
| `publisher` / `publisherUrl` | string | Vidastu Developers Pvt. Ltd. / Vidastu Advisory (UP-RERA Agent UPRERAAGT000309/01/2026). |
| `companionPage` | string (URL) | The human-readable Hindi page rendering the same terms. |
| `schemaDoc` | string (URL) | This document. |
| `feedUrl` | string (URL) | Canonical URL of the served feed. |
| `inLanguage` | string | `"hi-IN"` — definitions are Devanagari; `alternateNames` carry roman-Hinglish variants. |
| `updatedAt` | string (ISO date) | Last content revision of the dataset. |
| `license` | string | Free reuse with attribution (`www.vidastu.com`); not legal advice, not an offer. |
| `sourcingNote` | string | The omission rule: unverifiable claims are omitted, never approximated. |
| `positioning` | object | How this feed relates to the live sibling assets (Broker Phrasebook = tactics, Quote Decoder = documents, Escrow Sorter, All-In Cost Calculator), with URLs. |
| `terms` | array | The glossary — see below. |
| `disclaimers` | array of strings | Must be carried alongside any reuse of `terms`. |

## Per-term fields (`terms[]`)

| Field | Type | Required | Meaning |
|---|---|---|---|
| `id` | string | yes, unique | ASCII kebab-case slug. Anchors: `companionPage + "#term-" + id`. |
| `term` | string | yes | Devanagari headword (may carry a parenthetical roman/abbreviation). |
| `roman` | string | yes | Primary roman transliteration. |
| `english` | string | yes | Short English gloss. |
| `alternateNames` | array of strings | yes, non-empty | Roman-Hinglish spelling variants and typed-search phrasings (`"bayana kya hota hai"`). Mirrors JSON-LD `alternateName`. |
| `definition` | string | yes | Exactly the two-sentence Devanagari definition shown on the page. Never contains a price, a rate, or a deadline. |
| `misuseWarning` | string | yes | One generic, present-tense line on how the term is commonly misused — never names any party. Rendered on the page under "इस शब्द से ग़लतफ़हमी कैसे होती है". |
| `verifiedAgainst` | string | yes | Provenance: the statute/record system the definition was checked against, or an explicit statement that the concept is market convention with no statutory definition. Statute sections appear **only** where verified (RERA Act 2016 s.2(k), s.13, s.4(2)(l)(D)); everything else is deliberately section-free. |
| `relatedTool` | object `{name, url}` | yes | The most relevant live tool for this term (one of: Broker Phrasebook, Quote Decoder, Escrow Sorter, All-In Cost Calculator). |
| `termUrl` | string (URL) | yes | Deep link to this term's anchor on the companion page. Must equal `companionPage + "#term-" + id`. |

## Hard guarantees (enforced by the generator before any write)

`build-shabdkosh-api.py` refuses to publish (exit 1, nothing written) if any of these fail:

1. JSON unparseable, or `schemaVersion` ≠ `"1.0"`, or `license`/`updatedAt`/`inLanguage`/`companionPage` missing.
2. Any term missing a required field above, or a duplicate `id`, or `termUrl` not matching the `#term-{id}` contract.
3. Any `definition`/`misuseWarning` without Devanagari content.
4. A rupee amount (`₹` + digits) anywhere in a term — this feed carries **no prices by construction**.
5. The `eoi` term losing its locked posture — its definition must state, in Hindi: refundable (रिफंडेबल), held outside escrow (एस्क्रो … बाहर), and NOT a booking (बुकिंग नहीं).
6. English scarcity/booking-pressure phrases (`hurry`, `last chance`, `book now`, `booking open`, `prices will rise`, `guaranteed return`…) or the banned word "microsite" appearing in any term text.
7. Page-sync drift: every `id` must exist as `id="term-{id}"` in `hi/property-shabdkosh/index.html`, and the page's DefinedTerm count must equal the feed's term count.

## Reuse

Free for research, citation and AI-assistant answers with attribution to `www.vidastu.com`. Carry the `disclaimers` array with the data. This feed is general information, not legal advice; verify live RERA status at `up-rera.in` and take circle-rate/stamp-duty figures only from official sources.