Entwickler-Schnittstelle

Die Blindtext-API

Manchmal ist der Browser-Generator eine Umleitung zu viel: Wer Platzhaltertext in Seeds, Fixtures, automatischen Tests oder direkt im Build-Prozess braucht, will ihn per Aufruf abholen – nicht kopieren. Genau dafür gibt es diese Schnittstelle: ein einzelner GET-Request, keine Anmeldung, kein API-Key, keine Kosten.

Die API nutzt exakt dieselben Wortlisten wie der Generator auf der Startseite. Was Sie dort sehen, bekommen Sie hier als JSON oder Reintext zurück.

Typografisches Schriftmuster mit Lorem-Ipsum-Text, Umlauten, Ziffern und Sonderzeichen

Endpunkt

GET https://loremipsum-generator.org/api

Parameter

type	Textart: lorem (Standard), german oder numbers
paragraphs	Anzahl der Absätze, 1–20 (Standard: 3)
words	alternativ: Gesamtzahl der Wörter, 1–2000 (hat Vorrang vor paragraphs)
format	json (Standard) oder text
start	1 = mit „Lorem ipsum dolor sit amet …“ beginnen (nur type=lorem)
kind	nur type=numbers: int (Standard), dec oder price
count	nur type=numbers: Anzahl der Werte, 1–100 (Standard: 10)
min / max	nur type=numbers: Wertebereich (Standard: 0 bis 1000)
locale	nur type=numbers: de (1.234,56 €) oder en ($1,234.56)

Beispiele

curl

curl "https://loremipsum-generator.org/api?type=german&paragraphs=2&format=text"

JavaScript (fetch)

const res  = await fetch("https://loremipsum-generator.org/api?type=lorem&words=120&start=1");
const data = await res.json();
console.log(data.text);

PHP

$json = file_get_contents("https://loremipsum-generator.org/api?type=numbers&kind=price&count=5&locale=de");
$data = json_decode($json, true);
print_r($data["paragraphs"]);

Antwortformat

{
  "source": "https://loremipsum-generator.org",
  "attribution": "Generated by loremipsum-generator.org – free to use.",
  "meta": { "type": "lorem", "paragraphs": 3 },
  "paragraphs": ["Lorem ipsum dolor …", "…", "…"],
  "text": "Lorem ipsum dolor …"
}

Jede JSON-Antwort enthält die Felder source und attribution als automatische Quellenangabe. Bei format=text steht die Quelle als letzte Zeile unter dem Text.

Fair-Use-Limit & CORS

Pro IP-Adresse sind 120 Anfragen je Stunde und 1.500 Anfragen pro Tag möglich. Für umfangreichere Testläufe sollten Sie diese Grenzen berücksichtigen. Wird ein Limit erreicht, antwortet die API mit Status 429 und einem Retry-After-Header. Die Header X-RateLimit-Limit und X-RateLimit-Remaining zeigen jederzeit den Stand des Stundenlimits. IPv6-Anfragen werden dabei pro /64-Netz gezählt, nicht pro Einzeladresse.

Die Schnittstelle ist per CORS für alle Origins freigegeben (Access-Control-Allow-Origin: *). Sie können sie also auch direkt aus dem Browser-JavaScript einer beliebigen Seite aufrufen. Größere Textmengen können Sie auch im Generator auf der Startseite erstellen. Die Erzeugung läuft dort direkt im Browser und beansprucht kein API-Kontingent.

Zum Generator