This presentation was given by guest lecturer Pavel Kasyanov of Clarivate Analytics during the fifth session of the NISO Spring training series "Working with Scholarly APIs." Session Five, Web of Science, was moderated by Phill Jones of MoreBrains Cooperative and held on May 26, 2022.

1. Web of Science API workshop
Better Data. Better Decisions. Better Outcomes.
Pavel Kasyanov
May 26, 2022

2. 2
An article record
In Web of Science platform user interface

3. 3
The same article record
• This is only a fragment of the full
record data
• Every piece of metadata is stored
in a dedicated field and can be
retrieved for further data
operations
But the metadata obtained using Web of Science Expanded API

4. Web of Science APIs: Primary Use Cases
IR and Public
Researcher
Engagement
Platforms
3rd party integration –
FAR/CRIS/RIMS and
Discovery Services
Publication & Research
Presentations / Findings
Measuring and
Modeling the
Dynamics of Science
Hypothesis testing and
validation
Combining scholarly
impact data with
other external
datasets
Citation Networks &
Mapping
Research Intelligence &
Strategy / Planning
Scientific Trends and
Impacts over time
Data Integration (on-going) Research Projects (one-off)
Dashboards & Visuals
4

5. 5
Difference between user interface and API
API (Application Programming Interface)
Any task on which computer works more efficiently:
• Routine calculations
• Extracting only necessary data fields
• Combining Web of Science data with external data
for further analysis
Web of Science platform user interface
Any task designed for human brain:
• Running a topical search in Web of Science
• Filtering results
• Selecting the most relevant search results
• Clicking through to the full text document to read it
General approach

6. APIs we will cover today
6
Insert footer

7. • Query for all publications using WoS
advanced search field tags
• Get cited references and citing articles
• Get times cited counts
• Get WoS UTs to quickly identify new
publica-
tions for your collection
InCites Benchmarking & Analytics™ | Journal Citation Reports™ | Web of
Science™
Web of Science™ APIs The Web of Science Publication APIs complement our suite of RESTful Web of
Science APIs to provide complete publication metadata from the Web of Science
Publication metadata Publication metrics Journal metadata/metrics
Web of Science Starter API
Support search and daa
integration using limited Web of
Science data re- turned as JSON
or XML
InCites API
Support bibliometric analysis and
integration of document-level
metrics
Web of Science Journals API
Support bibliometric analysis and
integration of journal-level
metrics
Web of Science API Expanded
Support search and data
integration using full Web of
Science data re- turned as JSON
or XML
Coverage
© 2021 Clarivate. Clarivate and its logo, as well as all other trademarks used herein are trademarks of their respective owners and used under license. (July
2021 1.5)
Example use cases
• Library: publication repository updates, advanced search
for institute papers
• Clarivate Converis; Symplectic Elements; Elsevier Pure;
Interfolio Faculty180; Lyrasis Dspace, VIVO
• Research management: benchmark, collaborations,
citations, integration with CRIS
• Research: publication and citation analysis, network data,
AI, machine learning
WoS Starter API
Includes the following data
sources:
• Web of Science Core
Collection
• BIOSIS family (BCI, BIOABS,
BIOSIS)
• Data Citation Index
• Derwent Innovations Index
• Medline
WoS API Expanded
Includes the following data
sources:
• Web of Science Core
Collection
• BIOSIS family (BCI, BIOABS,
BIOSIS)
• CABI
• Current Contents
• Data Citation Index
• Derwent Innovations Index
• FSTA
• INSPEC
• Medline
• Regional content
• Zoological records (ZR)
Queries
Boolean AND/+, OR and NOT operators are
supported, along with ‘*’ wildcards. Queries can be
filtered by values and ranges
See https://developer.clarivate.com/apis/wos and
https://developer.clarivate.com/apis/wos-starter for
more information
Data fields API usage
WoS Starter API
Authors, Author keywords, RID, Document type, Title, Issue, Pages, Publication
date, Source title, Volume, DOI, ISBN, ISSN
WoS API Expanded
WOS Starter API fields + PMID, Times cited, Author addresses/affiliations, Grants,
Publisher, Related records, citing articles, citing references, Organization enhanced,
Author Identifiers

