Kostenlos · Ohne API-Key · Ohne Limit

Die Bibel-API by Midvash

Verse, Kapitel und Bücher aus 107 freien Bibelübersetzungen in 67 Sprachen. JSON über HTTPS, direkt aus dem Browser abrufbar. Ohne Anmeldung, ohne Key.

Ein Vers mit einem Aufruf

Rufen Sie die API direkt auf. Ohne Setup, ohne Authentifizierung.

const res = await fetch('https://api.midvash.com/v1/kjv/john/3/16');
const { data, meta } = await res.json();
console.log(data.text);
console.log(meta.copyright); // show it with the text

Warum diese API

107 freie Übersetzungen

Luther 1912, Schlachter 1951, Elberfelder 1905, Menge 1939, KJV, BSB und viele mehr, in 67 Sprachen. Alle gemeinfrei oder unter freier Lizenz.

Quellenangabe inklusive

Jede Antwort mit Bibeltext enthält den Copyright-Vermerk der Übersetzung. Die Quellenangabe ist nur ein Feld entfernt.

Schnell am Edge

Ausgeliefert vom Cloudflare-Edge mit langem Caching und ETags. Eine Revalidierung liefert ein leeres 304.

Ohne Key, ohne Limit

Keine Anmeldung, kein API-Key, keine 429-Fehler. Offenes CORS: direkt von jeder Webseite aufrufbar.

Übersetzungen und Lizenzen

107 Übersetzungen in 67 Sprachen, alle gemeinfrei oder unter freier Lizenz. Klicken Sie auf eine Übersetzung, um Metadaten und den vollständigen Lizenztext zu sehen.

Quellenangabe neben dem Text zeigen

Jede Antwort mit Bibeltext enthält die Quellenangabe der Übersetzung: meta.copyright in v1, copyright in /v1/votd und in den Legacy-Routen. Zeigen Sie sie in der Nähe der Bibelstelle an. CC BY und CC BY-SA verlangen das.

Eine Übersetzung angefragt, die wir nicht mehr ausliefern?

Übersetzungen, bei denen alle Rechte vorbehalten sind (NIV, ESV, NLT, NVI, ARA, NVT, NTV und andere), werden nicht ausgeliefert. Alte Links funktionieren weiter: Sie erhalten eine freie Übersetzung derselben Sprache, und data.version zeigt, welche.

API-Referenz

Alle v1-Endpoints. Klicken Sie auf „Testen", um eine echte Anfrage zu senden.

Bibelinhalt

GET /v1/{version}/{book}/{chapter}

Liefert ein vollständiges Bibelkapitel

Parameter
version path erforderlich Übersetzungs-Slug (z. B. kjv, almeida-livre)
book path erforderlich Buch-Slug in beliebiger Sprache
chapter path erforderlich Kapitelnummer
preview query optional Kürzt den Text auf etwa N Zeichen (40 bis 2000), für Tooltips
GET /v1/{version}/{book}/{chapter}/{verse}

Liefert einen einzelnen Vers oder einen Bereich (16 oder 16-20)

Parameter
version path erforderlich Übersetzungs-Slug (z. B. kjv, almeida-livre)
book path erforderlich Buch-Slug in beliebiger Sprache
chapter path erforderlich Kapitelnummer
verse path erforderlich Einzelner Vers (16) oder Bereich (16-20)
GET /v1/votd

Vers des Tages: derselbe für alle am selben UTC-Tag, mit dem Copyright der Übersetzung (24 h Cache)

Parameter
language query optional Locale (en, pt-br, es, fr, de, it, zh, ru, ko). Standard: en.
version query optional Übersetzungs-Slug. Standard: kanonische Übersetzung des gewählten Locales.

Batch & Parsing

GET /v1/passages

Holt bis zu 50 Stellen in einem Aufruf. Eine ungültige Stelle scheitert allein, an ihrer eigenen Position.

Parameter
refs query erforderlich Kommagetrennte Bibelstellen (max. 50)
version query erforderlich Übersetzungs-Slug
GET /v1/parse

Zerlegt eine Bibelstelle als Freitext (in jeder der 9 Sprachen) in Buch, Kapitel und Verse

Parameter
q query erforderlich Bibelstelle als Freitext, z. B. Johannes 3:16-18
version query optional Optional. Wird geprüft und zurückgegeben

Übersetzungen & Bücher

GET /v1/versions

Listet alle verfügbaren Bibelübersetzungen auf (107), mit Lizenztext

Parameter
language query optional Nach ISO-Sprachcode filtern (siehe /v1/versions für die vollständige Liste)
GET /v1/versions/{slug}

Liefert Metadaten zu einer bestimmten Übersetzung

Parameter
slug path erforderlich Slug in beliebiger Sprache
GET /v1/books

Listet die 66 Bücher der Bibel auf

Parameter
testament query optional "old" oder "new"
GET /v1/books/{slug}

Liefert Metadaten zu einem Buch (Slug in beliebiger Sprache)

Parameter
slug path erforderlich Slug in beliebiger Sprache

Copy-paste-Guides

Dieselbe Anfrage, in den Tools, die du schon nutzt.

Einen Vers holen /v1/kjv/john/3/16

