Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

Simple access to Google Scholar authors and citations

Project description is a module that allows you to retrieve author and publication information from Google Scholar in a friendly, Pythonic way.


Because scholarly does not use an official API, no key is required. Simply:

import scholarly

print scholarly.search_author('Steven A. Cholewiak').next()


  • search_author – Search for an author by name and return a generator of Author objects.
>>> search_query = scholarly.search_author('Manish Singh')
>>> print
{'_filled': False,
 'affiliation': u'Rutgers University, New Brunswick, NJ',
 'citedby': 2283,
 'email': u'',
 'id': '9XRvM88AAAAJ',
 'interests': [u'Human perception',
               u'Computational Vision',
               u'Cognitive Science'],
 'name': u'Manish Singh',
 'url_citations': '/citations?user=9XRvM88AAAAJ&hl=en',
 'url_picture': '/citations/images/avatar_scholar_150.jpg'}
  • search_keyword – Search by keyword and return a generator of Author objects.
>>> search_query = scholarly.search_keyword('Haptics')
>>> print
{'_filled': False,
 'affiliation': u'Stanford University',
 'citedby': 18625,
 'email': u'',
 'id': '4arkOLcAAAAJ',
 'interests': [u'Robotics', u'Haptics', u'Human Motion'],
 'name': u'Oussama Khatib',
 'url_citations': '/citations?user=4arkOLcAAAAJ&hl=en',
 'url_picture': '/citations/images/avatar_scholar_150.jpg'}
  • search_pubs_query – Search for articles/publications and return generator of Publication objects.
>>> search_query = scholarly.search_pubs_query('Perception of physical stability and center of mass of 3D objects')
>>> print
{'_filled': False,
 'bib': {'abstract': u'Humans can judge from vision alone whether an object is physically stable or not. Such judgments allow observers to predict the physical behavior of objects, and hence to guide their motor actions. We investigated the visual estimation of physical stability of 3-D  ...',
     'author': u'SA Cholewiak and RW Fleming and M Singh',
     'eprint': u'',
     'title': u'Perception of physical stability and center of mass of 3-D objects',
     'url': u''},
 'source': 'scholar',
 'url_scholarbib': u'/scholar.bib?'}


Here’s a quick example demonstrating how to retrieve an author’s profile then retrieve the titles of the papers that cite his most popular (cited) paper.

>>> # Retrieve the author's data, fill-in, and print
>>> search_query = scholarly.search_author('Steven A Cholewiak')
>>> author =
>>> print author

>>> # Print the titles of the author's publications
>>> print [pub.bib['title'] for pub in author.publications]

>>> # Take a closer look at the first publication
>>> pub = author.publications[0].fill()
>>> print pub

>>> # Which papers cited that publication?
>>> print [citation.bib['title'] for citation in pub.citedby()]


Use pip:

pip install scholarly

Or clone the package:

git clone


Requires bibtexparser, Beautiful Soup, and python-dateutil.


Note that because of the nature of web scraping, this project will be in perpetual alpha.


  • Raise an exception when we receive a Bot Check. Reorganized alphabetically and updated its test cases. Reorganized README. Added python-dateutil as installation requirement, for some reason it was accidentally omitted.


  • Now request HTTPS connection rather than HTTP and update to account for a new “Zucker”. Also added information for the v0.1.1 revision.


  • Fixed an issue with multi-page Author results, author entries with no citations (which are rare, but do occur), and added some tests using unittest.


  • Initial release.


The original code that this project was forked from was released by Bello Chalmers under a WTFPL license. In keeping with this mentality, all code is released under the Unlicense.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for scholarly, version 0.1.3
Filename, size File type Python version Upload date Hashes
Filename, size scholarly-0.1.3.tar.gz (6.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page