API Reference

Reference for the public GET endpoints below. Responses include JSON, text, binary files, SVG and event streams. No authentication required.

Base URL: https://api.lorm.pro

Endpoints

Lorem Ipsum Datasets Files Images Mock APIs Logs Events

Lorem Ipsum

Generate placeholder text with deterministic seeds.

GET/api/lorem

Generate lorem ipsum text.

Parameters

Name	Type	Description
`words`	number	Number of words to generate
`sentences`	number	Number of sentences to generate
`paragraphs`	number	Number of paragraphs to generate
`seed`	integer	Deterministic numeric seed for reproducible output

Example

curl "https://api.lorm.pro/api/lorem?words=50&seed=42"

# Returns an object with data (text) and meta (count, seed, generatedAt)

Datasets

Generate structured data in JSON, CSV, or NDJSON formats.

GET/api/dataset/:type

Generate records for users, products, orders, employees, companies, invoices or addresses.

Parameters

Name	Type	Description
`type`	path	Dataset type listed above
`rows`	integer	Number of records: 1–100000 (default: 10)
`format`	string	Output format: json, csv, ndjson, sql (default: json)
`seed`	integer	Deterministic numeric seed

Example

curl "https://api.lorm.pro/api/dataset/users?rows=2&format=json&seed=42"

# Returns a JSON array of two synthetic user records

Files

Stream dummy binary files of any size.

GET/api/dummy-file/:size

Stream a dummy binary file. Supports sizes from 1KB to 1GB.

Parameters

Name	Type	Description
`size`	path	File size: 1kb, 10kb, 100kb, 1mb, 10mb, 100mb, 1gb

Example

curl -o test.bin "https://api.lorm.pro/api/dummy-file/10mb"

# Downloads a 10MB binary file

Images

Generate SVG placeholder images with custom dimensions and colors.

GET/api/image/:dimensions

Generate an SVG placeholder image. Dimensions format: WIDTHxHEIGHT.

Parameters

Name	Type	Description
`dimensions`	path	Image dimensions, e.g. 400x300
`bg`	string	Background color hex (default: cccccc)
`color`	string	Text color hex (default: 666666)
`text`	string	Custom text overlay

Example

curl "https://api.lorm.pro/api/image/400x300?bg=0a0a0b&text=Hello"

<!-- Returns an SVG image -->

Mock APIs

Fake REST endpoints with realistic data and configurable behavior.

GET/api/mock/:resource

Returns synthetic records with pagination metadata.

Parameters

Name	Type	Description
`resource`	path	users, products, orders, employees, companies, invoices, addresses
`count`	integer	Simulated total count for pagination metadata (default: 10)
`seed`	integer	Deterministic numeric seed
`page`	number	Page number for pagination
`limit`	number	Items per page (default: 10)

Example

curl "https://api.lorm.pro/api/mock/users?limit=2&seed=42"

# Returns an object with data (records) and meta (pagination details)

Logs

Generate realistic log lines in various formats.

GET/api/logs/:type

Generate log lines in nginx, apache or syslog format.

Parameters

Name	Type	Description
`type`	path	Log format: nginx, apache, syslog
`lines`	integer	Number of lines: 1–100000 (default: 100)
`seed`	integer	Deterministic numeric seed

Example

curl "https://api.lorm.pro/api/logs/nginx?lines=3&seed=42"

192.168.1.42 - - [15/Mar/2026:04:20:00 +0000] "GET /api/users HTTP/1.1" 200 1234
10.0.0.15 - admin [15/Mar/2026:04:20:01 +0000] "POST /api/orders HTTP/1.1" 201 567
172.16.0.8 - - [15/Mar/2026:04:20:02 +0000] "GET /health HTTP/1.1" 200 15

Events

Server-Sent Events (SSE) streams for real-time testing.

GET/api/events

Open an SSE stream of generated events.

Parameters

Name	Type	Description
`types`	string	Comma-separated types: user_signup, purchase_completed, page_view, login, logout, error, api_call
`interval`	number	Interval between events in ms (default: 1000)
`count`	integer	Events before closing: 1–100 (default: 10)
`seed`	integer	Deterministic numeric seed

Example

curl -N "https://api.lorm.pro/api/events?types=page_view&interval=1000&count=3&seed=42"

# Returns three SSE messages with event, data and id fields