✛ Images

Chart Renderer

Send labels and numbers, get back a chart you can drop into a report, an email, a slide or a chat reply. Thirteen types: column, bar, line, area, scatter, donut, pie, share bar, stat tile, sparkline, meter, heatmap and funnel. Six themes (light, dark, paper, slate, midnight, terminal) and six gradient backdrops that turn the chart into a share-ready card. Sizes for slides, squares, stories and link previews, PNG up to 3× or SVG. The details are handled for you: round axis numbers, labels placed so they do not overlap or run off the edge, colours that stay distinguishable for colour-blind readers, a highlight option that greys out everything but your point, goal lines, stacked and smooth variants. Latin, Greek and Cyrillic text.

Render one chart as PNG or SVG from JSON: column, bar, line, area, scatter, donut, pie, share, stat, sparkline, meter, heatmap or funnel.

POST/v1/chart
Try it free ↓
Price
$0.002 per chart · REST and MCP
RapidAPI
$0.0025 per chart · listing at launch
Returns
image/png
MCP tool
chart_renderer_render

Request body

FieldTypeDescription
typerequiredcolumn bar line area scatter donut pie share stat sparkline meter heatmap funnelThe kind of chart.
titlestringHeadline above the chart. Say what the reader should see, not just what is plotted.
subtitlestring—
captionstringSmall print under the chart, such as the source.
labelsstring[]Names along the axis, or of the slices, stages or heatmap columns.
seriesobject[]The data, one entry per series.
valuesnumber[]Shorthand for a single unnamed series.
valuenumberstat and meter: the number shown.
maxnumbermeter: what counts as full. Default 100.
deltanumberstat: change in percent against the last period, such as 12.4 or -3.
delta_labelstringstat: what the change is measured against, such as "vs last month".
lower_is_betterbooleanstat: a fall is the good direction (costs, errors, churn).
center_labelstringdonut: the word under the total. Default "total".
themelight dark paper slate midnight terminal—
backdropnone aurora sunset ocean dusk mint graphiteA gradient behind the chart, which then sits on it as a rounded card with a shadow.
colorsstring[]Your own series colours as hex, in order, replacing the theme's. Up to 8.
sizewide square portrait story og banner small—
widthintegerWidth in pixels, 240 to 2400. Give height too; together they replace size.
heightinteger—
scaleinteger2 or 3 for sharper PNGs on high-density screens. Default 1.
formatpng | svg—
stackedbooleanAdd the series up instead of placing them side by side (column, bar, area).
smoothbooleanCurved lines that never overshoot the data.
markersbooleanA dot on every point of a line. Default: on up to 24 points.
value_labelsbooleanPrint values on the marks. Default: on where they fit without clutter.
legendbooleanSet false to hide the legend.
y_minnumberStart of the value axis. Bars always include zero.
y_maxnumber—
prefixstringWritten before every number, such as "$" or "€".
suffixstringWritten after every number, such as "%" or " ms".
highlightstringThe one series (or, with a single series, the one label) to show in colour; the rest go grey.
goalnumberA reference line at this value, such as a target.
goal_labelstring—
sortbooleanOrder a single series from largest to smallest (column, bar).
example
curl https://readymadeapi.com/v1/chart \
  -H "Authorization: Bearer $READYMADE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "backdrop": "aurora",
    "labels": [
      "Jan",
      "Feb",
      "Mar",
      "Apr",
      "May",
      "Jun"
    ],
    "series": [
      {
        "name": "2025",
        "values": [
          42,
          48,
          51,
          49,
          58,
          63
        ]
      },
      {
        "name": "2026",
        "values": [
          61,
          70,
          74,
          79,
          85,
          96
        ]
      }
    ],
    "smooth": true,
    "theme": "midnight",
    "title": "Signups up 50% on last year",
    "type": "line"
  }' \
  -o out.png

Try it · 20 free runs a day across all APIs, reset at 00:00 UTC · $0.002 per chart with your key

No key yet? Get an API key · it works for every API.

Use it from an agent

Every endpoint above is also an MCP tool. Add the server to Claude, Cursor or any MCP client and the tools appear with their prices; calls draw from the same credit.

Connect guide · OpenAPI 3.1 spec · llms.txt

mcp config
{
  "mcpServers": {
    "readymade": {
      "type": "http",
      "url": "https://readymadeapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${READYMADE_KEY}"
      }
    }
  }
}