Peshitta Constellations API

Een publieke, open API om het Peshitta Nieuwe Testament via zijn triliterale wortels te verkennen.

Fresco, J. (2026). Peshitta Constellations.

Snelle links

Endpoints

All endpoints live under https://peshitta.onrender.com and return JSON (except the exporters). No authentication required.

Read Single-verse retrieval

MethodPathSummary
GET /api/verse Single verse with Syriac text, transliteration, and translations. Try it open_in_new

Search Root, text, and proximity search

MethodPathSummary
GET/api/suggestAutocomplete for roots, words, and references.Try it open_in_new
GET/api/text-searchFree-text search in transliteration or translation.Try it open_in_new
GET/api/reverse-searchFind roots from a Hebrew/Arabic/English/Spanish cognate.Try it open_in_new
GET/api/proximity-searchPairs of roots that co-occur within N verses.Try it open_in_new

Roots Root and family data

MethodPathSummary
GET/api/word-rootResolve a Syriac word to its triliteral root.Try it open_in_new
GET/api/rootsList every attested root with frequency counts.Try it open_in_new
GET/api/root-familyFull family for a root: forms, glosses, and cognates.Try it open_in_new

Concordance Syriac and Greek KWIC concordances

MethodPathSummary
GET/api/concordanceKWIC lines for a root across the whole Peshitta.Try it open_in_new
GET/api/greek-concordanceGreek (SBLGNT) concordance for a lemma or root.Try it open_in_new

Passage Per-passage root constellations

MethodPathSummary
GET/api/passage-constellationStar map: nodes (roots) and links for a passage.Try it open_in_new

Citation BibTeX, Chicago, MLA, APA, SBL citations

MethodPathSummary
GET/api/citationGenerates a citation in five styles for any view.Try it open_in_new

Export Bulk export in academic formats

MethodPathSummary
GET/api/export/usfmExport a book or the full corpus in USFM 3.0.Try it open_in_new
GET/api/export/osisExport in OSIS 2.1.1 XML.Try it open_in_new
GET/api/export/text-fabricText-Fabric package (.zip) with all features.Try it open_in_new

Voorbeelden

Three common calls in curl, Python, and JavaScript. Replace the host with http://localhost:5000 for local work.

1. Fetch a verse

GET /api/verse?book=John&chapter=1&verse=1
curl "https://peshitta.onrender.com/api/verse?book=John&chapter=1&verse=1"
import requests

r = requests.get(
    "https://peshitta.onrender.com/api/verse",
    params={"book": "John", "chapter": 1, "verse": 1},
)
data = r.json()
print(data["syriac"], data["translit"])
const url = new URL("https://peshitta.onrender.com/api/verse");
url.search = new URLSearchParams({ book: "John", chapter: 1, verse: 1 });

const res = await fetch(url);
const data = await res.json();
console.log(data.syriac, data.translit);

2. Look up a word's root

GET /api/word-root?word=ܡܠܟܘܬܐ
curl --get "https://peshitta.onrender.com/api/word-root" \
     --data-urlencode "word=ܡܠܟܘܬܐ"
import requests

r = requests.get(
    "https://peshitta.onrender.com/api/word-root",
    params={"word": "ܩܠܒܝܬܐ"},
)
print(r.json()["root_key"])  # e.g. "M-L-K"
const params = new URLSearchParams({ word: "ܩܠܒܝܬܐ" });
const res = await fetch(
  `https://peshitta.onrender.com/api/word-root?${params}`
);
const { root_key } = await res.json();
console.log(root_key); // e.g. "M-L-K"

3. Generate an academic citation

GET /api/citation?style=bibtex&view=root&ref=N-P-SH
curl "https://peshitta.onrender.com/api/citation?style=bibtex&view=root&ref=N-P-SH"
import requests

r = requests.get(
    "https://peshitta.onrender.com/api/citation",
    params={"style": "bibtex", "view": "root", "ref": "N-P-SH"},
)
print(r.json()["citation"])
const url = new URL("https://peshitta.onrender.com/api/citation");
url.search = new URLSearchParams({
  style: "bibtex", view: "root", ref: "N-P-SH",
});
const res = await fetch(url);
const { citation } = await res.json();
console.log(citation);

Snelheidslimieten

Limits are applied per IP. Open a GitHub issue if you need more.

Endpoint Limit
/api/citation120 / minute
/api/export/*10 / minute
All other /api/*60 / minute

MCP Server

The constellations are also available as a Model Context Protocol server that any compatible client (Claude Desktop, Cursor, etc.) can consume directly. Follow the install instructions in docs/MCP_INSTALL.md in the repository.

Licentie

Apache 2.0 — vrij gebruik met citatie.