▣ IMAGE PROCESSING · SMART GENERATION

Generate Bar Graph API

What it does

Simple Bar Chart generates bar chart images from a title and a list of bar values. Send title and data, where each item includes label and value; you can also include an optional color for each bar. Use theme to switch between light and dark, and fine-tune the output with options such as width, height, spacing, bar_width, background, title_style, x_axis, y_axis, and canvas_color.

Use POST /download when you want the rendered chart back as binary image data. Use POST /link when you want a pre-signed URL to the generated chart image. That makes this useful for dashboards, reports, admin panels, and internal tools that need charts without building chart rendering into the application.

Simple Bar Chart is a good fit when your data is already aggregated and you need a quick visual summary by category. A sales report, product comparison, regional breakdown, or usage snapshot can be turned into a shareable chart with just a few fields.

The request schema is strict: bar entries only accept label, value, and optional color, and options only accepts the documented layout and color settings. The response from /link is a single data URL field; /download returns the image itself.

▣ ENDPOINT 01 / 02

POST

Generate bar chart image

https://api.eu.apyverse.com/apyhub/generate-simple-bar-chart/download

QUICKSTART

GUIDE

Quickstart

Generate a simple bar chart image from a title and bar data.

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

What you'll get back

Returns a binary file stream (string with format: "binary"), which is the generated chart image.

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.

body*

bars

Alias for data. Use either data or bars, not both.

data*

Canonical list of bar values.

data-1*

color

6-character hex color without the leading # symbol.

label*

value*

theme

Chart theme.

title*

options

width

Chart width in pixels.

height

Chart height in pixels.

x_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

y_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

spacing

Spacing in pixels.

bar_width

Bar width in pixels.

background

color

6-character hex color without the leading # symbol.

padding

Padding in pixels.

title_style

padding

Padding in pixels.

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

canvas_color

6-character hex color without the leading # symbol.

output

About this endpoint

What it does

Generates a bar chart image from the request body and returns the rendered image as binary content. The chart is configured with a required title and bar data, plus optional styling and layout options.

Request Body

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

Response

Returns the chart image as a binary payload in the response body. The output schema is a binary string, so there is no JSON object wrapper or named response field to read.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 02 / 02

POST

Generate bar chart link

https://api.eu.apyverse.com/apyhub/generate-simple-bar-chart/link

QUICKSTART

GUIDE

Quickstart

Generate a simple bar chart image URL from a title and a list of bar values.

curl -X POST "https://api.eu.apyverse.com/apyhub/generate-simple-bar-chart/link" \
  -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 URI 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.

body*

bars

Alias for data. Use either data or bars, not both.

data*

Canonical list of bar values.

data-1*

color

6-character hex color without the leading # symbol.

label*

value*

theme

Chart theme.

title*

options

width

Chart width in pixels.

height

Chart height in pixels.

x_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

y_axis

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

spacing

Spacing in pixels.

bar_width

Bar width in pixels.

background

color

6-character hex color without the leading # symbol.

padding

Padding in pixels.

title_style

padding

Padding in pixels.

font_size

Font size in pixels.

font_color

6-character hex color without the leading # symbol.

canvas_color

6-character hex color without the leading # symbol.

output

About this endpoint

What it does

Generates a bar chart and returns a URL to the created chart image. The request body supplies the chart data, title, theme, and optional layout styling, and the response returns the generated image location.

Request Body

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

Response

Returns a JSON object with a data string field containing a URI for the generated chart image.

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

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ 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.