API Documentation
Learn how to query, search, and integrate VISTARMAN canonical knowledge into your applications, research pipelines, and AI agent workflows.
01
Getting Started
The VISTARMAN API is an open, unauthenticated REST gateway served directly from Cloudflare Edge Workers globally. You do not need to create an account or provide API keys to query public articles and search endpoints.
Public Base URL
GEThttps://api.vistarman.comhttps://api.vistarman.com/v1
02
Core Endpoints Overview
GET /v1/searchSearch Engine
Execute fast TF-IDF and keyword BM25 queries across all canonical articles and notes.
GET /v1/articlesCorpus Listing
Retrieve paginated summaries and taxonomy metadata across 9 Core Pillars.
03
Integration Examples
TypeScript / Next.js
TYPESCRIPT
interface SearchResult {
doc_id: string;
title: string;
slug: string;
summary: string;
score: number;
}
async function searchKnowledge(query: string): Promise<SearchResult[]> {
const res = await fetch(`https://api.vistarman.com/v1/search?q=${encodeURIComponent(query)}`);
if (!res.ok) throw new Error(`Search failed with status ${res.status}`);
const data = await res.json();
return data.results;
}Python 3
PYTHON
import requests
def search_vistarman(query: str, limit: int = 5):
url = "https://api.vistarman.com/v1/search"
response = requests.get(url, params={"q": query, "limit": limit})
response.raise_for_status()
return response.json().get("results", [])
results = search_vistarman("reality")
for item in results:
print(f"[{item['score']:.2f}] {item['title']} -> {item['slug']}")