Integration Guide

API Docs & URL Parameters

Random Sentence Generator does not expose a public server API. Instead, the browser app uses query parameters, preset routes, export formats and share links so you can reproduce batches without managing credentials.

Use this page when you want stable URLs for presets, internal links, documentation or QA checks across the main generator routes.

Public Interface

What is available

The public app supports preset routes, sharable query strings, CSV/TXT/JSON/MD exports, image-card export and local browser storage for favorites, collections and history.

There is no authentication layer, no paid tier and no remote sentence generation endpoint. All generation happens in the browser from bundled word banks and templates.

Example URL

Recreate a preset with query params

https://randomsentencegenerator.org/?category=funny&type=compound&quantity=8&length=medium&tense=any&style=casual&vocabulary=mixed

Visiting a URL like this loads the matching controls automatically. The generator also updates the query string when you change settings, which makes it easy to bookmark or share exact presets.

Query Parameters

Supported keys on the main generator routes

ParameterAccepted values
categoryrandom | funny | inspirational | academic | mystery | scifi | romance | horror
typesimple | compound | complex
quantity1-50
lengthshort | medium | long
tenseany | past | present | future
styleformal | casual | poetic
vocabularybasic | advanced | mixed
nounscomma-separated custom nouns, up to 12
verbscomma-separated custom verbs, up to 12
adjectivescomma-separated custom adjectives, up to 12

Preset Routes

Stable entry points for different sentence jobs

Export & Share

Ways to move output around

Use the export hub to download the current batch as .txt, .csv, .json or .md, or create an image card from the current result set.

Share links preserve the current generator settings in the URL. Shared collections use the /share/collection?data=... route and stay marked noindex so they do not compete with core pages in search results.

Saved favorites, collections and history are stored in localStorage only. There is no remote sync endpoint, so browser data stays on the device unless you export it yourself.