The Datawrapper Developer Hub

Welcome to the Datawrapper developer hub. You'll find comprehensive guides and documentation to help you start working with the Datawrapper API 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, you'll need to provide a personal access token with every request. To create this token head to app.datawrapper.de/account/api-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. You will be able to enter a 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

Keep your token secret

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 about 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 \
  --header "Authorization: Bearer <YOUR_TOKEN_HERE>"

You should get a response body that looks similar to this JSON snippet:

{
  "id": 62982,
  "email": "lisacharlotterost@gmail.com",
  "name": "Lisa Charlotte Rost",
  ...
  "teams": [
    {
      ...
    }
  ],
  "products": [
    {
      ...
    }
  ],
  "chartCount": 1,
  "url": "/v3/users/1000"
}%

🎉 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

Updated 19 days ago

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.