Release notes - May 23, 2024
Web of Science Expanded API
We are pleased to announce the release of the new view Short Record (SR) for the Expanded API, which can be retrieved through a query parameter optionView. As the name says, the Short Record allows you to retrieve limited metadata (similar to the Starter API), which is excluded from your usage quota for a Full Record (FR) download. The optionView Parameter is included in all endpoints that can retrieve Full Record:
- Search endpoints that accept a user query
- GET /
- POST /
- Query by query identifier GET /query/{queryId}
- Related Records GET /related
- Citing references GET /citing
- Get record by specific id GET /id/{uniqueId}
For more information, please refer to the OpenAPI Specification (Swagger) at: https://api.clarivate.com/swagger-ui/?url=https://developer.clarivate.com/apis/wos/swagger
In the following, we will use the GET search endpoint to retrieve documents from the Web of Science Core Collection with the publication year 2024 and use optionView=SR, which indicates retrieval of the short records.
https://api.clarivate.com/api/wos?databaseId=WOS&optionView=SR&usrQuery=PY=2022
Please note that the default value is still Full Record (FR) to maintain backward compatibility.
Times Cited for all Databases
While the Short Record only displays the Times Cited for the request’s databaseId, the Full Record shows the Times Cited for all databases and includes the total Times Cited across all databases. The response is an array, and WOK represents all databases.
Example:
