Interfaz para desarrolladores
La API de texto de relleno
A veces el generador del navegador es un desvío de más: quien necesita texto de relleno en seeds, fixtures, tests automáticos o directamente en el build quiere obtenerlo con una llamada, no copiarlo. Para eso existe este endpoint: una única petición GET, sin registro, sin API key, sin coste.
La API usa exactamente las mismas listas de palabras que el generador de la página de inicio. Lo que ve allí es lo que recibe aquí, como JSON o texto plano.
Endpoint
GET https://loremipsum-generator.org/api
Parámetros
| type | Tipo de texto: lorem (predeterminado), german o numbers |
| paragraphs | Número de párrafos, 1–20 (predeterminado: 3) |
| words | alternativa: número total de palabras, 1–2000 (tiene prioridad sobre paragraphs) |
| format | json (predeterminado) o text |
| start | 1 = empezar con «Lorem ipsum dolor sit amet …» (solo type=lorem) |
| kind | solo type=numbers: int (predeterminado), dec o price |
| count | solo type=numbers: número de valores, 1–100 (predeterminado: 10) |
| min / max | solo type=numbers: rango de valores (predeterminado: 0 a 1000) |
| locale | solo type=numbers: de (1.234,56 €) o en ($1,234.56) |
Ejemplos
curl
curl "https://loremipsum-generator.org/api?type=german¶graphs=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"]);
Formato de respuesta
{
"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 …"
}
Cada respuesta JSON contiene los campos source y attribution como crédito automático. Con format=text, la fuente aparece como última línea bajo el texto.
Límite de uso razonable & CORS
Cada dirección IP puede realizar 120 peticiones por hora y 1.500 peticiones al día, más que suficiente para tests y builds. Al alcanzar un límite, la API responde con el estado 429 y una cabecera Retry-After. Las cabeceras X-RateLimit-Limit y X-RateLimit-Remaining muestran en todo momento el estado del límite horario. Las peticiones IPv6 se cuentan por red /64, no por dirección individual.
El endpoint está abierto por CORS a todos los orígenes (Access-Control-Allow-Origin: *), así que puede llamarlo directamente desde el JavaScript de cualquier página. Y para volúmenes realmente grandes: el generador completo funciona de todos modos en el cliente; para la generación masiva, la página de inicio es la opción más rápida.