Peshitta Constellations API
API פתוח וציבורי לחקר הברית החדשה של הפשיטתא דרך השורשים התלת-עיצוריים.
קישורים מהירים
נקודות קצה
כל נקודות הקצה תחת https://peshitta.onrender.com ומחזירות JSON מלבד המייצאים. אין צורך באימות.
Read Single-verse retrieval
| Method | Path | Summary | |
|---|---|---|---|
| GET | /api/verse | Single verse with Syriac text, transliteration, and translations. | Try it open_in_new |
Search Root, text, and proximity search
| Method | Path | Summary | |
|---|---|---|---|
| GET | /api/suggest | Autocomplete for roots, words, and references. | Try it open_in_new |
| GET | /api/text-search | Free-text search in transliteration or translation. | Try it open_in_new |
| GET | /api/reverse-search | Find roots from a Hebrew/Arabic/English/Spanish cognate. | Try it open_in_new |
| GET | /api/proximity-search | Pairs of roots that co-occur within N verses. | Try it open_in_new |
Roots Root and family data
| Method | Path | Summary | |
|---|---|---|---|
| GET | /api/word-root | Resolve a Syriac word to its triliteral root. | Try it open_in_new |
| GET | /api/roots | List every attested root with frequency counts. | Try it open_in_new |
| GET | /api/root-family | Full family for a root: forms, glosses, and cognates. | Try it open_in_new |
Concordance Syriac and Greek KWIC concordances
| Method | Path | Summary | |
|---|---|---|---|
| GET | /api/concordance | KWIC lines for a root across the whole Peshitta. | Try it open_in_new |
| GET | /api/greek-concordance | Greek (SBLGNT) concordance for a lemma or root. | Try it open_in_new |
Passage Per-passage root constellations
| Method | Path | Summary | |
|---|---|---|---|
| GET | /api/passage-constellation | Star map: nodes (roots) and links for a passage. | Try it open_in_new |
Citation BibTeX, Chicago, MLA, APA, SBL citations
| Method | Path | Summary | |
|---|---|---|---|
| GET | /api/citation | Generates a citation in five styles for any view. | Try it open_in_new |
Export Bulk export in academic formats
| Method | Path | Summary | |
|---|---|---|---|
| GET | /api/export/usfm | Export a book or the full corpus in USFM 3.0. | Try it open_in_new |
| GET | /api/export/osis | Export in OSIS 2.1.1 XML. | Try it open_in_new |
| GET | /api/export/text-fabric | Text-Fabric package (.zip) with all features. | Try it open_in_new |
דוגמאות
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);
מגבלות שימוש
Limits are applied per IP. Open a GitHub issue if you need more.
| Endpoint | Limit |
|---|---|
/api/citation | 120 / 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.
רישיון
Apache 2.0 — שימוש חופשי עם ציטוט.