Introducing the SciVal API

An API stands for Application Programming Interface, and it provides a way for programs to talk to one another.

The SciVal API offers the same feature as the SciVal UI (user interface), in that it allows you to retrieve metrics, researchers and all 8,500+ institutions in SciVal. However, the results procured are in a machine-readable format that enables software, rather than humans using the scival.com platform, to find the data. Consequently, this allows developers to write programs that automatically extract metrics from SciVal periodically, and use that data in their Institutional Repository systems, websites, social media and for richer visualizations in tools like Tableau.

Webinar: Register to find out more

As part of the this exciting new release we will be running two webinars to run you through what an API is, what will be included in the first release, what we have planned as part of the roadmap, as well as where to access the API from the Elsevier development platform.

Sign up

What is being Released?

An API is just another content delivery mechanism. Every action in SciVal uses the API behind the scenes. Currently you can download SciVal metrics from anywhere in the scival.com platform using the export function, however this can be quite labor intensive for repetitive work.

By utilizing the new public API, you can download the most common metrics for institutions and researchers. It allows you to automate repetitive tasks, thus saving quite a bit of time and effort but requires some technical knowledge.

For the first release you will be able to retrieve metrics on researchers (author profiles) and institutions, covering 86% of the main use cases, including:

  1. Scholarly Output
  2. Publications in Top Journal Percentiles
  3. Outputs in Top Citation Percentiles
  4. Field-Weighted Citation Impact (FWCI)
  5. Collaboration
  6. Citation Count
  7. Citations Per Publication (CPP)
  8. h-indeces
  9. Collaboration Impact
  10. Cited Publications

This covers 86% of all metrics calls.  There will be an initial limitation of 2,000 metric requests per month per user.

SciVal or Scopus - which API, when?

The SciVal and Scopus APIs serve different/complimentary functions. Whereas you will use the Scopus API to show publications and Scopus cited-by counts, the SciVal API will allow you to highlight metrics for authors and institutions.

Access through Elsevier Developer Platform

You can access the SciVal API via the Elsevier Developer Platform together with Scopus, ScienceDirect, Embase and Engineering Village APIs. The platform also provides:

  • API key generation (for authentication)
  • Help guides for getting started
  • Overview of the various use cases and detailed recipe books
  • Interactive documentation
  • Other additional resources e.g. legal, SDKs etc.

What‘s in the Roadmap?

As this is just the first release, in the future we will be looking into adding:

  • Many other metrics options
  • Data for the last 5 years (rolling window)
  • Initial limitation of 500 metric requests per month per user

The other functionalities which we will be working on for subsequent releases include:

  • Metrics on Publication sets, Groups of Researchers, Groups of Institutions, Countries and Groups of Countries.
  • Metrics on your “own” entities
  • Integration with commercial CRIS systems.