{"id":32207363,"url":"https://github.com/kxzk/datoramar","last_synced_at":"2025-12-12T02:27:07.073Z","repository":{"id":56937392,"uuid":"114720529","full_name":"kxzk/datoramar","owner":"kxzk","description":"📦 R interface to the Datorama Query \u0026 Platform API","archived":false,"fork":false,"pushed_at":"2019-06-28T09:03:54.000Z","size":20,"stargazers_count":11,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-10T18:34:25.933Z","etag":null,"topics":["datorama","marketing","r"],"latest_commit_sha":null,"homepage":"https://developers.datorama.com/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kxzk.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}},"created_at":"2017-12-19T04:52:27.000Z","updated_at":"2025-07-08T12:16:00.000Z","dependencies_parsed_at":"2022-08-21T01:40:16.866Z","dependency_job_id":null,"html_url":"https://github.com/kxzk/datoramar","commit_stats":null,"previous_names":["kxzk/datoramar","beigebrucewayne/datoramar"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kxzk/datoramar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kxzk%2Fdatoramar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kxzk%2Fdatoramar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kxzk%2Fdatoramar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kxzk%2Fdatoramar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kxzk","download_url":"https://codeload.github.com/kxzk/datoramar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kxzk%2Fdatoramar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280389295,"owners_count":26322507,"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","status":"online","status_checked_at":"2025-10-22T02:00:06.515Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["datorama","marketing","r"],"created_at":"2025-10-22T05:51:59.489Z","updated_at":"2025-10-22T05:52:00.874Z","avatar_url":"https://github.com/kxzk.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DatoramaR\n\nAn interface to the [Datorama](https://datorama.com) Query \u0026 Platform API.  \n\n[![Build Status](https://travis-ci.org/kadekillary/datoramar.svg?branch=master)](https://travis-ci.org/kadekillary/datoramar) [![CRAN status](http://www.r-pkg.org/badges/version/datoramar)](http://www.r-pkg.org/badges/version/datoramar)\n\n![logo](https://i.imgur.com/6c5kH7S.png)\n\n\u0026nbsp;\n## Overview\nDatorama has two APIs: the Query API and the Platform API. This package interfaces with both. The Query API is for retrieving data out of Datorama. The Platform API is for interacting with the platform directly.\n\nAs of right now, only the Query API and Data Stream Processing endpoints are supported.\n\n\u0026nbsp;\n## Installation\n\nInstall from Github\n```r\ndevtools::install_github('kadekillary/datoramar')\n```\n\n\u0026nbsp;\n## Authentication\n\nAll API requests must authenticate using your personal API access token. The token can be found inside the Datorama platform under \"My Profile\" below your email address.\n\nConversely, create an `.Renviron` file and specify your `ACCESS_TOKEN` in there. Now you can call it via R using `Sys.getenv(\"ACCESS_TOKEN\")`.\n\n![api_token](https://i.imgur.com/pb9CMaD.png)\n\n\u0026nbsp;\n## Usage\n\nOnce you have your token, you can run a query using `datorama_query()`. This function will return the Query API's response as a tibble.\n\n`datorama_query()`\n```r\ndatorama_query(access_token = \"dato-api-31i9a14b-b41d-323h-2f79-379nxhfdf8123\",\n               workspaceId = \"999999\",\n               dateRange = \"CUSTOM\",\n               startDate = \"2017-11-01\",\n               endDate = \"2017-11-22\",\n               measurements = list(list(name = \"Clicks\"),\n                                   list(name = \"Impressions\")),\n               dimensions = list(\"Date\", \"Site Name\")\n)\n```\n\nYou can also use this API wrapper to automate the processing of particular Data Streams. You will need to specify the Data Stream by it's ID and specify a time window.\n\n`datorama_process()`\n```r\ndatorama_process(acces_token = \"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\n                 dataStreamIds = list(348937, 34289),\n                 startDate = \"2018-01-01\",\n                 endDate = \"2018-01-20\"\n)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkxzk%2Fdatoramar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkxzk%2Fdatoramar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkxzk%2Fdatoramar/lists"}