Skip to main content

A lightweight scraper for Google Scholar

Project description

Scholr

PyPI version Python License Stars Issues


Overview

Scholr is a lightweight, developer-friendly Python library for extracting structured academic data from Google Scholar.
It provides an easy way to retrieve:

  • Author profile information (name, affiliation, research interests, photo)
  • Citation statistics (total citations, h-index, i10-index)
  • Complete publication lists
  • Publication details (title, date, citations, link)

Scholr is designed for simplicity, speed, and ease of integration into scripts or pipelines.


Installation

pip install scholr

Usage

Fetch an author profile

from scholr import get_scholar_profile

profile_url = "https://scholar.google.com/citations?user=EXAMPLE_ID"

profile = get_scholar_profile(profile_url)

print("Profile info:")
print(profile)

Example output:

{
  "name": "John Doe",
  "affiliation": "Department of Computer Science, Example University",
  "interests": ["machine learning", "data mining"],
  "photo_url": "https://scholar.googleusercontent.com/photos/example.jpg",
  "citations_all": "1234",
  "citations_since_2019": "987",
  "h_index_all": "15",
  "h_index_since_2019": "12",
  "i10_index_all": "10",
  "i10_index_since_2019": "8",
  "publications": [
    {"title": "A Study on Machine Learning", "link": "https://scholar.google.com/..." },
    {"title": "Data Mining Techniques", "link": "https://scholar.google.com/..."}
  ]
}

Fetch publication details

from scholr import get_publication_details

publication_url = "https://scholar.google.com/citations?view_op=view_citation&user=EXAMPLE_ID&citation_for_view=EXAMPLE_CITATION"

publication = get_publication_details(publication_url)

print("Publication details:")
print(publication)

Example output:

{
  "title": "A Study on Machine Learning",
  "link": "https://scholar.google.com/...",
  "date": "2020/5/15",
  "citations": "45"
}

Example Test Script

from scholr import get_scholar_profile, get_publication_details

profile_url = "https://scholar.google.com/citations?user=EXAMPLE_ID"

profile = get_scholar_profile(profile_url)
print("Profile info:", profile)

for pub in profile.get("publications", []):
    publication = get_publication_details(pub.get("link"))
    print("Publication details:", publication)

Notes

  • Scholr fetches all publications of a profile automatically using pagination.
  • Rate-limiting may occur if too many requests are sent in a short time.
  • This library uses only BeautifulSoup; no browser automation is required.

Project details


Download files

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

Source Distribution

scholr-0.1.0.tar.gz (5.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scholr-0.1.0-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file scholr-0.1.0.tar.gz.

File metadata

  • Download URL: scholr-0.1.0.tar.gz
  • Upload date:
  • Size: 5.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for scholr-0.1.0.tar.gz
Algorithm Hash digest
SHA256 78e411303ddb2a4a02fd02cf993fc4e15da3f752f2cdd0462d16b5db57db93db
MD5 8e0effb03358bba375a45801c9d9cd99
BLAKE2b-256 8c1959889f83bf0e783e994565b3ec78470ef718acf8bac059d34d1af8e78e6b

See more details on using hashes here.

File details

Details for the file scholr-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: scholr-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 5.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for scholr-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c48864fa03232575e7487edd2741b6b96b9fd3f6659c896c88a74fe34df168d2
MD5 65a05df02e3b3f55ef105b2508977920
BLAKE2b-256 921d77944fe715a3ba5d0a62a4e01e7237720230ec07ca8a7aafc20a380f0e88

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page