Kasyanov "Web of Science API Workshop"
Download as PPTX, PDF0 likes1,367 views
The document outlines the functionalities and use cases of the Web of Science APIs for improving data access and integration in research. It details the differences between user interfaces and APIs, emphasizing the efficiency of APIs in extracting and processing scholarly data. Additionally, it describes various examples of how researchers and institutions can utilize these APIs for citation analysis, publication metrics, and research management.
Kasyanov "Web of Science API Workshop"
- 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
- 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