semanticscholar
Unofficial Python client library for Semantic Scholar APIs.
What it is and what it does
semanticscholar is an unofficial Python wrapper around Semantic Scholar's public APIs, designed to simplify access to academic metadata, recommendations, and datasets. It abstracts away HTTP details by providing a typed client interface that handles pagination automatically and supports both synchronous and asynchronous request patterns.
The library is intended for researchers, developers, and data scientists who need to programmatically fetch paper metadata, citations, and related academic information. It depends on httpx for HTTP communication and tenacity for request retry logic, making it suitable for production use where network reliability matters.
Use it for:
- Fetch metadata for academic papers by DOI or ID to build a local research database.
- Query the Semantic Scholar Recommendations API to discover related papers for a given publication.
- Retrieve dataset information from Semantic Scholar's Datasets API for research reproducibility.
- Build a citation graph or co-authorship analysis tool using the Academic Graph API.
- Integrate paper search and metadata into a research management or literature review application.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides a typed Python client for querying Semantic Scholar's Academic Graph, Recommendations, and Datasets APIs, with support for paginated responses and asynchronous requests.
Yes. The package has low install friction, active maintenance, permissive licensing, no known vulnerabilities, and fills a clear need for programmatic access to Semantic Scholar data. It's suitable for research, academic, and commercial projects that require scholarly metadata retrieval.
Install
semanticscholar on PyPI
pip
pip install semanticscholaruv
uv add semanticscholarpoetry
poetry add semanticscholarInstalling semanticscholar
Before you install
Low install friction with only two runtime dependencies (tenacity and httpx). Marked as active maintenance with a recent release in March 2026, supporting current Python versions from 3.10 through 3.14.
License in practice
MIT license (permissive) means you can use, modify, and distribute this library freely with minimal restrictions, making it suitable for both open-source and commercial projects.
Quickstart
pip install semanticscholar
from semanticscholar import SemanticScholar
sch = SemanticScholar()
paper = sch.get_paper('10.1093/mind/lix.236.433')
print(paper.title)
Requires Python 3.10 or later; API access depends on Semantic Scholar's service availability and rate limits.
Verify before relying
- Whether asynchronous request support is documented with concrete examples in the library's usage guide.
- Rate limiting behavior and any API key requirements for the Semantic Scholar endpoints.
- Performance characteristics when handling large paginated result sets.
Package facts
| License | MIT (permissive) |
| Python support | supports the current Python release (>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 2 — tenacity, httpx |
| Maintenance | actively maintained — 138 days since the last release |
| First released | |
| Downloads | 114,109/month — #12,312 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: semanticscholar-0.12.0-py3-none-any.whl
Tags
More Python Modules packages
Converts domain names between Unicode and…
permissive · top 100 on PyPI
setuptoolsSetuptools is a Python build backend and…
permissive · top 100 on PyPI
PyYAMLPyYAML parses and emits YAML 1.1 data format,…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
annotated-typesProvides reusable metadata objects for use with…
permissive · top 100 on PyPI
typing-inspectionProvides runtime tools to inspect and…
permissive · top 100 on PyPI
pyalexPyAlex is a Python interface to the OpenAlex…
permissive · top 15,000 on PyPI
scholarlyscholarly retrieves author profiles,…
permissive · top 15,000 on PyPI
pyzoteroPyzotero is a Python client library for the…
unclear · top 15,000 on PyPI
pystardogPython client library for querying and managing…
permissive · top 15,000 on PyPI
hindsight-clientA Python client library for interacting with…
permissive · top 15,000 on PyPI
pymanticPymantic parses and queries RDF and semantic…
permissive · top 15,000 on PyPI
arxiv-mcp-serverAn MCP server that exposes arXiv search, paper…
permissive · top 15,000 on PyPI
arxivProvides a Python interface to search, retrieve…
permissive · top 5,000 on PyPI
fastapi-paginationAdds pagination support to FastAPI applications…
permissive · top 5,000 on PyPI
nucliadb-utilsProvides utility functions and data structures…
permissive · top 15,000 on PyPI