▣ SMART GENERATION

Generate Pie Chart API

Hosted on ApyHub

What it does

Pie Chart Generator turns your labeled values into a pie chart image. Send a title, a data array, and optional styling options, and get back a pre-signed URL for the rendered chart or a binary image download.

Each data item can include a label, value, and optional hex color. The request also supports a light or dark theme, plus chart options for width, height, title styling, and canvas color. Use the deprecated pies alias only if you need to match an older integration; data is the primary field.

Use Pie Chart Generator when you need a shareable visual for product mix, budget allocation, survey results, or any other part-to-whole breakdown. It is a good fit for dashboards, reports, admin panels, and automated content pipelines where the chart needs to be generated from API data instead of drawn in the browser.

The response is simple to work with: one endpoint returns a URL in data, and the other returns the image as binary output. That keeps the integration lightweight whether you want to store the image, embed it, or hand it off to another service.

▣ ENDPOINT 01 / 02

POST

Generate pie chart link

https://api.eu.apyhub.com/apyhub/generate-pie-chart/link

QUICKSTART

GUIDE

Quickstart

Create a pie chart from a title and slice data, and get back a URL to the generated image.

curl -X POST "https://api.eu.apyhub.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, "color": "3B82F6" },
      { "label": "Product B", "value": 30, "color": "10B981" },
      { "label": "Product C", "value": 25, "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.

About this endpoint

What it does

Generates a pie chart and returns a pre-signed URL for the rendered chart image. The request body lets you provide the chart data, title, theme, and optional sizing/style settings.

Request Body

Parameter	Type	Description
data	Object Array	Pie chart slices. Each item must include `label` and `value`; `color` is optional. Use `data` or the deprecated `pies` alias, but not both.
data[].color	String	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].label	String	Slice label.
data[].value	Number	Slice value. Minimum: 0.
pies	Object Array	Deprecated alias for `data`. Use either `data` or `pies`, not both. Each item has the same shape as `data[]`.
pies[].color	String	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
pies[].label	String	Slice label.
pies[].value	Number	Slice value. Minimum: 0.
theme	ENUM	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Chart title. Must be at least 1 character long.
options	Object	Optional chart layout and styling settings.
options.width	Integer	Chart width in pixels. Minimum: 1.
options.height	Integer	Chart height in pixels. Minimum: 1.
options.title_style	Object	Title styling settings.
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. Pattern: `^[A-Fa-f0-9]{6}$`.
options.canvas_color	String	Canvas color as a 6-character hex value without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.

Response

Returns a JSON object with a data string field containing a URI. The 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.

▣ ENDPOINT 02 / 02

POST

Generate pie chart image

https://api.eu.apyhub.com/apyhub/generate-pie-chart/download

QUICKSTART

GUIDE

Quickstart

Generate a pie chart file from a simple title and slice data, and name the output with the output query parameter.

curl -X POST "https://api.eu.apyhub.com/apyhub/generate-pie-chart/download?output=product-market-share-pie-chart" \
  -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}]}'

What you'll get back

Returns the raw PNG bytes (image/png), which you can save directly to disk — add -o chart.png to the curl command above.

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 pie chart image from the chart configuration in the request body and returns the rendered image as binary output. The request must include the chart title and data, and can also include optional styling and sizing options.

Request Body

Parameter	Type	Description
data	Object Array	Pie chart slices. Each item must include `label` and `value`; `color` is optional.
data[].color	String	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
data[].label	String	Slice label.
data[].value	Number	Slice value. Must be greater than or equal to 0.
pies	Object Array	Deprecated alias for `data`. Use either `data` or `pies`, not both. Each item must include `label` and `value`; `color` is optional.
pies[].color	String	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
pies[].label	String	Slice label.
pies[].value	Number	Slice value. Must be greater than or equal to 0.
theme	ENUM	Chart theme. Allowed values: `light`, `dark`. Default: `light`.
title	String	Chart title. Minimum length: 1.
options	Object	Optional rendering options. Includes `width`, `height`, `title_style`, and `canvas_color`.
options.width	Integer	Chart width in pixels. Must be greater than or equal to 1.
options.height	Integer	Chart height in pixels. Must be greater than or equal to 1.
options.title_style	Object	Title styling options. Includes `padding`, `font_size`, and `font_color`.
options.title_style.padding	Integer	Padding in pixels. Must be greater than or equal to 0.
options.title_style.font_size	Number	Font size in pixels. Must be greater than or equal to 1.
options.title_style.font_color	String	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.
options.canvas_color	String	6-character hex color without the leading `#` symbol. Pattern: `^[A-Fa-f0-9]{6}$`.

Response

Returns the rendered chart as a binary PNG image (image/png). Use the output query parameter to name the file; the .png extension is added for you.

▣ 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 Donut Graph APIApyHub CALLGenerate Bar Graph APIApyHub CALLGenerate Stacked Graph APIApyHub CALLGenerate Radar Chart APIApyHub

From the blog

Reads that touch this API.

Generating Video Thumbnails with ApyHub’s API (Go Guide)Aug 7, 2026 Generate Barcode API vs Generate QR Code API: Full Comparison & Use CasesJul 9, 2026 Link Preview API: Safe Link Previews Without Building a ScraperAug 5, 2026 Generating Thumbnails from Videos : A step-by-step guide in NodeJSJul 9, 2026