{"id":13857653,"url":"https://github.com/munichrocker/DatawRappr","last_synced_at":"2025-07-13T22:30:46.466Z","repository":{"id":40689259,"uuid":"217085284","full_name":"munichrocker/DatawRappr","owner":"munichrocker","description":"R-Package to connect to the Datawrapper-API","archived":false,"fork":false,"pushed_at":"2024-03-18T11:50:56.000Z","size":1503,"stargazers_count":84,"open_issues_count":8,"forks_count":12,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-08-06T03:04:11.581Z","etag":null,"topics":["data-visualization","datawrapper","datawrapper-api","r"],"latest_commit_sha":null,"homepage":"https://munichrocker.github.io/DatawRappr/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/munichrocker.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2019-10-23T15:00:55.000Z","updated_at":"2024-05-08T14:38:37.000Z","dependencies_parsed_at":"2024-03-18T13:03:06.818Z","dependency_job_id":null,"html_url":"https://github.com/munichrocker/DatawRappr","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munichrocker%2FDatawRappr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munichrocker%2FDatawRappr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munichrocker%2FDatawRappr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/munichrocker%2FDatawRappr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/munichrocker","download_url":"https://codeload.github.com/munichrocker/DatawRappr/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225920428,"owners_count":17545492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-visualization","datawrapper","datawrapper-api","r"],"created_at":"2024-08-05T03:01:43.200Z","updated_at":"2024-11-22T15:31:02.689Z","avatar_url":"https://github.com/munichrocker.png","language":"R","funding_links":[],"categories":["R"],"sub_categories":[],"readme":"# DatawRappr \u003cimg src=\"man/figures/logo.png\" align=\"right\" /\u003e\n\nThe goal of DatawRappr is to provide a wrapper for Datawrapper's API to connect data from R directly with Datawrapper's charts capabilities. It uses the new [API version 3.0](https://developer.datawrapper.de/v3.0/docs).\n\n## Key features:\n\n* Manages and automatically retrieves the API-key locally via `datawrapper_auth()`\n* Creates, deletes or publishes charts on Datawrapper\n* Sends Dataframes from R directly to Datawrapper - without having to copy them in - with `dw_data_to_chart()`\n\nAll functions (except `datawrapper_auth()`) are preceded by `dw_`:\n\n* allows test calls to the API via `dw_test_key()`\n* lists all created charts: `dw_list_charts()`.\n* lists all folders: `dw_list_folders()`.\n* creates a new Datawrapper chart via `dw_create_chart()`\n* copy a existing chart with: `dw_copy_chart()`\n* adds data from a R-dataframe to an existing Datawrapper chart via `dw_data_to_chart()`\n* retrieves (`dw_retrieve_chart_metadata()`) or edits metadata, description and visualization of an existing chart via `dw_edit_chart()`\n* publishes and republishes a Datawrapper chart via `dw_publish_chart()`\n* deletes an Datawrapper chart via `dw_delete_chart()`\n* exports a chart as png, pdf or svg (latter two only in paid accounts) with `dw_export_chart()`\n\n## Installation\n\nRight now this package is experimental and only available on Github:\n\n```{r}\n# install.packages(\"devtools\") # if not already installed on your system\ndevtools::install_github(\"munichrocker/DatawRappr\")\n```\n\n## Usage\n\nAdd the package to your environment by running: \n\n```{r}\nlibrary(DatawRappr)\n```\n\n### Setting up the API-key\n\nTo use the API you have to create an API key on Datawrapper.\n\nClick on **Dashboard** - **Settings** and move down to the section that says **API Access Tokens**.\n\nClick on **Create new personal access token**, enter a name and save the token:\n\n![](man/figures/gif_api_key.gif)\n\nCopy the API key in the clipboard and use\n\n```{r}\ndatawrapper_auth(api_key = \"12345678\")\n```\n\nto save the key to our system. If a key already exists, you may add the argument `overwrite = TRUE` to `datawrapper_auth()`.\n\nTo make sure, your key is working as expected, you can run\n\n```{r}\ndw_test_key()\n```\n\nwith no arguments. It will then use the saved key from the environment. If the key is correct, you will receive a response from the API with personal details about your account - a `dw_user`-object that has no further use than to check your key.\n\nNote: If you want to see your currently saved API key, you may use the helper function `dw_get_api_key()`.\n\nCongratulations, you're good to go!\n\n## Under the hood\n\nThis package makes heavy use of the [`httr`](https://github.com/r-lib/httr)-package, which on itself is a wrapper of the [curl](https://cran.r-project.org/web/packages/curl/index.html)-package.\n\n## Further Links\n\nThere is a [API-documentation](https://developer.datawrapper.de/reference) and a [Getting Started guide with examples](https://developer.datawrapper.de/docs/getting-started) from Datawrapper.\n\nA full Package-documentation [can be found here](https://munichrocker.github.io/DatawRappr/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmunichrocker%2FDatawRappr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmunichrocker%2FDatawRappr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmunichrocker%2FDatawRappr/lists"}