{"id":34042360,"url":"https://github.com/nils-herrmann/sprynger","last_synced_at":"2026-04-02T17:27:39.955Z","repository":{"id":257576768,"uuid":"855735055","full_name":"nils-herrmann/sprynger","owner":"nils-herrmann","description":"API wrapper for the Springer Nature API","archived":false,"fork":false,"pushed_at":"2026-03-12T15:52:20.000Z","size":166,"stargazers_count":24,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-12T21:45:55.556Z","etag":null,"topics":["api","api-wrapper","data-retrieval","python","springer","springernature","wrapper"],"latest_commit_sha":null,"homepage":"https://sprynger.readthedocs.io/en/stable/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nils-herrmann.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-11T11:34:53.000Z","updated_at":"2026-03-12T15:49:19.000Z","dependencies_parsed_at":"2025-04-23T16:43:07.765Z","dependency_job_id":"61e2449c-84b4-48e2-89ea-f15322308184","html_url":"https://github.com/nils-herrmann/sprynger","commit_stats":null,"previous_names":["nils-herrmann/sprynger"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/nils-herrmann/sprynger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nils-herrmann%2Fsprynger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nils-herrmann%2Fsprynger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nils-herrmann%2Fsprynger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nils-herrmann%2Fsprynger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nils-herrmann","download_url":"https://codeload.github.com/nils-herrmann/sprynger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nils-herrmann%2Fsprynger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31311508,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-wrapper","data-retrieval","python","springer","springernature","wrapper"],"created_at":"2025-12-13T22:25:40.059Z","updated_at":"2026-04-02T17:27:39.946Z","avatar_url":"https://github.com/nils-herrmann.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. documentation-begin\n\nsprynger: API wrapper for Springer Nature\n============================================\n\n\nSimple API wrapper for the `Springer Nature APIs \u003chttps://dev.springernature.com\u003e`_\n\n.. image:: https://badge.fury.io/py/sprynger.svg\n    :target: https://pypi.org/project/sprynger/\n\n.. image:: https://img.shields.io/pypi/pyversions/sprynger.svg\n    :target: https://pypi.org/project/sprynger/\n\n.. image:: https://readthedocs.org/projects/sprynger/badge/?version=latest\n    :target: https://sprynger.readthedocs.io/en/latest/\n\n.. image:: https://img.shields.io/pypi/dm/sprynger.svg\n    :target: https://pypi.org/project/sprynger/\n\n.. image:: https://img.shields.io/pypi/l/sprynger.svg\n    :target: https://pypi.org/project/sprynger/\n\n.. image:: https://github.com/nils-herrmann/sprynger/actions/workflows/test.yml/badge.svg\n   :target: https://github.com/nils-herrmann/sprynger/actions/workflows/test.yml\n\n.. image:: https://codecov.io/gh/nils-herrmann/sprynger/graph/badge.svg?token=GF3FMVUWV3 \n :target: https://codecov.io/gh/nils-herrmann/sprynger\n\n.. image:: https://api.codeclimate.com/v1/badges/1d053321a70d800bfc59/maintainability\n    :target: https://codeclimate.com/github/your-repo/sprynger/maintainability\n\n\n🏔️ Overview Springer Nature\n----------------------------\n\nSpringer Nature currently offers three APIs:\n\n- **Springer Metadata API:** Metadata of articles, journal articles and book chapters. (**Note:** Being discontinued by Springer Nature)\n- **Springer Meta API:** Advanced version offering versioned metadata.\n- **Springer OpenAccess API:** Metadata and, where available, full-text.\n\n\n⬇️ Install\n-----------\nDownload and install the package from PyPI:\n\n.. code-block:: bash\n\n    pip install sprynger\n\n\n🪧 Example Use\n---------------\n\n.. code:: python\n    \n    \u003e\u003e\u003e from sprynger import Meta, OpenAccess, init\n    \u003e\u003e\u003e # Initialize with a single API key (for backward compatibility)\n    \u003e\u003e\u003e init(api_key='your free api key from https://dev.springernature.com')\n    \u003e\u003e\u003e \n    \u003e\u003e\u003e # Or initialize with separate keys for Meta and OpenAccess APIs\n    \u003e\u003e\u003e init(api_key_meta='your_meta_key', api_key_oa='your_openaccess_key')\n    \u003e\u003e\u003e\n    \u003e\u003e\u003e # Get metadata of all chapters in the book with ISBN '978-3-031-63497-0'\n    \u003e\u003e\u003e book_metadata = Meta(isbn='978-3-031-63497-0', nr_results=3)\n    \u003e\u003e\u003e for chapter in book_metadata:\n    \u003e\u003e\u003e     print(chapter.identifier)\n    \u003e\u003e\u003e     print(chapter.abstract)\n    'doi:10.1007/978-3-031-63498-7_20'\n        'Modern solvers for quantified Boolean formulas (QBFs) process formulas in prenex form, ...'\n    'doi:10.1007/978-3-031-63498-7_9'\n        'Given a finite consistent set of ground literals, we present an algorithm that generates ...'\n    'doi:10.1007/978-3-031-63498-7_3'\n        'The TPTP World is a well established infrastructure that supports research, development, ...'\n    \u003e\u003e\u003e # Print the facets of the retrieved chapter's metadata\n    \u003e\u003e\u003e book_metadata.facets\n    [MetadataFacets(facet='subject', value='Artificial Intelligence', count='27'),...]\n    \u003e\u003e\u003e \n    \u003e\u003e\u003e # Retrieve full-text of three 'journal articles' with the keyword 'quantum computing' published before 2023\n    \u003e\u003e\u003e results = OpenAccess('\"quantum computing\"', dateto='2022-12-30', type='Journal Article', nr_results=3)\n    \u003e\u003e\u003e results.documents_found\n    3515\n    \u003e\u003e\u003e for document in results:\n    \u003e\u003e\u003e    print(document.title)\n    \u003e\u003e\u003e    for section in document.parsed_text:\n    \u003e\u003e\u003e        print(section.text)\n    'A neural network assisted' \n        'Introduction Quantum sensing 1  and metrology 2  are important branches of modern quantum technologi...'\n        ...\n    'Experimental demonstration of classical analogous time-dependent superposition of states'\n        'Introduction The increased demand for quantum information science (QIS) and quantum computing 1 ,  2...'\n        ...\n    'A quantum-like cognitive approach to modeling human biased selection behavior'\n        'Introduction With the advent of the Internet of Things and social networks, the reformation of the d...'\n        ...\n\n📝 Citation\n-----------\n\nIf ``sprynger`` helped you retrieve your data, please cite the `corresponding paper \u003chttps://www.sciencedirect.com/science/article/pii/S2352711025001530\u003e`_.\n\n.. code-block:: bibtex\n\n  @article{HERRMANN2025102186,\n    title = {sprynger: Scriptable bibliometrics using a Python interface to Springer Nature},\n    journal = {SoftwareX},\n    volume = {31},\n    pages = {102186},\n    year = {2025},\n    issn = {2352-7110},\n    doi = {https://doi.org/10.1016/j.softx.2025.102186},\n    url = {https://www.sciencedirect.com/science/article/pii/S2352711025001530},\n    author = {Nils A. Herrmann and Michael E. Rose}\n  }\n\n.. documentation-end\n\n📖 Documentation\n-----------------\n\nFor a comprehensive guide, see the documentation in `read the docs \u003chttps://sprynger.readthedocs.io/en/stable/\u003e`_.\n\n⚠️ Disclaimer\n--------------\n\nThis project is an independent API wrapper for the Springer Nature API.\nIt is not affiliated with, endorsed, or maintained by Springer Nature. For official support, please refer to the Springers's `documentation \u003chttp://docs-dev.springernature.com/docs/\u003e`_ and support channels.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnils-herrmann%2Fsprynger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnils-herrmann%2Fsprynger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnils-herrmann%2Fsprynger/lists"}