Getting Started

The Datawrapper API lets you programmatically interface with your charts. It lets you create and edit charts, update your account information, and build integrations – like a chart viewer, or a CMS integration that lets team members embed charts right from where they write their articles.

If anything is unclear, please contact us at support@datawrapper.de.

Pricing

Using the API is free for up to 500 Create operations, 1,000 Publish operations, and 3,000 Export operations per month. After that, you can keep using the API with flexible, credit-based billing. Find more information on our pricing page.

A quick note about CORS

The Datawrapper API is designed to be used in server-side scripts (or from a script on your computer). For security reasons, it is not possible to call the Datawrapper API from the browser. If you need to do that, you can build a proxy around the endpoints that you need to call from the browser.

To use the Datawrapper API, you'll need to provide a personal access token with every request. You can create a token at app.datawrapper.de/account/api-tokens.

To create your token, click the Create new Access Token button. This will open the option to give your token a name and to select which read/write access you want to give it:

For example, if you want to get information about your account, you'll need to select user:read. If you want to create charts and upload them in a folder, you'll need to select chart:read chart:write and folder:read
folder:write. You can find required scopes for different API requests in our API reference.

Only choose the scopes you need, not more – if your API token gets stolen without you knowing it, you'll be glad you didn't give it User or Auth write access. You can still change the scope later by clicking Edit.

After clicking Generate token, your token will appear:

You won't be able to see the token again after you refresh the page, so copy it to a secure location – like to your password manager.

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. You can revoke it at any time if you have any doubts about whether someone else got access to your API token.

Now you have an API access token. In all guides, replace the string <YOUR_TOKEN_HERE> with your own token. You can test it with the following command that allows you to access your account information. (Note: Make sure to checkuser:read when selecting scopes for your API token.)

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": "[email protected]",
  "name": "Lisa",
  ...
  "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.

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