semanticscholar
Unofficial Python client for the Semantic Scholar Academic Graph APIs: papers, authors, citations, and references.
semanticscholar
semanticscholar is a well-maintained, unofficial Python client library for the Semantic Scholar APIs, including the Academic Graph (S2AG). It gives programmatic access to a corpus of over 200 million papers with rich metadata, citation edges, and author records, making it a solid foundation for citation-analysis and bibliometrics tooling.
Key features
- Look up papers by many identifiers: DOI, arXiv ID, S2 Paper ID, PubMed, ACL, MAG
- Retrieve a paper's citations and references with metadata
- Author profiles, h-index, and their publication lists
- Bulk and relevance-ranked paper search
- Optional async client for high-throughput pipelines
- API-key aware handling for higher rate limits
Install via pip, instantiate the client, and call methods like get_paper, get_paper_citations, or search_paper to traverse the citation graph. Ideal for building citation networks, related-work discovery, and literature-mapping applications on top of Semantic Scholar data.
Curated mirror of the open-source semanticscholar (MIT). Get it from the source.
Compromise signals — malicious or tampered code (leaked secrets, backdoors, a dropped executable) — reduce the score, and known dependency CVEs carry a bounded penalty (they warrant review but never QUARANTINE — update the dependency to clear). Other dangerous-by-capability traits are risk surface, expected for some capabilities. Every finding is mapped to its OWASP control below.
Findings mapped to the OWASP Top 10 for LLM Applications (2025) and the OWASP Machine Learning Security Top 10. Expand any flagged control for the exact findings — compromise reduces the score; expected/risk-surface do not, except a known CVE, which carries a small bounded penalty (high/critical → Review).
The same gate an agent runs before installing (POST /api/v1/trust/semanticscholar-python-client/check). Click a policy:
Consume semanticscholar programmatically. Authenticate with an API key or session — see Authorize an agent.
# Agents: CHECK BEFORE YOU INSTALL (no auth) — score, grade, level, capability manifest
curl https://ai-supply.store/api/v1/trust/semanticscholar-python-client
# Gate against your org policy (returns { pass, violations })
curl -X POST https://ai-supply.store/api/v1/trust/semanticscholar-python-client/check \
-H "Content-Type: application/json" \
-d '{"minGrade":"B","denyPermissions":["shell"],"denyUnknownEgress":true}'
# CLI
npx ai-supply add semanticscholar-python-client
# REST (install → download)
curl -X POST https://ai-supply.store/api/v1/listings/semanticscholar-python-client/install \
-H "Authorization: Bearer $AIM_KEY"
# MCP tool
install_listing({ "slug": "semanticscholar-python-client" })OpenAPI spec →Curated mirror — latest upstream source. See the repository for tagged releases.