8. Example use cases
• Library: publication repository updates, metrics
for institute papers
• Research management: benchmark,
collaborations, citations, integration with CRIS
• Research: Retrieve metrics and citation topics
for bibliometrics studies
InCites API
Includes the following data
sources:
• Science Citation Index Expanded
• Social Sciences Citation Index
• Arts & Humanities Citation Index
• Conference Proceedings Citation Index (SCI
& SSH)
• Book Citation Index (SCI & SSH)
• Emerging Sources Citation Index
Key features
Includes the following data
sources:
• Reliable citation
indicators
• Global evaluation
schema
• Collaboration indicators
• Open access indicators
• Citation Topics
• Trend analysis
• Institutional profiles
InCites Benchmarking & Analytics™ | Journal Citation Reports™ | Web of
Science™
InCites Benchmarking & Analytics API™ The InCites API complements our suite of RESTful Web of Science
APIs to provide complete document-level metrics from InCites
Publication metadata Publication metrics Journal metadata/metrics
Web of Science Starter API
Support search and data
integration using limited Web of
Science data re- turned as JSON
or XML
InCites API
Support bibliometric analysis and
integration of document-level
metrics
Web of Science Journals API
Support bibliometric analysis and
integration of journal-level
metrics
Web of Science API Expanded
Support search and data
integration using full Web of
Science data re- turned as JSON
or XML
Coverage
Queries
Search by WoS accession number (UT) to get
document- level metrics
See https://developer.clarivate.com/apis/incites
for more information
Data fields API usage
© 2021 Clarivate. Clarivate and its logo, as well as all other trademarks used herein are trademarks of their respective owners and used under license.
(July 2021 1.5)
Web of Science™
Core Collection
Science Citation Index
Expanded Social Sciences
Citation Index Arts &
Humanities Citation Index
Emerging Sources Citation
Index
Conference Proceedings Citation
Index Book Citation Index
• Times Cited
• Document Type
• Journal Impact Factor
• Highly Cited/Hot Paper
• Collaboration indicators
(International, industry, International)
• Open Access type (DOAJ Gold, Other
Gold, Green Published, Green
Accepted, Bronze)
• Normalized metrics (Category
Normalized Citation Impact (per
category), Journal Normalized
Citation Impact)
• Percentile per category
• GET metrics by institution ID endpoint
• GET metrics by UT endpoint
• Set global evaluation schema for regional
con-text

9. InCites Benchmarking & Analytics™ | Journal Citation Reports™ | Web of
Science™
Web of Science™ Journals API
• Journal name &
ISSN/eiSSN
• Category and rank
• Total cites
• Immediacy Index
• Journal Impact Factor™
• 5-year JIF
• JIF quartile
• Average JIF percentile
• Eigenfactor and Article
Influence Score
• Cited/citing half-life
• Citable items
• Open access
• Source data counts
The new Journals API complements our suite of RESTful Web of Science APIs to
provide complete journal metadata and metrics from the Journal Citation Reports
Publication metadata Publication metrics Journal metadata/metrics
Web of Science Starter API
Support search and data
integration using limited Web of
Science data re- turned as JSON
or XML
InCites API
Support bibliometric analysis and
integration of document-level
metrics
Web of Science Journals API
Support bibliometric analysis and
integration of journal-level
metrics
Web of Science API Expanded
Support search and data
integration using full Web of
Science data re- turned as JSON
or XML
21,000 +
journalscovered*
Includes the sciences (SCIE),
social sciences (SSCI), and
now both the arts &
humanities (AHCI) and
emerging sources (ESCI)
12,000 +
have a Journal Impact Factor™ (JIF)
SCIE and SSCI
A new normalized journal metric*
Journal Citation Indicator
calculated for all Web of Science Core Collection journals, along
with:
All Web of Science Core
Collection™ Journals
Coverage
*From July
2021
Queries
Boolean AND/+, OR and NOT operators are
supported, along with ‘*’ wildcards. Queries can
be filtered by val- ues and ranges
See https://developer.clarivate.com/apis/wos-
journals for more information
• Query for all journals or by journal
ID
• Get cited and citing journals
• Get journal metrics
• Query for all categories or by
category ID
• Get cited and citing categories
• Get category metrics
Example use cases API usage
Integrate with internal systems
For example, to pass Journal Impact Factors (JIFs) and Journal
Citation Indicators (JCIs) to journal web pages
Bibliometric studies
Access and retrieve core journal metrics for entire categories of
groups and journal to include in analyses
Journal
Category
© 2021 Clarivate. Clarivate and its logo, as well as all other trademarks used herein are trademarks of their respective owners and used under license. (July
2021 1.5)

