Docs

Your first chart URL in three steps

No SDK, no signup: a chart is a URL that returns a PNG. Everything below works with a plain curl, an <img> tag or any HTTP client.

1. Build the URL

Start with the endpoint and add legacy parameters:

https://urlchart.com/chart?cht=bvg&chs=400x200&chd=t:10,40,80&chxt=y

cht=bvg is vertical grouped bars, chs=400x200 the image size, chd=t:… the data and chxt=y one y axis. Open it in a browser tab and you have the image.

2. Add a key when you need production limits

Without a key you get the free tier: watermarked, 60 requests/minute, 1,000 unique renders per month. With a paid subscription you get a key; add it as a query parameter (or send it as a bearer token):

https://urlchart.com/chart?cht=bvg&chd=t:10,40,80&key=uc_live_…

The key is removed from the origin request and from the cache key, so a paid and a free request for the same chart are the same chart with different watermark variants. If a key is malformed or revoked you get 401 JSON — a broken key is an error you can see, not a silent watermark.

3. Embed it

<img src="https://urlchart.com/chart?cht=bvg&chd=t:10,40,80"
     width="400" height="200" alt="Quarterly signups">

Set width and height to chs so the page does not reflow. That is the whole integration.

Cache behaviour

Errors and limits

JSON charts

POST /chart also accepts a Chart.js configuration body and returns a PNG. That path is for callers who already hold Chart.js JSON; the legacy parameter endpoint above is the compatibility surface. POST /gchart is rejected — /gchart is GET-only by contract.