Getting Started

What is yaddayadda.io?

yaddayadda.io is an AI-powered placeholder text generator. Unlike traditional lorem ipsum, it generates contextually relevant, funny, personality-driven text that matches your project.

A fintech mockup gets fintech-sounding copy. A food blog gets mouth-watering filler. A legal page gets legalese that says absolutely nothing.

Two Ways to Use It

Free — Yadda Ipsum (No Key Required)

Hit the API with no authentication and get structured placeholder text instantly. Same JSON shape as AI-generated content, but filled with our signature Yadda Ipsum nonsense text. Zero cost. No limits (besides 1,000 requests/day per IP).

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

AI-Powered (Free Key Required)

Add a topic and/or tone parameter with an API key, and the same endpoint returns AI-generated content that matches your context. Same JSON structure — just smarter content.

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

const res = await fetch(
  'https://api.yaddayadda.io/v1/generate?template=hero_section&topic=fintech&tone=corporate_buzzword',
  { headers: { Authorization: 'Bearer yda_live_your_key_here' } }
);
const { data } = await res.json();
console.log(data.headline);
// → "Your Finances, Finally Untangled"

Quick Start

1. Try it free — no key needed for Yadda Ipsum:

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

2. Get an API key — sign up at yaddayadda.io/dashboard/api for 500 free AI generations per month.

3. Add intelligence — same endpoint, same JSON shape, just add topic and tone:

   curl "https://api.yaddayadda.io/v1/generate?template=pricing_table&topic=project+management+saas&tone=startup_pitch&tiers=3" \
     -H "Authorization: Bearer yda_live_your_key_here"

4. Explore templates — 27 structured UI component templates. See the Templates section.

5. Try the playground — test any endpoint configuration directly in your browser with the API Playground.

Base URL

https://api.yaddayadda.io/v1

Response Envelope

Every response follows the same format, regardless of template or generation mode:

{
  "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_abc123",
    "model": null,
    "tokens_used": null,
    "cached": true
  }
}