API URL
GET /api/v1/lorem-ipsum (GET)
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
units
optional
string
What to count: words sentences or paragraphs (default paragraphs)
amount
optional
number
How many units to generate (default 3; caps 100 paragraphs / 1000 sentences / 10000 words)
length
optional
string
Size profile short medium long or verylong (default medium)
format
optional
string
Output format json text or html (default json)
startWithLorem
optional
boolean
Begin with canonical Lorem ipsum opening (default true)
seed
optional
string
Deterministic seed 1-64 chars A-Za-z0-9_- (same seed same output)
maxLength
optional
number
Hard character cap 1-100000 with word-boundary truncation; output is empty if no complete word fits
Example GET Request
Code
GET https://datpaq.com/api/v1/lorem-ipsum?units=paragraphs&amount=2&length=short&api_key=your-api-keySuccessful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"data": {
"text": "Lorem ipsum dolor sit amet…",
"paragraphs": [
"Lorem ipsum dolor sit amet…",
"Quis suscipit distinctio nam…"
],
"stats": {
"paragraphs": 2,
"sentences": 4,
"words": 31,
"characters": 209
},
"options": {
"units": "paragraphs",
"amount": 2,
"length": "short",
"startWithLorem": true,
"seed": null,
"maxLength": null,
"truncated": false
}
},
"metadata": {
"correlationId": "req_abc123",
"timestamp": "2026-10-14T12:00:00.000Z",
"processingTime": "1ms",
"api_token_name": null,
"rate_limit": {
"limit": null,
"remaining": null,
"reset": null
}
},
"updatedAt": "2026-10-14T12:00:00.000Z"
}Field
Type
success
boolean
data_text
string
data_paragraphs
array
data_stats_paragraphs
number
data_stats_sentences
number
data_stats_words
number
data_stats_characters
number
data_options
object
metadata
object
metadata_correlationId
string
metadata_timestamp
string
metadata_processingTime
string
metadata_api_token_name
string
metadata_rate_limit
object
status
string
service
string
version
string
error
object
details
array
correlationId
string
updatedAt
string
Error Response
Example
Code
HTTP 400 ValidationError: Invalid units/length/format amount over cap malformed seed maxLength out of range or unknown parameter — Request rejected before generation; HTTP 401 AuthenticationError: Gateway authentication failure — Request rejected due to missing or invalid API credentials; HTTP 404 NotFound: Unknown endpoint path — Request path does not map to available lorem-ipsum routes; HTTP 429 RateLimitError: More than 120 requests in 15 minutes — Request rejected by service rate limiter; HTTP 500 InternalError: Unexpected generation failure — Text generation could not completeLast Updated: May 4, 2026