Skip to content
Learn about the Dimensions Analytics API via code examples and Jupyter notebooks
Jupyter Notebook HTML
Branch: master
Clone or download
Latest commit 2219c13 Aug 14, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
1-getting-started misc updates Aug 13, 2019
2-sample-applications misc updates Aug 5, 2019
docs misc updates Aug 13, 2019
.gitignore cleanup Apr 10, 2019 misc updates Jun 19, 2019
LICENSE Initial commit Apr 10, 2019 misc updates Aug 5, 2019
dsl.ini.SAMPLE misc updates Jun 14, 2019
postBuild misc updates Jun 18, 2019
requirements.txt misc updates Jun 18, 2019

Getting Started

This GitHub repository contains code samples and reusable Jupyter notebooks for scholarly data analytics using the Dimensions API.

The Dimensions Analytics API enables users to perform complex searches in the Dimensions database. For more information about the API language, see also the official documentation.

A companion website including HTML versions of these tutorials is also available:

License: CC BY-NC-SA 4.0

What is Dimensions?

Digital Science's Dimensions is a dynamic, easy to use, linked-research data platform that re-imagines the way research can be discovered, accessed and analyzed. Within Dimensions, users can explore the connections between grants, publications, clinical trials, patents and policy documents.

For more information, see

What are Jupyter Notebooks?

The Jupyter Notebook is an open-source web application that allows you to create and share documents that contain live code, equations, visualizations and narrative text. Uses include: data cleaning and transformation, numerical simulation, statistical modeling, data visualization, machine learning, and much more.

For more information, see

Running the examples

If you are already familiar with Python and Jupyter, then you probably know what to do already. Download this repository and run it locally. Feel free to modify and adapt these examples so to match your project needs.

You can also run these examples online in your browser, thanks to Binder and Gigantum.

Using Binder is a free service that transforms a github repository into a JupyterHub server hosting the repository's contents. Click on the link below for launching it with the Dimensions API Lab repository.


Using Gigantum

Gigantum is an open-source platform for developing, executing, and sharing analysis and computations using JupyterLab. Gigantum provides a full-featured environment where you You can easily install packages with apt, pip and conda, as well as add Docker snippets for more customized packages.

  • download the zipped dimensions-api-examples image
  • go to, click on login, then sign up in order to create an account
  • once you are logged in and in the main 'projects' page, click on 'import existing'
  • drag the zipped image to the project import window
  • load the project and click on launch: jupyterlab

Comments, bug reports

This project lives on Github. You can file issues or ask questions there. Suggestions, pull requests and improvements welcome!

See also

You can’t perform that action at this time.