Embed worksheets in your site

Three ways to use Japaneseness worksheets in your own teaching site, blog, Moodle/Canvas course, or LMS.

Option 1: hotlink the PDF

Each worksheet has a stable URL. Link or iframe directly:

<a href="https://japaneseness.com/kanji/kanji_n5_001/">
  Practice the kanji 一
</a>

Best for: lesson plan PDFs, LMS pages, blog posts. License (CC BY-SA 4.0) requires attribution + a link to japaneseness.com.

Option 2: iframe the detail page

Embed a kanji detail page directly in an iframe:

<iframe
  src="https://japaneseness.com/kanji/kanji_n5_001/"
  width="100%" height="600"
  loading="lazy"
  title="Japaneseness: kanji 一"
></iframe>

The site sets no X-Frame-Options DENY header, so iframes work cross-origin. (We use security headers but allow embedding because the whole point is reuse.)

Option 3: JSON API

For dynamic integration with your own tools, we expose 3 read-only JSON endpoints. CORS open; no auth needed; rate limited by Cloudflare's generic protections.

Example fetch:

const data = await fetch("https://japaneseness.com/api/kanji.json")
  .then(r => r.json());
console.log(data.sheets[0]);
// → { id: "kanji_n5_001", label: "一", meaning_en: "one", on: [...], kun: [...], svg: "/kanji_svg/04e00.svg" }

Stable URLs you can rely on

Pattern Example
/kanji/{id}//kanji/kanji_n5_001/
/grammar/{id}//grammar/grammar_n5_001/
/kanji_svg/{code}.svg/kanji_svg/04e00.svg (raw KanjiVG)
/og/kanji/{id}.png/og/kanji/kanji_n5_001.png (1200x630 social card)

License reminder

Content is CC BY-SA 4.0. You can:

Hotlinking limits

We don't currently rate-limit hotlinks but ask that high-volume integrations cache server-side. If your site sees 10K+ daily pageviews, please give us a heads up at hello@japaneseness.com so we can help (Cloudflare-side allowlist, mirror, etc).