▣ IMAGE PROCESSING · SMART GENERATION

Generate Bar Graph API

Hosted on ApyHub

What it does

The Bar Chart API turns a title and a list of labeled values into a PNG bar graph. Send a title and a data array of { label, value } items, and get back the image as a file from /download or as a pre-signed URL in the data field from /link.

Each bar can take its own color as a 6-character hex code without the #. Set theme to light or dark, and use options to control width, height, bar_width, spacing, axis font size and color, title styling, background padding, and canvas color. Pre-signed links expire after 15 minutes, so download or store the image if you need it longer.

Use the bar chart API to render revenue by region, signups by plan, or usage by feature for weekly reports, email digests, PDF invoices, and admin dashboards. It works as a server-side bar graph generator, so every chart comes out with the same styling and needs no browser or frontend charting library.

For values split into segments, use the Stacked Bar Chart API, and for shares of a whole, the Pie Chart API. Place the chart in a report with the HTML to PDF API, or turn it into a PDF page with the Image to PDF API. AI agents can generate these charts through ApyHub MCP.

▣ ENDPOINT 01 / 02

POST

Generate bar chart image

https://api.eu.apyhub.com/apyhub/generate-bar-graph/download

QUICKSTART

GUIDE

Quickstart

Generate a bar chart image from a minimal JSON payload.

curl -X POST "https://api.eu.apyhub.com/apyhub/generate-bar-graph/download?output=file" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Sales by Region",
    "data": [
      { "label": "North America", "value": 42000 }
    ]
  }' \
  -o bar-chart.png

What you'll get back

Returns the generated bar chart image as a binary file response.

The example above saves the downloaded file locally as bar-chart.png.

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates a bar chart image from the chart configuration in the request body and returns the image as binary data.

Request Body

Parameter	Type	Description
data	Object Array	Canonical list of bar values. Each item supports `label` and `value`, and may include `color`. Requires at least 1 item.
data[].color	String	6-character hex color without the leading `#` symbol.
data[].label	String	Bar label.
data[].value	Number	Bar value.
bars	Object Array	Alias for `data`. Deprecated. Use either `data` or `bars`, not both. Each item supports `label` and `value`, and may include `color`.
bars[].color	String	6-character hex color without the leading `#` symbol.
bars[].label	String	Bar label.
bars[].value	Number	Bar value.
theme	ENUM	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Chart title. Must be at least 1 character.
options	Object	Chart layout and styling options.
options.width	Integer	Chart width in pixels. Minimum: 1.
options.height	Integer	Chart height in pixels. Minimum: 1.
options.x_axis	Object	X-axis styling options.
options.x_axis.font_size	Number	Font size in pixels. Minimum: 1.
options.x_axis.font_color	String	6-character hex color without the leading `#` symbol.
options.y_axis	Object	Y-axis styling options.
options.y_axis.font_size	Number	Font size in pixels. Minimum: 1.
options.y_axis.font_color	String	6-character hex color without the leading `#` symbol.
options.spacing	Integer	Spacing in pixels. Minimum: 0.
options.bar_width	Integer	Bar width in pixels. Minimum: 1.
options.background	Object	Background styling options.
options.background.color	String	6-character hex color without the leading `#` symbol.
options.background.padding	Integer	Padding in pixels. Minimum: 0.
options.title_style	Object	Title styling options.
options.title_style.padding	Integer	Padding in pixels. Minimum: 0.
options.title_style.font_size	Number	Font size in pixels. Minimum: 1.
options.title_style.font_color	String	6-character hex color without the leading `#` symbol.
options.canvas_color	String	6-character hex color without the leading `#` symbol.

Response

Returns a binary response body containing the generated chart image.

Notes

bars is a deprecated alias for data. Use one or the other, not both.

▣ ENDPOINT 02 / 02

POST

Generate bar chart link

https://api.eu.apyhub.com/apyhub/generate-bar-graph/link

QUICKSTART

GUIDE

Quickstart

Generate a bar chart image from a small set of bar values.

curl -X POST "https://api.eu.apyhub.com/apyhub/generate-bar-graph/link?output=url" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Quarterly Sales by Region",
    "data": [
      { "label": "North America", "value": 42000, "color": "3B82F6" },
      { "label": "Europe", "value": 37500, "color": "10B981" },
      { "label": "Asia Pacific", "value": 28900, "color": "F59E0B" }
    ]
  }'

What you'll get back

Returns a JSON object with a data string field containing a pre-signed URL for the generated chart image.

{
  "data": "https://example.com/generated/charts/chart.png"
}

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Generates a bar chart link from the chart configuration in the request body and returns a JSON object containing a pre-signed URL for the generated chart image.

Request Body

Parameter	Type	Description
data	Object Array	Canonical list of bar values. Each item represents one bar and must include `label` and `value`; `color` is optional.
data[].color	String	6-character hex color without the leading `#` symbol.
data[].label	String	Label for the bar.
data[].value	Number	Numeric value for the bar.
theme	ENUM	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Chart title.
options	Object	Chart options. See the nested fields below.
options.width	Integer	Chart width in pixels. Minimum: 1.
options.height	Integer	Chart height in pixels. Minimum: 1.
options.x_axis	Object	X-axis label styling. See the nested fields below.
options.x_axis.font_size	Number	Font size in pixels. Minimum: 1.
options.x_axis.font_color	String	6-character hex color without the leading `#` symbol.
options.y_axis	Object	Y-axis label styling. See the nested fields below.
options.y_axis.font_size	Number	Font size in pixels. Minimum: 1.
options.y_axis.font_color	String	6-character hex color without the leading `#` symbol.
options.spacing	Integer	Spacing in pixels. Minimum: 0.
options.bar_width	Integer	Bar width in pixels. Minimum: 1.
options.background	Object	Background styling. See the nested fields below.
options.background.color	String	6-character hex color without the leading `#` symbol.
options.background.padding	Integer	Padding in pixels. Minimum: 0.
options.title_style	Object	Title styling. See the nested fields below.
options.title_style.padding	Integer	Padding in pixels. Minimum: 0.
options.title_style.font_size	Number	Font size in pixels. Minimum: 1.
options.title_style.font_color	String	6-character hex color without the leading `#` symbol.
options.canvas_color	String	6-character hex color without the leading `#` symbol.

Response

Returns a JSON object with a data string field containing a URI. This data value is a pre-signed URL for the generated chart image.

Parameter	Type	Description
data	String	Pre-signed URL for the generated chart image.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLGenerate Stacked Graph APIApyHub CALLGenerate Pie Chart APIApyHub CALLGenerate Donut Graph APIApyHub CALLGenerate Radar Chart APIApyHub

From the blog

Reads that touch this API.

Generate Barcode API vs Generate QR Code API: Full Comparison & Use CasesJul 9, 2026 Generating Video Thumbnails with ApyHub’s API (Go Guide)Aug 7, 2026 Generate Fast and Lightweight File Previews for docs, PDFs, DOCX, PPTX and more.Jul 9, 2026 Create Thumbnail for YouTube Using ApyHub APIJul 9, 2026