Quickstart
Authenticate, resolve a reference, and inspect a strict citation.
1. Set your key
export SEFER_KEY="sg_live_…"
export SEFER_API="https://sefer-graph-worker.mordechaipotash.workers.dev"2. Resolve one reference
curl "$SEFER_API/v1/lookup?ref=Genesis%201:1" \
-H "Authorization: Bearer $SEFER_KEY"{
"ok": true,
"data": {
"status": "resolved",
"canonical_ref": "Genesis 1:1",
"work": "בראשית",
"text": "בראשית ברא אלהים את השמים ואת הארץ"
},
"request_id": "…",
"latency_ms": 41.0
}3. Ask for citations-of-record
curl "$SEFER_API/v1/citations?ref=Genesis%201:1&limit=3" \
-H "Authorization: Bearer $SEFER_KEY"Strict edges carry trust_basis; non-curated explicit edges also carry evidence_hebrew. For
AI-inferred discovery, call /v1/leads separately.
4. Resolve a whole shiur
curl -X POST "$SEFER_API/v1/resolve" \
-H "Authorization: Bearer $SEFER_KEY" \
-H "Content-Type: application/json" \
-d '{"refs":["Genesis 1:1","Berakhot מב., י"],"include":["text","citers"],"cite_limit":3}'Batch resolve accepts at most 200 references. Each reference and search query is capped at 500 characters.