Quick Start

szum turns JSON into publication-quality charts. One endpoint, no SDK, no API key needed to get started.

Your first chart

The smallest valid config – a version and one mark:

POST it and get back an SVG:

curl -X POST https://szum.io/chart \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version":"2026-03-20","marks":[{"type":"barY","data":[{"x":"Mon","y":120},{"x":"Tue","y":150},{"x":"Wed","y":180},{"x":"Thu","y":140},{"x":"Fri","y":200}]}]}'

Using Python, Go, Ruby, or another language? See Language Patterns.

Embed anywhere images work

Drop it into an <img> tag – no JavaScript, no library:

<img src='https://szum.io/chart?config={"version":"2026-03-20",...}' />

Works in emails, Notion, GitHub READMEs, Slack – anywhere images render.

Add a theme

One property transforms the entire visual identity – typography, colors, axes, grid:

Layer marks

Add a color dimension and a second mark type in the same config:

Marks compose freely – bars + rules, lines + dots, areas + text. Later marks draw on top.

Learn more