API Reference
Detailed technical specifications for all available public REST endpoints, query parameters, response structures, and error codes.
GEThttps://api.vistarman.com/v1/search
BM25 Full-Text SearchPerforms lexical BM25 search across all canonical articles, scoring document titles, summaries, and keyword tokens.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Search query string (e.g. reality) |
| limit | number | No | Max results to return (default: 10, max: 50) |
GEThttps://api.vistarman.com/v1/articles
Paginated Article DirectoryReturns a paginated list of canonical articles with optional pillar category filtering.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| pillar | string | No | Filter by pillar identifier (e.g. 01-reality-and-existence) |
| limit | number | No | Max items to return (default: 20, max: 100) |
| offset | number | No | Pagination offset index (default: 0) |
GEThttps://api.vistarman.com/v1/articles/:slug
Article Detail & RecommendationsRetrieves article metadata, canonical link, and dynamic pairwise related article recommendations for a specific slug.
GEThttps://api.vistarman.com/v1/recommendations/:id
Knowledge Graph MatrixReturns top pairwise concept recommendations derived from the knowledge graph connection matrix.
GEThttps://api.vistarman.com/v1/status
Platform Health & TelemetryReturns machine-readable JSON status containing active version, license, total canon note count, and cache policies.