10. 10
Insert footer
How to get your API key
• Register (your Web of
Science credentials
should work)
• Create an application
• Select an API and click
“subscribe”
developer.clarivate.com

11. Live demonstration
Postman
11

12. Live demonstration
Web of Science API Converter app
12

13. Data Integration is an important part
of API use cases – but API and raw
data are more than just that
With API or raw data you can expand
your analytics far beyond the
capabilities of the user interface
13

14. 14
Simplest example
Processing Web of Science Core Collection data the way you want
Web of Science data
A simple self-made or
community-made program or
algorithm
Answers to your
unique and specific
questions

15. Live demonstration
Python code snippets
15

16. Example #1:
“Which author IDs are created for the
researchers in my organization? How
up-to-date are they?"
16

17. 17
Simple code for extracting the necessary data
• The user simply enters their organization profile
name into the code
• And runs the program
• The code is freely available at this GitHub link – you
only need Web of Science Expanded API key to run it

18. 18
Result:
Including their ResearcherID
A .csv table containing all the author records for our organization
Their ORCID
A link to their Web of Science
Author Record
Their list of Web of Science
documents
And whether their Web of
Science author record is
claimed or not

19. Example #2:
“Can we calculate the H-index for our
researchers - but excluding their self-
citations?”
19

20. 20
Simple code identifying self-citations
• The user simply enters the author’s name,
ResearcherID, or ORCID
• And runs the code
• The code is freely available at this GitHub link – you
only need Web of Science Expanded API key to run it
And removing them from the analysis

21. 21
Result:
• This gets printed out
by the program:
• And this is the .csv file:
• This is where the difference comes from:
Summary printed out by the program and details saved to a .csv file

22. Example #3:
“We want to calculate our
organization’s research output using
fractional, not whole, document
counting”
22

23. 23
Simple code for fractional counting
• The user simply enters their organization profile name
and publication years
• And runs the code
• The code is freely available at this GitHub link – you
only need Web of Science Expanded API key to run it
At the organizational level

24. 24
Result: Bonus: 2 additional
meaningful metrics
Also a .csv file – with individual documents data and a possibility to unite them
into a pivot table

25. 25
Other examples
• City-level collaboration analysis
– Which cities is a certain research topic
concentrated in?
– Which cities does a specific organization
collaborate with?
– In which cities does a specific organization
concentrate its research?
• Keyword analysis
– Which keywords appear on the most recent
research on a given topic? (Which research trends
are emerging in a specific research area?)
• etc.
By processing Web of
Science data, we can:
• Create our own
derivative metrics
• Quickly perform
calculations that would
be too time-consuming
if done manually
For processing Web of Science
data obtained via API

26. Almost any analysis with Web of
Science data that you can think of –
even if it is not yet implemented in
Web of Science user interface – is
possible using API or Raw Data
26

27. © 2020 Clarivate. All rights reserved. Republication or redistribution of Clarivate content, including by framing or similar means, is prohibited without the prior
written consent of Clarivate. Clarivate and its logo, as well as all other trademarks used herein are trademarks of their respective owners and used under license.
Thank You
Pavel Kasyanov
pavel.kasyanov@clarivate.com