Can I generate a fixed number of words or paragraphs?
Yes. Pass units=words, units=sentences, or units=paragraphs plus amount. Caps are 10000 words, 1000 sentences, and 100 paragraphs.
Lorem Ipsum API
Words to Paragraphs
Seeded Output
JSON / HTML
Placeholder text. On demand.
Exact counts of words, sentences, or paragraphs, with length profiles and optional seeds so the same fixture comes back every time.
3 units · words, sentences, paragraphsSeed · reproducibleJSON / text / HTML · formatsmaxLength · word-boundary cap
Generate placeholder copy, instantly.
This calls the live Lorem Ipsum API. Pick units, amount, and length, then preview the generated text.
Request builder
Units and amount in, placeholder text out.
GET /lorem-ipsum
Deterministic fixtures
The same seed, units, amount, and length always return the same copy. The live demo caps paragraphs at 5.
Output preview
Live response from the API, plus the exact request to reproduce it.
Generating placeholder text...
Why Lorem Ipsum API
Placeholder text that behaves.
Words, sentences, or paragraphs
Count exactly what you need. amount plus units gives fixtures that fit mockups and tests.
Four length profiles
short, medium, long, and verylong change sentence and paragraph size without extra client logic.
Deterministic seeds
Pass seed and the same request always returns the same Latin. Built for snapshot and visual-regression tests.
JSON, text, or HTML
Structured stats by default, or raw plain text and <p>-wrapped HTML that drop straight into templates.
Word-boundary maxLength
Truncate at a complete word and get options.truncated so layouts never overflow.
Classic opening on request
startWithLorem prepends Lorem ipsum dolor sit amet when you want the familiar lead-in.
/api/v1/lorem-ipsum
Endpoints, at a glance.
One GET generates JSON, plain text, or HTML placeholder copy, with an optional seed for reproducible fixtures.
GET/api/v1/lorem-ipsum
Generate text
Placeholder text by words, sentences, or paragraphs, with length, seed, format, and maxLength options.
GET/api/v1/lorem-ipsum/generate
Generate alias
Same contract as the primary GET, useful for clients that prefer an explicit generate path.
| Parameter | Type | Required | Description |
|---|---|---|---|
| units | string | no | words, sentences, or paragraphs. Defaults to paragraphs. |
| amount | integer | no | How many units to generate. Caps: 100 paragraphs, 1000 sentences, 10000 words. |
| length | string | no | short, medium, long, or verylong. Defaults to medium. |
| format | string | no | json, text, or html. Defaults to json. |
| seed | string | no | 1-64 chars A-Za-z0-9_-. Same seed, same output. |
| maxLength | integer | no | Hard character cap with word-boundary truncation. |
| startWithLorem | boolean | no | Begin with the canonical Lorem ipsum opening. Defaults to true. |
Error reference
Failures you can plan for.
Every JSON response includes a success flag and a correlationId for tracing.
400Validation Error
Invalid units, length, format, amount over cap, malformed seed, or unknown parameter.
401Authentication Error
Missing or invalid gateway API key. Send x-api-key or api_key with every request.
404Not Found
Unknown route under /api/v1/lorem-ipsum.
429Rate Limit Error
More than 120 requests in a 15-minute window.
500Internal Error
Text generation could not complete.
Example error response
{
"success": false,
"error": { "code": "VALIDATION_ERROR", "message": "Invalid query parameters" },
"correlationId": "1784849006651-mgh1kq42p"
}FAQ
API questions developers ask first.
How do I make the same text come back every time?
Pass seed with 1-64 characters of A-Z, a-z, 0-9, underscore, or hyphen. The same seed and options always produce the same text.
Can I get raw HTML or plain text instead of JSON?
Set format=html for <p>-wrapped paragraphs or format=text for a raw body. JSON (the default) returns text, a paragraphs array, and stats.
What does maxLength do?
maxLength truncates at a word boundary and sets options.truncated to true so layouts never overflow. If no complete word fits, the text is empty.
How do I authenticate requests?
Send your Datpaq API key as an x-api-key header or an api_key query parameter. Keys are created in the Datpaq dashboard and a free tier is included.
Add placeholder copy in one request.
Words, sentences, or paragraphs with length profiles and optional seeds so fixtures stay stable across environments.