Peshitta Constellations API

Una API pública y abierta para explorar el Nuevo Testamento de la Peshitta desde sus raíces trilíteras.

Fresco, J. (2026). Peshitta Constellations.

Enlaces rápidos

Endpoints

Todos los endpoints viven bajo https://peshitta.onrender.com y devuelven JSON salvo los exportadores. No requieren autenticación.

Read Recuperar versículos individuales

MétodoRutaResumen
GET /api/verse Versículo único con texto siríaco, transliteración y traducciones. Try it open_in_new

Search Búsqueda por raíz, texto y proximidad

MétodoRutaResumen
GET/api/suggestAutocompletado de raíces, palabras y referencias.Try it open_in_new
GET/api/text-searchBúsqueda de texto en transliteración o traducción.Try it open_in_new
GET/api/reverse-searchEncuentra raíces a partir de un cognado HE/AR/EN/ES.Try it open_in_new
GET/api/proximity-searchPares de raíces que coocurren dentro de N versículos.Try it open_in_new

Roots Datos de raíces y familias

MétodoRutaResumen
GET/api/word-rootResuelve una palabra siríaca a su raíz trilítera.Try it open_in_new
GET/api/rootsLista todas las raíces atestiguadas con sus frecuencias.Try it open_in_new
GET/api/root-familyFamilia completa de una raíz: formas, glosas y cognados.Try it open_in_new

Concordance Concordancias KWIC siríacas y griegas

MétodoRutaResumen
GET/api/concordanceLíneas KWIC para una raíz en toda la Peshitta.Try it open_in_new
GET/api/greek-concordanceConcordancia griega (SBLGNT) para un lema o raíz.Try it open_in_new

Passage Constelaciones de raíces por pasaje

MétodoRutaResumen
GET/api/passage-constellationMapa estelar: nodos (raíces) y enlaces para un pasaje.Try it open_in_new

Citation Citas BibTeX, Chicago, MLA, APA, SBL

MétodoRutaResumen
GET/api/citationGenera una cita en cinco estilos para cualquier vista.Try it open_in_new

Export Volcado masivo en formatos académicos

MétodoRutaResumen
GET/api/export/usfmExporta un libro o todo el corpus en USFM 3.0.Try it open_in_new
GET/api/export/osisExporta en OSIS 2.1.1 XML.Try it open_in_new
GET/api/export/text-fabricPaquete Text-Fabric (.zip) con todas las features.Try it open_in_new

Ejemplos

Tres llamadas comunes en curl, Python y JavaScript. Reemplaza el host por http://localhost:5000 si trabajas en local.

1. Recuperar un versículo

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. Buscar la raíz de una palabra

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. Generar una cita académica

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);

Límites de uso

Los límites se aplican por dirección IP. Si necesitas más, abre un issue en GitHub.

Endpoint Límite
/api/citation120 / min
/api/export/*10 / min
Resto de /api/*60 / min

Servidor MCP

Las constelaciones también están disponibles como un servidor MCP que cualquier cliente compatible (Claude Desktop, Cursor, etc.) puede consumir directamente. Sigue las instrucciones de instalación en docs/MCP_INSTALL.md en el repositorio.

Licencia

Apache 2.0 — uso libre con cita.