Placeholder text with main-character problemsREST API FAQ.
Call Rizz Ipsum from your own code with a plain HTTP GET. Here's the endpoint, params, limits, and copy-paste examples.
01 QUICK REFERENCE
Endpoint: GET https://mcp.rizzipsum.com/api (also /api/v1). No API key. CORS open (Access-Control-Allow-Origin: *).
| Param | Values | Default |
|---|---|---|
flavor | genz, alpha, genx, millennial | genz |
format | words, sentences, paragraphs | sentences |
count | 1-50 | 25 words / 3 sentences / 1 paragraph |
output | json, text | json |
JSON response fields: text, paragraphs (only for paragraphs format), flavor, format, count, wordCount, truncated, note (present only when truncated is true).
Rate limits: 30 requests/minute and 500/day per IP. Over-limit requests get a 429, and a Retry-After header is included when the app sends the limit response.
Errors are JSON with an error field: {"error":"invalid_param","message":"...","param":"flavor","allowed":[...]}. Codes used: 400 invalid_param, 405 method_not_allowed (anything other than GET or OPTIONS), 413 payload_too_large, 429 rate_limited.
curl
curl "https://mcp.rizzipsum.com/api?flavor=alpha&format=words&count=10"JavaScript fetch
const res = await fetch(
"https://mcp.rizzipsum.com/api?flavor=genx&format=sentences&count=3"
);
const data = await res.json();
console.log(data.text);02 THE QUESTIONS
01What is the Rizz Ipsum REST API?
A plain HTTP GET endpoint at https://mcp.rizzipsum.com/api (also available at /api/v1) that returns rizz-flavored placeholder text as JSON or plain text. No API key, no signup, CORS open.
02What query parameters does it accept?
flavor — genz, alpha, genx, or millennial.format — words, sentences, or paragraphs.count — 1 to 50.output — json or text (default json).
03What does the JSON response look like?
It includes text, paragraphs (only when format=paragraphs), flavor, format, count, wordCount, truncated, and note.
04Is the REST API free?
Yes. No API key is needed. It's free, with the same 200-word cap as the MCP server.
05What are the rate limits?
30 requests per minute and 500 per day, per IP. Over-limit requests get a 429, and a Retry-After header is included when the app sends the limit response.
06Why did my generated text get cut off?
The API caps output at 200 words per request, same as the MCP server. The website generator does not have this cap. Ask for fewer words, sentences, or paragraphs.
07What do the error responses look like?
JSON with an error field, for example:
{
"error": "invalid_param",
"message": "...",
"param": "flavor",
"allowed": [...]
}Codes used: 400 invalid_param for a bad query value, 405 method_not_allowed for anything other than GET or OPTIONS, 413 payload_too_large, and 429 rate_limited when you've hit the limit.
Prefer an AI agent instead?
Read the MCP Server FAQ