oEmbed

oEmbed is a standard for embedding content of a given URL on third party sites. An oEmbed request takes the URL of the published chart as a parameter. For example, for the chart with the URL https://datawrapper.dwcdn.net/WpAbK/2/ it would look like this:

curl --request GET \
  --url https://api.datawrapper.de/v3/oembed?format=json&url=https%3A%2F%2Fdatawrapper.dwcdn.net%2FWpAbK%2F2%2F

The response contains the embed metadata and HTML:

{
  "type": "rich",
  "version": 1,
  "provider_name": "Datawrapper",
  "provider_url": "http://app.datawrapper.de",
  "title": "<strong>More than Earth can handle</strong>",
  "html": "<iframe title=\"More than Earth can handle\"...",
  "width": "600",
  "height": "500",
  "author_name": "Lisa Charlotte Rost"
}

The resulting html property can be used to render a chart in an interactive display.

Please note that by default, Datawrapper returns the responsive embed code of a chart, which contains an iFrame as well as a script tag. You can also request the iFrame-only version of a chart by passing in &iframe=true in the request url.

curl --request GET \
  --url https://api.datawrapper.de/v3/oembed?format=json&url=https%3A%2F%2Fdatawrapper.dwcdn.net%2FWpAbK%2F2%2F&iframe=true

{
  "type": "rich",
  "version": 1,
  "provider_name": "Datawrapper",
  "provider_url": "http://app.datawrapper.de",
  "title": "<strong>More than Earth can handle</strong>",
  "html": "<iframe src=\"//datawrapper.dwcdn.net/WpAbK/2/\" frameborder=\"0\" id=\"datawrapper-chart-WpAbK\" scrolling=\"no\" style=\"width: 0; min-width: 100% !important;\" height=\"500\"></iframe>",
  "width": "600",
  "height": "500",
  "author_name": "Lisa Charlotte Rost"
}