Pie Chart Generator

Pie Chart Generator

What it does

Pie Chart Generator turns a set of labeled values into a pie chart image or a shareable chart link. Send a required title and a data array, where each item includes label and value, and you can optionally add color for each slice. You can also set theme to light or dark and fine-tune options such as width, height, title_style, and canvas_color.

Use /download when you need a binary chart image for a report, dashboard export, email attachment, or generated asset pipeline. Use /link when you want a pre-signed URL to the generated chart image instead of the file itself. Both endpoints are built around the same chart inputs, so you can switch between a direct download and a hosted image without changing your chart data.

Pie Chart Generator is a fit for product mix charts, budget breakdowns, survey results, and other share-of-total visualizations. Each slice is defined by a label and non-negative value, so the output stays predictable and easy to render in downstream systems.

If you need a quick way to turn structured totals into a chart image, this service keeps the contract simple: define the title, pass the values, and get back either the image bytes or a URL to the generated chart.

curl -X POST "https://api.eu.apyverse.com/apyhub/generate-pie-chart/download" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Product Market Share", "data": [ { "color": "3B82F6", "label": "Product A", "value": 45 }, { "color": "10B981", "label": "Product B", "value": 30 }, { "color": "F59E0B", "label": "Product C", "value": 25 } ] }'

About this endpoint

What it does

Generates a pie chart image from the supplied chart data and returns the image as binary content. The request body defines the chart title, slices, theme, and optional rendering options.

Request Body

Parameter	Type	Mandatory	Description
data	Object Array	Yes	Chart slices. Each item must include `label` and `value`; `color` is optional.
data[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].label	String	Yes	Slice label.
data[].value	Number	Yes	Slice value. Must be greater than or equal to 0.
pies	Object Array	No	Alias for `data`. Deprecated. Use either `data` or `pies`, not both. Each item must include `label` and `value`; `color` is optional.
pies[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
pies[].label	String	Yes	Slice label.
pies[].value	Number	Yes	Slice value. Must be greater than or equal to 0.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title. Minimum length: 1.
options	Object	No	Rendering options for the chart.
options.width	Integer	No	Chart width in pixels. Minimum: 1.
options.height	Integer	No	Chart height in pixels. Minimum: 1.
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. Pattern: `^[A-Fa-f0-9]{6}$`.
options.canvas_color	String	No	Canvas color as a 6-character hex value without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.

Response

Returns a binary file response containing the generated pie chart image. The output schema is a binary string, so the success response is the image payload itself rather than a JSON object.

Parameter	Type	Mandatory	Description
binary	String	Yes	Generated pie chart image content returned as binary data.

curl -X POST "https://api.eu.apyverse.com/apyhub/generate-pie-chart/link?output=product-market-share-pie-chart" \ -H "apy-token: $APY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Product Market Share", "data": [ { "label": "Product A", "value": 45 }, { "label": "Product B", "value": 30 }, { "label": "Product C", "value": 25 } ] }'

About this endpoint

What it does

Generates a pie 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	Mandatory	Description
data	Object Array	Yes	Array of pie-slice objects. Each item must include `label` and `value`; `color` is optional.
data[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].label	String	Yes	Slice label.
data[].value	Number	Yes	Slice value. Minimum: `0`.
pies	Object Array	No	Deprecated alias for `data`. Use either `data` or `pies`, not both. Each item must include `label` and `value`; `color` is optional.
pies[].color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
pies[].label	String	Yes	Slice label.
pies[].value	Number	Yes	Slice value. Minimum: `0`.
theme	ENUM	No	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Yes	Chart title. Minimum length: `1`.
options	Object	No	Chart display options. Supports `width`, `height`, `title_style`, and `canvas_color`.
options.width	Integer	No	Chart width in pixels. Minimum: `1`.
options.height	Integer	No	Chart height in pixels. Minimum: `1`.
options.title_style	Object	No	Title styling options. Supports `padding`, `font_size`, and `font_color`.
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. Pattern: `^[A-Fa-f0-9]{6}$`.
options.canvas_color	String	No	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.

Response

Returns a JSON object with a data string field. The data value is a URI for the generated chart image, returned as a pre-signed URL.

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

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

Body

Name

Type

Description

bodyREQUIRED

object

—

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Query parameters

Body

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Query parameters

Body

Errors any endpoint can return