curl https://api.midvash.com/v1/kjv/john/3/16

Übersetzungen einer Sprache listen /v1/versions?language=pt-br

curl 'https://api.midvash.com/v1/versions?language=pt-br'

Vers des Tages /v1/votd?language=en

curl 'https://api.midvash.com/v1/votd?language=en'

Antwortformat & Caching

Jeder v1-Endpoint spricht dasselbe JSON-Envelope und dieselben HTTP-Cache-Regeln.

Erfolgs-Envelope

Erfolgreiche Antworten verpacken die Nutzlast in ein data-Feld auf oberster Ebene. Listen- und Inhalts-Endpoints ergänzen ein optionales meta-Objekt mit Summen, der aufgelösten Referenz und, sobald Bibeltext geliefert wird, dem Copyright der Übersetzung.

{
  "data": {
    "version": "kjv",
    "book": "john",
    "bookName": "John",
    "chapter": 3,
    "verse": 16,
    "verseEnd": 16,
    "text": "For God so loved the world…",
    "verses": ["For God so loved the world…"]
  },
  "meta": {
    "reference": "John 3:16",
    "total": 1,
    "copyright": "King James Version (KJV)\nPublic Domain.\n…"
  }
}

HTTP & Caching

CachingInhalte sind unveränderlich — ein Jahr gecacht (max-age=31536000, immutable). Neue Inhalte kommen unter einer neuen URL, nie in einem geänderten Body.
RevalidierungJede Antwort trägt ein starkes ETag. Sende If-None-Match und du bekommst 304 Not Modified ohne Body.
CORSFür jede Origin offen (Access-Control-Allow-Origin: *). Rufe sie direkt aus dem Browser auf — ohne Proxy.
MethodenGET, HEAD und OPTIONS. HEAD liefert nur die Header; OPTIONS behandelt den CORS-Preflight.
Eine Ausnahme — /v1/votd

Der Vers des Tages liefert ein flaches Objekt (reference, text, version, book_slug, chapter, verse_start, verse_end, url, copyright) statt des data/meta-Envelopes und wird 24 Stunden gecacht.

Fehler

Jeder Fehler nutzt ein Format und einen stabilen, maschinenlesbaren Code.

{
  "error": {
    "code": "BOOK_NOT_FOUND",
    "message": "Book \"jhon\" not found. Did you mean \"john\"?",
    "details": { "didYouMean": "john" }
  }
}
CodeHTTPWann es passiert
INVALID_PARAMS 400 Ein Pfad- oder Query-Wert ist ungültig — z. B. eine Kapitelnummer außerhalb des Bereichs.
NOT_FOUND 404 Die Route existiert unter /v1 nicht.
VERSION_NOT_FOUND 404 Keine Übersetzung passt zum angegebenen Slug — der Fehler schlägt die nächstliegende vor (didYouMean).
BOOK_NOT_FOUND 404 Kein Buch passt zum Slug, in keiner Sprache — der Fehler schlägt das nächstliegende vor (didYouMean).
CHAPTER_NOT_FOUND 404 Dieses Kapitel ist in dieser Übersetzung nicht verfügbar.
VERSE_NOT_FOUND 404 Der Vers oder Bereich liegt außerhalb des Kapitels.
INTERNAL_ERROR 500 Auf unserer Seite ist etwas schiefgegangen — Retry ist sicher.

4xx-Antworten werden je nach Determinismus des Fehlers 60 Sekunden bis 24 Stunden gecacht; 5xx nie, damit Retries immer den Origin erreichen.

Die 66 Bücher

Slugs funktionieren in jeder Sprache, mit oder ohne Bindestrich (2-samuel oder 2samuel). Klicke ein Buch für seine Metadaten.

Häufige Fragen

Ist das wirklich kostenlos? Brauche ich einen API-Key?

Ja. Keine Anmeldung, kein Key und kein Rate-Limit. Bitte beachten Sie ETags (If-None-Match liefert 304) und bündeln Sie Stellen mit /v1/passages statt einer Anfrage pro Vers.

Welche Übersetzungen gibt es?

107 Übersetzungen in 67 Sprachen, alle gemeinfrei oder unter freier Lizenz wie CC BY oder CC BY-SA. Die aktuelle Liste steht unter /v1/versions.

Warum gibt es keine NIV oder ESV?

Ihre Verlage behalten sich alle Rechte vor, daher verbreiten wir sie nicht weiter. Wer eine davon anfragt, erhält eine freie Übersetzung derselben Sprache, und data.version sagt, welche.

Was muss ich in meiner App anzeigen?

Die Quellenangabe der Übersetzung aus meta.copyright (oder copyright in /v1/votd und den Legacy-Routen), neben dem Text. Manche Lizenzen haben weitere Bedingungen, etwa Weitergabe unter gleichen Bedingungen (CC BY-SA) oder keine Änderungen am Text (CC BY-ND). Lesen Sie den vollständigen Text der gewählten Übersetzung.

Gibt es eine OpenAPI-Spezifikation?

Ja: /openapi.json (OpenAPI 3.1) und eine interaktive Referenz unter /docs. Für KI-Agenten gibt es das Bibel-MCP unter mcp.midvash.com.