sourcetruth

JavaScript client for the SourceTruth canonical text API.

SourceTruth provides semantic search and grounded Q&A over pre-indexed canonical corpora — Buddhist scriptures, Islamic texts, Jewish texts, classical philosophy, and more.

Install

npm install sourcetruth
# or
yarn add sourcetruth

Quick start

const API_KEY = "st_..."; // get yours at https://sourcetruth.io

// Semantic search across all corpora
const res = await fetch("https://api.sourcetruth.io/v1/search", {
  method: "POST",
  headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ query: "what is the nature of suffering?", top_k: 5 }),
});
const { passages } = await res.json();
passages.forEach((p) => console.log(p.reference, p.text.slice(0, 120)));

// Grounded Q&A with citations (paid tiers)
const ans = await fetch("https://api.sourcetruth.io/v1/answer", {
  method: "POST",
  headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({ question: "What does the Quran say about patience?" }),
});
console.log((await ans.json()).answer);

Full SDK

A full client with TypeScript types, pagination helpers, and error handling is coming in v0.2.0.

In the meantime, the REST API is fully documented at docs.sourcetruth.io.

Links

• API: api.sourcetruth.io
• Docs: docs.sourcetruth.io
• RapidAPI: rapidapi.com/SourceTruth/api/sourcetruth