{
  "service": "data.placeholder.com/text",
  "version": "v1",
  "deterministic": "Same URL, same bytes, forever. Change ?seed= for different text.",
  "endpoints": {
    "/text/lorem": {
      "description": "Classic lorem ipsum.",
      "params": {
        "paragraphs | sentences | words | headlines": "count (or type=paragraph|sentence|word|headline&count=N)",
        "start": "classic (default, begins 'Lorem ipsum dolor sit amet') | random",
        "format": "plain (default) | html | markdown | json",
        "seed": "any string, default 0"
      },
      "limits": {
        "paragraph": {
          "default": 3,
          "max": 100
        },
        "sentence": {
          "default": 5,
          "max": 500
        },
        "word": {
          "default": 50,
          "max": 10000
        },
        "headline": {
          "default": 5,
          "max": 100
        }
      },
      "examples": [
        "https://data.placeholder.com/text/lorem",
        "https://data.placeholder.com/text/lorem?paragraphs=5&format=html",
        "https://data.placeholder.com/text/lorem?words=20&start=random&seed=42",
        "https://data.placeholder.com/text/lorem?sentences=3&format=json"
      ]
    },
    "/text/{lang}": {
      "description": "Realistic neutral website and product copy. Parallel corpus: the same seed gives the same content in every language, so layouts can be compared across locales.",
      "params": {
        "type": "paragraph (default) | sentence | headline | product | ui",
        "count": "number of items (or paragraphs= / sentences= / headlines= / products=)",
        "format": "plain (default) | html | markdown | json",
        "seed": "any string, default 0"
      },
      "limits": {
        "paragraph": {
          "default": 3,
          "max": 100
        },
        "sentence": {
          "default": 5,
          "max": 500
        },
        "headline": {
          "default": 5,
          "max": 100
        },
        "product": {
          "default": 3,
          "max": 100
        },
        "ui": {
          "default": 5,
          "max": 100
        }
      },
      "languages": [
        {
          "code": "en",
          "name": "English",
          "native": "English",
          "bcp47": "en",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/en"
        },
        {
          "code": "sv",
          "name": "Swedish",
          "native": "Svenska",
          "bcp47": "sv",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/sv"
        },
        {
          "code": "no",
          "name": "Norwegian (Bokmål)",
          "native": "Norsk bokmål",
          "bcp47": "nb",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/no"
        },
        {
          "code": "da",
          "name": "Danish",
          "native": "Dansk",
          "bcp47": "da",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/da"
        },
        {
          "code": "fi",
          "name": "Finnish",
          "native": "Suomi",
          "bcp47": "fi",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/fi"
        },
        {
          "code": "de",
          "name": "German",
          "native": "Deutsch",
          "bcp47": "de",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/de"
        },
        {
          "code": "nl",
          "name": "Dutch",
          "native": "Nederlands",
          "bcp47": "nl",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/nl"
        },
        {
          "code": "fr",
          "name": "French",
          "native": "Français",
          "bcp47": "fr",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/fr"
        },
        {
          "code": "es",
          "name": "Spanish",
          "native": "Español",
          "bcp47": "es",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/es"
        },
        {
          "code": "it",
          "name": "Italian",
          "native": "Italiano",
          "bcp47": "it",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/it"
        },
        {
          "code": "pt",
          "name": "Portuguese (Brazil)",
          "native": "Português",
          "bcp47": "pt-BR",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/pt"
        },
        {
          "code": "pl",
          "name": "Polish",
          "native": "Polski",
          "bcp47": "pl",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/pl"
        },
        {
          "code": "ar",
          "name": "Arabic",
          "native": "العربية",
          "bcp47": "ar",
          "dir": "rtl",
          "url": "https://data.placeholder.com/text/ar"
        },
        {
          "code": "he",
          "name": "Hebrew",
          "native": "עברית",
          "bcp47": "he",
          "dir": "rtl",
          "url": "https://data.placeholder.com/text/he"
        },
        {
          "code": "ja",
          "name": "Japanese",
          "native": "日本語",
          "bcp47": "ja",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/ja"
        },
        {
          "code": "zh",
          "name": "Chinese (Simplified)",
          "native": "简体中文",
          "bcp47": "zh-Hans",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/zh"
        },
        {
          "code": "ko",
          "name": "Korean",
          "native": "한국어",
          "bcp47": "ko",
          "dir": "ltr",
          "url": "https://data.placeholder.com/text/ko"
        }
      ],
      "aliases": {
        "nb": "no",
        "pt-br": "pt",
        "zh-hans": "zh",
        "zh-cn": "zh",
        "iw": "he"
      },
      "examples": [
        "https://data.placeholder.com/text/sv",
        "https://data.placeholder.com/text/de?type=headline&count=5",
        "https://data.placeholder.com/text/ja?type=product&format=json",
        "https://data.placeholder.com/text/ar?paragraphs=2&format=html"
      ]
    },
    "/text/stress": {
      "description": "Stress-test strings for layout, encoding and i18n bugs, with length metadata.",
      "kinds": {
        "long-words": "Long compound words, unbroken strings, long URLs, e-mails and paths",
        "rtl": "Right-to-left scripts, mixed bidirectional text and bidi controls",
        "cjk": "Chinese, Japanese (kanji, kana, half-width) and Korean, full-width forms, astral ideographs",
        "emoji": "ZWJ sequences, skin tones, flags, keycaps, presentation selectors, recent emoji",
        "names": "Person names from 1 to 100+ characters: apostrophes, hyphens, particles, diacritics, scripts",
        "combining": "Combining marks, NFC vs NFD, stacked diacritics, Zalgo-style overflow, Indic and Thai",
        "whitespace": "Zero-width characters, no-break and fixed-width spaces, line separators, control characters",
        "numbers": "Locale number, currency, date and time formats, plus floating-point traps",
        "casing": "Case-mapping traps: Turkish I, sharp s, final sigma, digraphs, ligatures",
        "confusables": "Look-alike characters: homograph domains, styled letters, dashes and quotes",
        "scripts": "Language names in 30 scripts for font-fallback and line-height checks",
        "pseudo": "Pseudo-localized UI strings (accented, ~35% longer, bracketed)"
      },
      "params": {
        "count": "first N entries per kind",
        "seed": "shuffle before taking count",
        "format": "json (default) | plain (one entry per line; some whitespace entries contain line breaks)"
      },
      "examples": [
        "https://data.placeholder.com/text/stress",
        "https://data.placeholder.com/text/stress/emoji",
        "https://data.placeholder.com/text/stress/names?format=plain",
        "https://data.placeholder.com/text/stress/rtl?count=5&seed=1"
      ]
    },
    "/text/pseudo": {
      "description": "Pseudo-localize your own text: accented look-alikes, about 30-40% longer, [bracketed]. Keeps {placeholders}, %s, <tags>, &entities;, URLs and e-mail addresses intact.",
      "params": {
        "text": "required for GET, max 4000 characters",
        "expand": "true (default) | false",
        "brackets": "true (default) | false",
        "format": "plain (default) | json"
      },
      "post": "POST the raw UTF-8 text as the body (max 65536 bytes); not cached",
      "examples": [
        "https://data.placeholder.com/text/pseudo?text=Add%20to%20cart",
        "https://data.placeholder.com/text/pseudo?text=Welcome%20back%2C%20%7Bname%7D!&format=json"
      ]
    }
  },
  "license": "Original text released as CC0; lorem ipsum is public domain (after Cicero). All synthetic."
}