Generate Endpoint

Endpoint

GET /v1/generate

This single endpoint handles everything — paragraphs, templates, Yadda Ipsum, AI generation. Try it live in the API Playground.

Parameters

Parameter	Type	Default	Description
`template`	string	`paragraphs`	Which component template to use
`topic`	string	—	What the content should be about, e.g. `fintech startup`, `restaurant booking app` (triggers AI, requires key)
`tone`	string	—	Tone preset ID (triggers AI, requires key)
`count`	integer	varies	Number of items for templates with repeating elements. Valid range depends on template; values outside range are clamped. See Templates for limits.
`tiers`	integer	3	Number of pricing tiers (only for `pricing_table`)
`paragraphs`	integer	3	Number of paragraphs (only for `paragraphs` template)
`sentences`	integer	—	Number of sentences (overrides paragraphs)
`words`	integer	—	Approximate word count target
`insanity`	integer	3	How far the tone leans into its personality, from 1 (dry) to 5 (unhinged). See Insanity Level.
`format`	string	`json`	Output format: `json`, `html`, `md`, `text`
`locale`	string	`en`	Language code for Yadda Ipsum or AI generation

Request Logic

The API determines what to do based on which parameters are present:

No topic, no tone, no API key → Returns Yadda Ipsum (static, free)
No topic, no tone, with API key → Returns Yadda Ipsum (static, free — key ignored)
topic and/or tone present, with API key → Returns AI-generated content (counts against quota)
topic and/or tone present, no API key → Returns 401 with message explaining AI generation requires a free API key

Examples

Basic Paragraphs (Yadda Ipsum)

curl "https://api.yaddayadda.io/v1/generate?paragraphs=2"

{
  "template": "paragraphs",
  "format": "json",
  "source": "yadda_ipsum",
  "locale": "en",
  "data": {
    "paragraphs": [
      "Yadda yadda ipsum dolor bla amet, consectetur blabbering elit...",
      "Mumbo jumbo dolor sit amet, consectetur shenanigatus elit..."
    ]
  },
  "meta": {
    "generation_id": "gen_abc123",
    "model": null,
    "tokens_used": null,
    "cached": true
  }
}

Hero Section (Yadda Ipsum)

curl "https://api.yaddayadda.io/v1/generate?template=hero_section"

{
  "template": "hero_section",
  "format": "json",
  "source": "yadda_ipsum",
  "locale": "en",
  "data": {
    "headline": "Yadda yadda ipsum dolor bla amet",
    "subheadline": "Sed do eiusyadda tempor incididunt ut labore",
    "body": "Mumbo jumbo dolor sit amet...",
    "cta_primary": "Yaddayadda me",
    "cta_secondary": "Bla bla bla"
  },
  "meta": {
    "generation_id": "gen_def456",
    "model": null,
    "tokens_used": null,
    "cached": true
  }
}

AI-Generated Hero Section

curl "https://api.yaddayadda.io/v1/generate?template=hero_section&topic=fintech+startup&tone=corporate_buzzword" \
  -H "Authorization: Bearer yda_live_your_key_here"

{
  "template": "hero_section",
  "format": "json",
  "source": "ai_generated",
  "locale": "en",
  "data": {
    "headline": "Your Finances, Finally Untangled",
    "subheadline": "Leveraging next-generation blockchain synergies to disrupt your portfolio paradigm",
    "body": "At the intersection of innovation and fiscal responsibility lies a platform that transforms the way you think about money. Which is to say, it does something with numbers.",
    "cta_primary": "Synergize Now",
    "cta_secondary": "Schedule a Deep Dive"
  },
  "meta": {
    "generation_id": "gen_ghi789",
    "model": "gemini-2.5-flash",
    "tokens_used": 284,
    "cached": false
  }
}

Features Grid with Count

curl "https://api.yaddayadda.io/v1/generate?template=features_grid&count=4&topic=project+management&tone=startup_pitch" \
  -H "Authorization: Bearer yda_live_your_key_here"

Plain Text Output

curl "https://api.yaddayadda.io/v1/generate?paragraphs=3&format=text"

Returns plain text with Content-Type: text/plain:

Yadda yadda ipsum dolor bla amet, consectetur blabbering elit...

Mumbo jumbo dolor sit amet, consectetur shenanigatus elit...

Bla bla bla ut enim ad minima yaddiam...

HTML Output

curl "https://api.yaddayadda.io/v1/generate?template=hero_section&format=html"

Returns semantic HTML with Content-Type: text/html:

<section class="hero-section">
  <h1>Yadda yadda ipsum dolor bla amet</h1>
  <p class="subheadline">Sed do eiusyadda tempor incididunt ut labore</p>
  <p>Mumbo jumbo dolor sit amet...</p>
  <a class="cta-primary" href="#">Yaddayadda me</a>
  <a class="cta-secondary" href="#">Bla bla bla</a>
</section>

On this page