by enricobacis

enricobacis / wos

πŸ“š Web of Science python client

144 Stars 33 Forks Last release: Not found MIT License 115 Commits 11 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


SOAP Client for querying the Web of Science database


|travis| |readthedocs| |license| |version| |downloads| |stars|

.. |travis| image:: https://travis-ci.org/enricobacis/wos.svg?branch=master :target: https://travis-ci.org/enricobacis/wos .. |readthedocs| image:: https://readthedocs.org/projects/wos/badge/ :target: https://wos.readthedocs.io/ .. |license| image:: https://img.shields.io/github/license/enricobacis/wos :target: https://github.com/enricobacis/wos/blob/master/LICENSE .. |version| image:: https://img.shields.io/pypi/v/wos?color=blue :target: https://pypi.org/project/wos/ .. |downloads| image:: https://img.shields.io/pypi/dm/wos :target: https://pypi.org/project/wos/ .. |stars| image:: https://img.shields.io/github/stars/enricobacis/wos?style=social :target: https://github.com/enricobacis/wos

Web of Science (previously Web of Knowledge) is an online subscription-based scientific citation indexing service maintained by Thomson Reuters.

is a python SOAP Client (both API and command-line tool) to query the WOS database in order to get XML data from a query using the WWS access.


The package has been uploaded to

_, so you can install the package using pip:
pip install wos


This README and the documentation for the classes and methods can be accessed on



You can use the

command to query the Web of Science API. If you want to access data that needs to be accessed using the premium API, you also have to authenticate using your username and password.
usage: wos [-h] [--close] [-l] [-u USER] [-p PASSWORD] [-s SID]
           {query,doi,connect} ...

Query the Web of Science.

positional arguments: {query,doi,connect} sub-command help query query the Web of Science. doi get the WOS ID from the DOI. connect connect and get an SID.

optional arguments: -h, --help show this help message and exit --close Close session. --proxy PROXY HTTP proxy --timeout TIMEOUT API timeout -l, --lite Wos Lite -v, --verbose Verbose

authentication: API credentials for premium access.

-u USER, --user USER -p PASSWORD, --password PASSWORD -s SID, --sid SID

You can use the WOS Lite API using the

parameter (for each query).

You can also authenticate using the session id (SID). In fact the sessions are not closed by the command line utility. Example:

.. code::

$ wos --user JohnDoe --password 12345 connect
Authenticated using SID: ABCDEFGHIJKLM

$ wos --sid ABCDEFGHIJKLM query 'AU=Knuth Donald' -c1 Authenticated using SID: ABCDEFGHIJKLM WOS:000287850200007


$ wos --sid ABCDEFGHIJKLM doi '10.1007/s00283-010-9170-7' 10.1007/s00283-010-9170-7

Check the

_ documentation to understand how to create query strings.


Obviously you can also use the python client programmatically:

.. code:: python

from wos import WosClient
import wos.utils

with WosClient('JohnDoe', '12345') as client: print(wos.utils.query(client, 'AU=Knuth Donald'))



0.1.11+, the
class can access the following APIs.
  • retrieve
    __ /
  • retrieveById
    __ /
  • search
    __ /
  • citedReferences
  • citedReferencesRetrieve
  • citingArticles
  • relatedRecords

[FAQ] I cannot connect ...

I am not affiliated with Thomson Reuters. The library leverages the Web of Science

_ API (Web Services Premium or Lite), which is a paid service offered by Thomson Reuters. This means that your institution has to pay for the Web of Science Core Collection access. The simple registration to Web of Knowledge / Web of Science does not entitle you to access the WWS API service.

So if you receive errors like

No matches returned for Username
No matches returned for IP
, these errors are thrown directly by the WWS API server. This means that the library is correctly communicating with the server, but you do not have access to the Web Services API. I do understand that you can access the WOS website from your network, but the website access and the API access (used in this project) are two separated products, and the website access does not imply the API access, since Thomson Reuters bills them separately. This project does not scrape the website (which would violate the terms of usage) but invokes the WWS APIs offered by Thomson Reuters. Thus there is nothing this project can do to help you.

If you think this is an error and you should be entitled to access the services, please contact Thomson Reuters support first and verify if you have the WWS access. Please open an issue ONLY when you have (1) verified with Thomson Reuters support that you have WWS access; (2) verified that you are connected from the correct network.

.. ReadTheDocs: https://wos.readthedocs.io/ .. _PyPI: https://pypi.python.org/project/wos .. _userquery: https://help.incites.clarivate.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/userquery.html .. _WWS: http://wokinfo.com/productstools/products/related/webservices/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.