API documentation

Everything served under /api/* is meant for quick automation or mock data consumption.

Back to home

Available endpoints

Method Endpoint Response Parameters Description
GET /api/usernames data: array of random usernames count (3-30, default 10) Handles with mild chaos.
GET /api/male-names data: array of male names count (3-30, default 6) Batch of male personas.
GET /api/female-names data: array of female names count (3-30, default 6) Batch of female personas.
GET /api/colors data: array of color swatches ({hex,rgb,css}) count (3-24, default 6) Hex + RGB + swatches.
GET /api/lorem data: array of lorem paragraphs count (1-15, default 3) Use for copy drafts.
GET /api/sentences data: array of sentences count (3-24, default 6) Punchy one-liners.
GET /api/user-agents data: array of user agent strings count (3-40, default 10) Browser + device UA strings for testing headers.
GET /api/uuids data: array of UUIDs count (1-20, default 6) Globally unique IDs.
GET /api/ipv4 data: array of IPv4 addresses count (1-100, default 5) Quick network IDs.
GET /api/ipv6 data: array of IPv6 addresses count (1-50, default 3) Longform network IDs.
GET /api/mac-addresses data: array of MAC addresses count (1-100, default 3) Hardware-level IDs.
GET /api/random-string data: array of random alphanumeric strings count (1-100, default 6); length (4-128, default 12) Custom length snippets.
GET /api/sha1-strings data: array of SHA-1 hex strings count (1-32, default 6) Fixed-length SHA-1 fingerprints for mock IDs.
POST /api/custom-random data: array (shuffled values) JSON body: { list: string, count?: number, unique?: boolean } Paste a list, choose count, and shuffle.
GET /api/gradient { gradient: string } None Copy the CSS for any gradient.
GET / POST /api/qr { text: string, dataUrl: string } text (default https://onlinegenerator.org); bg (hex color, default #ffffff) (GET query or POST JSON) Create a scannable QR with background control.
GET /api/barcode PNG image (Content-Type: image/png) text (default 012345678912); format (code128|code39|ean13|upca); bg (hex, default #ffffff) Generate and save Code 128, 39, EAN, or UPC.
GET /api/math-worksheet problems: array of { question, answer } count (4-30, default 12) Printable math worksheet questions
GET /api/random-wordsearch { grid: string[][], words: string[] } words (default 20) Wordsearch puzzle data
GET /api/random-sudoku { puzzle: number[][], solution: number[][] } None Random solved sudoku grid

Query parameters generally map to the generator cards; POST payloads expect JSON bodies unless noted otherwise.