The Datawrapper Developer Hub

Welcome to the Datawrapper developer hub. You'll find comprehensive guides and documentation to help you start working with Datawrapper as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Getting started

A high level overview of Datawrapper's API and how to get going.

Datawrapper API lets you programatically interface with your charts. It lets you create and edit charts, update your account information and many more things to come. You can build a chart viewer and let editors embed charts right from where they are writing their articles, your CMS. Other integrations could invite new members to your Datawrapper team or export charts as images. There are a lot of possibilities and if you need any guidance or help, this documentation is for you. We are happy to know what you think of it or if anything is unclear, please contact us at support@datawrapper.de.

Authentication

To use the Datawrapper API it is important that you provide a personal access token with every request. To create this token head to app.datawrapper.de/account where you find a section about API Access Tokens.

Account section to generate API Access Token

Account section to generate API Access Token

To create your token hit the Create new Personal Access Token button and an input element will appear. There you can enter a comment or name for the token, to make it easier to remember what you use it for. After pressing Generate token, your token will appear right below.

Generated API Access Token

Generated API Access Token

It is very important that you keep your token safe and secure. Do not share it publicly or push it to Github. If you have any doubts if someone else got access to your API Access Token, you can revoke it at any time in our app and create a new one.

Requesting data

Now you have an API Access Token. In all guides, where you find the string <YOUR_TOKEN_HERE> you have to replace that with your own token. You can test it with the following command. :

curl --request GET \
  --url https://api.datawrapper.de/v3/me \
  -H "Authorization: Bearer <YOUR_TOKEN_HERE>"

You should get a successful response with status code 200 and a response body that looks similar to this JSON snippet.

{
  "id": 42,
  "email": "your-email@example.com",
  "name": null,
  "role": "editor",
  "language": "de_DE",
  "chartCount": 616,
  "url": "/v3/users/42"
}

🎉 That's it! You made your first request with the Datawrapper API! 🎉

Go ahead and build something amazing. We would love to hear about it!

Where to go from here

You can continue reading about HTTP and REST or go straight into our API documentation and see what endpoints exist and how to use them

Getting started


A high level overview of Datawrapper's API and how to get going.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.