Web of Science AMR Times Cited web service
This Java web service provides Web of Science Times Cited counts via a simple JSON response. Check the 'example' directory for a simple implementation using javascript.
The Article Match Retrieval (AMR) web service from the Web of Science is utilized to make real-time queries to the Web of Science, see documentation here. You will need a subscription to the Web of Science and user name and password to access this service. Please contact your Clarivate Web of Science account manager directly or customer care to obtain credentials and indicate that you plan to use the AMR service with this tool.
For information about other Web of Science web services and the data usage policy, please see this page.
Implementation details
This web service can be built as a separate Java application (war) that runs alongside your application. The example screenshot above shows the web service integrated into the VIVO research networking software using the sample javascript and css in the 'example' directory.
URLs
You may call the service using a DOI, PubMed ID (PMID), or Web of Science unique identifier (UT).
/doi/{DOI}
/pmid/{PubMed ID}
/ut/{Web of Science unique identifier UT}
Configuration
Copy src/main/resources/sample_template.xml
to src/main/resources/template.xml
and change username and password to match your credentials.
Development
$ mvn jetty:run
To run on an alternative port:
$ mvn jetty:run -Djetty.port=5000
You should now be able to call the service: http://localhost:5000/doi/10.1109/82.486465
Building
Build a WAR for deployment.
$ mvn package
Copy the war to your servlet directory. For example:
$ cp target/amr-0.1-SNAPSHOT.war /var/lib/tomcat7/webapps/amr.war
Responses
The client parses the XML response from the Web of Science and returns a JSON document. A successful query will return a response like this:
{
"sourceURL": "http://gateway.webofknowledge.com/gateway/Gateway.cgi?GWVersion=2&SrcApp=PARTNER_APP&SrcAuth=TRINTCEL&KeyUT=WOS:000179024900021&DestLinkType=FullRecord&DestApp=WOS_CPL&UsrCustomerID=dc101777b18a39292144c8423537a284",
"citingArticlesURL": "http://gateway.webofknowledge.com/gateway/Gateway.cgi?GWVersion=2&SrcApp=PARTNER_APP&SrcAuth=TRINTCEL&KeyUT=WOS:000179024900021&DestLinkType=CitingArticles&DestApp=WOS_CPL&UsrCustomerID=dc101777b18a39292144c8423537a284",
"timesCited": "2",
"relatedRecordsURL": "http://gateway.webofknowledge.com/gateway/Gateway.cgi?GWVersion=2&SrcApp=PARTNER_APP&SrcAuth=TRINTCEL&KeyUT=WOS:000179024900021&DestLinkType=RelatedRecords&DestApp=WOS_CPL&UsrCustomerID=dc101777b18a39292144c8423537a284",
"ut": "000179024900021",
"doi": "10.1785/0120010124"
}
If the query is not successful, the client will pass the error message from WoS:
{
"message": "No Result Found"
}
{
"Server.authentication": "Invalid Username"
}
See the documentation for a full list of errors returned from AMR.
Embedding in VIVO
VIVO pages need to call the service and pass it the Web of Science identifier for a publication. See example/wosUtils.js
for JavaScript that can be used to call the service. This can be added to all publication pages by adding it to the called
JavaScript in individual.ftl
.