API Dokumentation

Öffentliche REST-API für »Die Schrift« — die Bibelübersetzung von Martin Buber und Franz Rosenzweig. Kostenloser JSON-Zugang zu allen Büchern, Kapiteln und Versen.

Basis-URL

https://www.die-schrift.de/api/bible

Alle Endpunkte sind öffentlich zugänglich und erfordern keine Authentifizierung. Die Antworten werden im JSON-Format zurückgegeben. Setzen Sie den Header Accept: application/json in Ihren Anfragen.

Endpunkte

Methode	Endpunkt	Beschreibung
GET	/api/bible	Allgemeine Informationen und Statistiken
GET	/api/bible/books	Alle Bücher mit Kapitelanzahl
GET	/api/bible/books/{book}	Buch-Metadaten (Kapitel + Verse pro Kapitel)
GET	/api/bible/{book}	Ganzes Buch mit allen Kapiteln und Versen
GET	/api/bible/{book}/{chapter}	Alle Verse eines Kapitels
GET	/api/bible/{book}/{chapter}/{verse}	Einzelner Vers
GET	/api/bible/{book}/{chapter}/{from}-{to}	Vers-Bereich (z.B. 1-5)
GET	/api/bible/search?q={query}	Volltextsuche (min. 2 Zeichen)

Parameter

{book}

Buchname im internen Format, z.B. 1Mose, Psalm, 1Könige. Die vollständige Liste erhalten Sie über /api/bible/books.

{chapter}

Kapitelnummer als Ganzzahl, z.B. 1, 50.

{verse}

Einzelner Vers als Ganzzahl oder Versbereich mit Bindestrich, z.B. 1 oder 1-5.

q (Suche)

Suchbegriff mit mindestens 2 Zeichen. Optional: limit (Standard: 20, Maximum: 100).

Beispiele

Allgemeine Informationen

GET https://www.die-schrift.de/api/bible

{
    "bible": "Die Schrift",
    "authors": "Martin Buber, Franz Rosenzweig",
    "text_version": "1929",
    "language": "de",
    "total_books": 39,
    "total_chapters": 929,
    "total_verses": 23145,
    "endpoints": { ... }
}

Einzelner Vers

GET https://www.die-schrift.de/api/bible/1Mose/1/1

{
    "bible": "Die Schrift",
    "text_version": "1929",
    "book": "1Mose",
    "display_name": "1. Mose",
    "chapter": 1,
    "verse": 1,
    "text": "Im Anfang schuf Gott den Himmel und die Erde."
}

Vers-Bereich

GET https://www.die-schrift.de/api/bible/1Mose/1/1-3

{
    "bible": "Die Schrift",
    "text_version": "1929",
    "book": "1Mose",
    "display_name": "1. Mose",
    "chapter": 1,
    "verse_range": "1-3",
    "total_verses": 3,
    "verses": [
        { "verse": 1, "text": "Im Anfang schuf Gott ..." },
        { "verse": 2, "text": "..." },
        { "verse": 3, "text": "..." }
    ]
}

Ganzes Kapitel

GET https://www.die-schrift.de/api/bible/Psalm/23

{
    "bible": "Die Schrift",
    "text_version": "1929",
    "book": "Psalm",
    "display_name": "Psalm",
    "chapter": 23,
    "total_chapters": 150,
    "total_verses": 6,
    "verses": [
        { "verse": 1, "text": "..." },
        { "verse": 2, "text": "..." },
        ...
    ]
}

Buch-Metadaten

GET https://www.die-schrift.de/api/bible/books/1Mose

{
    "bible": "Die Schrift",
    "text_version": "1929",
    "book": "1Mose",
    "display_name": "1. Mose",
    "group": "Tora",
    "position": 1,
    "total_chapters": 50,
    "total_verses": 1533,
    "chapters": [
        { "chapter": 1, "verses": 31 },
        { "chapter": 2, "verses": 25 },
        ...
    ]
}

Volltextsuche

GET https://www.die-schrift.de/api/bible/search?q=Anfang&limit=5

{
    "bible": "Die Schrift",
    "text_version": "1929",
    "query": "Anfang",
    "total_results": 5,
    "results": [
        {
            "book": "1Mose",
            "display_name": "1. Mose",
            "chapter": 1,
            "verse": 1,
            "text": "Im Anfang schuf Gott ..."
        },
        ...
    ]
}

Fehlermeldungen

Bei ungültigen Anfragen wird ein JSON-Objekt mit Fehlerdetails zurückgegeben:

404 Not Found

{
    "error": true,
    "message": "Buch nicht gefunden."
}

400 Ungültige Parameter (z.B. ungültiger Versbereich)

404 Buch, Kapitel oder Vers nicht gefunden

422 Validierungsfehler (z.B. Suchbegriff zu kurz)

Buchnamen-Referenz

Verwenden Sie die internen Buchnamen (Spalte »API-Name«) in der URL. Die vollständige Liste erhalten Sie auch über /api/bible/books.

Tora

1. Mose 1Mose

2. Mose 2Mose

3. Mose 3Mose

4. Mose 4Mose

5. Mose 5Mose

Geschichte

Josua Josua

Richter Richter

Ruth Ruth

1. Samuel 1Samuel

2. Samuel 2Samuel

1. Könige 1Könige

2. Könige 2Könige

1. Chronik 1Chronik

2. Chronik 2Chronik

Esra Esra

Nehemia Nehemia

Ester Ester

Weisheit

Hiob Hiob

Psalm Psalm

Sprüche Sprüche

Prediger Prediger

Hohelied Hohelied

Propheten

Jesaja Jesaja

Jeremia Jeremia

Klagelieder Klagelieder

Hesekiel Hesekiel

Daniel Daniel

Hosea Hosea

Joel Joel

Amos Amos

Obadja Obadja

Jona Jona

Micha Micha

Nahum Nahum

Habakuk Habakuk

Zephanja Zephanja

Haggai Haggai

Sacharja Sacharja

Maleachi Maleachi

Hinweise zur Nutzung

info

Die API ist öffentlich und kostenfrei nutzbar. Bitte verwenden Sie sie verantwortungsvoll.

speed

Bitte begrenzen Sie Ihre Anfragen auf ein vernünftiges Maß. Cachen Sie Antworten, wenn möglich.

code

Alle Antworten werden im JSON-Format mit UTF-8-Kodierung zurückgegeben.

link

Bei Veröffentlichung bitte auf die-schrift.de als Quelle verweisen.

Code-Beispiele

JavaScript (Fetch)

// Einzelner Vers
const response = await fetch('https://www.die-schrift.de/api/bible/1Mose/1/1');
const data = await response.json();
console.log(data.text);

// Ganzes Kapitel
const kapitel = await fetch('https://www.die-schrift.de/api/bible/Psalm/23');
const kap = await kapitel.json();
kap.verses.forEach(v => console.log(`${v.verse} ${v.text}`));

Python (requests)

import requests

# Einzelner Vers
r = requests.get('https://www.die-schrift.de/api/bible/1Mose/1/1')
data = r.json()
print(data['text'])

# Alle Bücher auflisten
r = requests.get('https://www.die-schrift.de/api/bible/books')
for book in r.json()['books']:
    print(f"{book['display_name']} — {book['chapters']} Kapitel")

cURL

# Einzelner Vers
curl -s https://www.die-schrift.de/api/bible/1Mose/1/1 | jq .

# Suche
curl -s "https://www.die-schrift.de/api/bible/search?q=Anfang&limit=5" | jq .