Release Notes – June 20, 2024
Web of Science Journal API
The 2024 update to the Web of Science Journal Citation Reports (JCR) occurred on June 20th. The Journals API dataset was also updated on June 20th to include the newly released data for 2023.
This year’s JCR will introduce unified rankings across subject categories. This approach is designed to simplify the evaluation of journal performance by providing a more comprehensive view of each journal’s standing within its respective subject area. You can read more about this change at https://clarivate.com/blog/journal-citation-reports-2024-preview-unified-rankings-for-more-inclusive-journal-assessment/.
Despite the changes in JCR, the API will remain backward compatible with previous years. This means that you should not experience any interruptions in your integrations. However, we want to inform you that some data responses will be duplicated as follows: the metrics that used to depend on edition and category will now have the same value for each edition. Below are some examples that illustrate this change.
Rank metrics by API Endpoint: GET /journals/{id}/reports/year/2023
For all journal categories included in different editions, the rankings, quartiles, and percentiles in the 2023 metrics will be the same for each edition. The snippet below is a response from a journal categorized in PSYCHIATRY, which belongs to SSCI and SCIE. The response will include both editions, but the metric values are the same for both entries. This also applies to eigenFactorScore, immediacyIndex, and articleInfluence.
“jif”: [
{
“category”: “PSYCHIATRY”,
“edition”: “SSCI”,
“self”: “/categories/VE_SSCI”,
“rank”: “<same rank>”,
“quartile”: “<same quartile>”,
“jifPercentile”: <same percentile>
},
{
“category”: “PSYCHIATRY”,
“edition”: “SCIE”,
“self”: “/categories/VE_SCIE”,
“rank”: “<same rank>”,
“quartile”: “<same quartile>”,
“jifPercentile”: <same percentile>
}
Metrics for categories by API endpoint /categories/{id}/reports/2023
For example, the following endpoints will have identical metrics.
/categories/VE_SCIE/reports/year/2023
/categories//VE_SSCI/reports/year/2023
For more technical details, please visit https://api.clarivate.com/swagger-ui/?url=https://developer.clarivate.com/apis/wos-journal/swagger
Web of Science Researcher API
Web of Science Researcher API now includes ORCID information in its search response. This avoids making additional requests to fetch the ORCID of a ResearcherID.
Endpoint: GET https://api.clarivate.com/apis/wos-researcher/researchers
Example request
GET https://api.clarivate.com/apis/wos-researcher/researchers
?q=OG~”Harvard University” and claimStatus=true
Response Snippet
{
“hits”: [
{
“rid”: [
“KCK-6954-2024”
],
“orcids”: [
“0000-0003-4300-9040”
],
…
},
…
]
}
For more technical details, please visit https://api.clarivate.com/swagger-ui/?url=https://developer.clarivate.com/apis/wos-researcher/swagger