Get oEmbed information

GET
https://api.datawrapper.de/v3/oembed

Retreive embedding information about a Datawrapper visualization. See our oEmbed tutorial and the official oEmbed specification for more information.

Example Request

curl --request GET \
  --url 'https://api.datawrapper.de/v3/oembed?url=example-url&format=json&maxwidth=12345' \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'# 2 more query parameters available — see below.

Query Parameters

NameTypeAllowed valuesRequiredDescription
formatstringjson
Default: json
NoThe response format. Currenly only JSON is supported.
urlstringAny YesThe URL of the Datawrapper visualization you want to retreive embedding information
maxwidthintegerAny NoThe maximum width of the embedded visualization
maxheightintegerAny NoThe maximum height of the embedded visualization
iframebooleanAny NoForce iframe-only embedding

Response

FieldTypeRequiredDescription
typestringNo
versionstringNo
provider_namestringNo
provider_urlstringNo
titlestringNo
htmlstringNo
widthintegerNo
heightintegerNo