Exporting as PNG, PDF & SVG

1600

Chart export options

Once you're happy with the design of your visualization, you can publish it and/or export it as a PNG (free) or PDF/SVG (starting at the Custom plan), e.g. to embed it in presentations. In this tutorial, you'll learn how to do so with the API.

Request the export

The actual request is fairly simple. Make sure to replace <ID> and <YOUR_TOKEN_HERE> with your chart ID and your API Access Token:

curl --request GET \
     --url 'https://api.datawrapper.de/v3/charts/<ID>/export/png?unit=px&mode=rgb&plain=false&zoom=2&borderWidth=20' \
     --header "Authorization: Bearer <YOUR_TOKEN_HERE>" \
     --header 'accept: */*' \
     --output 'final.png'

The output gets saved in the folder where you run the command. Let's look at the request in detail, especially the url part.

Export parameters

As you can see, the URL includes all parameters with which we define the output. It looks complicated, but almost nothing is mandatory.

πŸ“˜

To save time, simply go to the API reference developer.datawrapper.de/v3.0/reference#getchartsidexportformat and you'll find an interface in which you can just input the desired parameters.

Let's break the URL down anyway. The parameters can be different depending on if you want to download a PNG, PDF or SVG. If unsure, visit the export interface of the visualization in the Datawrapper app (step 4: Publish) and see which features are available there. Scroll down to see the interfaces.

ParameterDescriptionPNGPDFSVG
.../export/pdfHere you define the output format.pngpdfsvg
unitDefines the unit in which the borderWidth, height and width will be measured in.pxpx inch mm--
modeWhich color mode the output should be in. Default is rgb.--rgb cmyk--
widthWidth of the visualization. If not specified, it takes the chart width. NumberNumberNumber
heightHeight of the visualization. If not specified, it takes the chart height. NumberNumberNumber
plainDefines if only the visualization should be exported (true), or if it should include header and footer as well (false).true falsetrue false--
zoomDefines the chart scale. E.g, a zoom of 3 makes the chart 3 times wider and taller in px size resulting in a higher resolution chart. Default is 2.Number----
scaleDefines the chart scale for PDF exports, similar to the zoom parameter for PNGs.--Number--
borderWidthMargin around the visualization. E.g., a borderWidth of 20px gives the visualization a 20px margin. Default is 0.NumberNumber--
borderColorColor of the border. Default is the same color as the visualization background (most often, that's white).ColorColor--
transparentSet to true to export your visualization with a transparent background. Will override borderColor.true false----