datawrapper

Create, configure, publish, and export Datawrapper charts and maps via the v3 REST API.

5|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/ondata/skills --skill datawrapper-ondata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: datawrapper
Source: https://github.com/ondata/skills/tree/main/skills/datawrapper
Command: npx skills add https://github.com/ondata/skills --skill datawrapper-ondata

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the manual Datawrapper UI work of building charts and maps by automating creation, data upload, configuration, publishing, exporting, and optional cleanup through the Datawrapper REST API.

Core Features & Use Cases

  • Chart creation via API: Create Datawrapper visualizations of supported chart types (bars, lines, scatter, pie/donut).
  • Map creation via API: Build choropleth maps and locator maps, including required basemap configuration and marker placement.
  • Reliable export workflow: Publish and then export a PNG with the required post-publish delay, plus visual verification guidance.
  • Metadata best practices: Add descriptive metadata and units-of-measure formatting so outputs are understandable and self-contained.
  • Common pitfalls & debugging: Provide guidance for the most frequent failures (e.g., missing axes for choropleths causing uniform colors).

Quick Start

Use the datawrapper skill to create and publish a choropleth map by calling the Datawrapper API with a valid DATAWRAPPER_API token and a CSV that includes the required geographic key and numeric value columns.

Frequently Asked Questions about datawrapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Datawrapper chart publishing from CSV data via API?

Automate Datawrapper chart publishing by using the v3 REST API to create visualizations, upload CSV data, configure metadata, and publish charts programmatically. This removes manual UI work and requires a valid Bearer API token stored in the DATAWRAPPER_API environment variable.

Why does my Datawrapper choropleth map render with uniform colors after publishing?

Datawrapper choropleth maps render with uniform colors when required axes metadata keys and values are missing. Correctly configuring basemap metadata and geographic keys in your API request ensures the numeric values map to the proper color scale.

Can I export a PNG from a Datawrapper chart immediately after publishing via API?

PNG exporting from a Datawrapper chart requires a publish-then-wait-then-export pattern. Waiting after the publish call avoids capturing stale renders, ensuring the exported PNG reflects the latest data and configuration.

Do I need an API token to create Datawrapper locator maps programmatically?

Creating Datawrapper locator maps programmatically requires a valid Bearer API token set in the DATAWRAPPER_API variable. The REST API uses this token to authenticate requests for basemap configuration, marker placement, and publishing.

What chart types can I generate using the Datawrapper REST API?

The Datawrapper REST API supports generating bar, line, scatter, and pie or donut charts, alongside choropleth and locator maps. Metadata best practices like units-of-measure formatting make these outputs self-contained and understandable.