NOTE: This is a user-maintained extension of the [pymed](https://pypi.org/project/pymed/) project which was [archived in 2020](https://github.com/gijswobben/pymed). Some bugs in `pymed` are fixed here. This package can be installed via `pip install pymed-paperscraper` since I forked it to support [`paperscraper`](https://github.com/jannisborn/paperscraper).
[](https://opensource.org/licenses/MIT)
[](https://badge.fury.io/py/pymed_paperscraper)
[](https://pepy.tech/project/pymed_paperscraper)
[](https://pepy.tech/project/pymed_paperscraper)
# PyMed - PubMed Access through Python
PyMed is a Python library that provides access to PubMed through the PubMed API.
## Why this library?
The PubMed API is not very well documented and querying it in a performant way is too complicated and time consuming for researchers. This wrapper provides access to the API in a consistent, readable and performant way.
## Features
This library takes care of the following for you:
- Querying the PubMed database (with the standard PubMed query language)
- Batching of requests for better performance
- Parsing and cleaning of the retrieved articles
## Examples
For full (working) examples have a look at the `examples/` folder in this repository. In essence you only need to import the `PubMed` class, instantiate it, and use it to query:
```python
from pymed_paperscraper import PubMed
pubmed = PubMed(tool="MyTool", email="my@email.address")
results = pubmed.query("Some query", max_results=500)
```
## Notes on the API
The original documentation of the PubMed API can be found here: [PubMed Central](https://www.ncbi.nlm.nih.gov/pmc/tools/developers/). PubMed Central kindly requests you to:
> - Do not make concurrent requests, even at off-peak times; and
> - Include two parameters that help to identify your service or application to our servers
> * _tool_ should be the name of the application, as a string value with no internal spaces, and
> * _email_ should be the e-mail address of the maintainer of the tool, and should be a valid e-mail address.
Raw data
{
"_id": null,
"home_page": null,
"name": "pymed-paperscraper",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "PubMed, Academics, Science, Publication, Search",
"author": null,
"author_email": "Jannis Born <jannis.born@gmx.de>",
"download_url": "https://files.pythonhosted.org/packages/6e/20/8d1237b11a923c6cbf187d4aab60a4a0c1f90b1cab9f2708fc831a63132b/pymed_paperscraper-0.0.1.tar.gz",
"platform": null,
"description": "NOTE: This is a user-maintained extension of the [pymed](https://pypi.org/project/pymed/) project which was [archived in 2020](https://github.com/gijswobben/pymed). Some bugs in `pymed` are fixed here. This package can be installed via `pip install pymed-paperscraper` since I forked it to support [`paperscraper`](https://github.com/jannisborn/paperscraper).\n\n[](https://opensource.org/licenses/MIT)\n[](https://badge.fury.io/py/pymed_paperscraper)\n[](https://pepy.tech/project/pymed_paperscraper)\n[](https://pepy.tech/project/pymed_paperscraper)\n\n# PyMed - PubMed Access through Python\nPyMed is a Python library that provides access to PubMed through the PubMed API.\n\n## Why this library?\nThe PubMed API is not very well documented and querying it in a performant way is too complicated and time consuming for researchers. This wrapper provides access to the API in a consistent, readable and performant way.\n\n## Features\nThis library takes care of the following for you:\n\n- Querying the PubMed database (with the standard PubMed query language)\n- Batching of requests for better performance\n- Parsing and cleaning of the retrieved articles\n\n## Examples\nFor full (working) examples have a look at the `examples/` folder in this repository. In essence you only need to import the `PubMed` class, instantiate it, and use it to query:\n\n```python\nfrom pymed_paperscraper import PubMed\npubmed = PubMed(tool=\"MyTool\", email=\"my@email.address\")\nresults = pubmed.query(\"Some query\", max_results=500)\n```\n\n## Notes on the API\nThe original documentation of the PubMed API can be found here: [PubMed Central](https://www.ncbi.nlm.nih.gov/pmc/tools/developers/). PubMed Central kindly requests you to:\n\n> - Do not make concurrent requests, even at off-peak times; and\n> - Include two parameters that help to identify your service or application to our servers\n> * _tool_ should be the name of the application, as a string value with no internal spaces, and\n> * _email_ should be the e-mail address of the maintainer of the tool, and should be a valid e-mail address.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python library for access to PubMed -- fork from archived PyMed",
"version": "0.0.1",
"project_urls": {
"Homepage": "https://github.com/jannisborn/pymed"
},
"split_keywords": [
"pubmed",
" academics",
" science",
" publication",
" search"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "73a68e9df8cd241b9265df5374a2d55c0829205bf817ddbe1dc85a3c6c20e68a",
"md5": "215ed08d39a4342f2d92d91cb26a302a",
"sha256": "7dbca0aeb38886d89db5104f1ebf3560e16a53d05fb6621011acc3e74f4c8801"
},
"downloads": -1,
"filename": "pymed_paperscraper-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "215ed08d39a4342f2d92d91cb26a302a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 10306,
"upload_time": "2024-10-18T18:00:32",
"upload_time_iso_8601": "2024-10-18T18:00:32.068831Z",
"url": "https://files.pythonhosted.org/packages/73/a6/8e9df8cd241b9265df5374a2d55c0829205bf817ddbe1dc85a3c6c20e68a/pymed_paperscraper-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6e208d1237b11a923c6cbf187d4aab60a4a0c1f90b1cab9f2708fc831a63132b",
"md5": "f12787883f5be57c5f470309e5311e9e",
"sha256": "cf731d82afd7332f7c911d155eb0fe439358a1584a452981bcfcbd15805084e4"
},
"downloads": -1,
"filename": "pymed_paperscraper-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "f12787883f5be57c5f470309e5311e9e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 258251,
"upload_time": "2024-10-18T18:00:34",
"upload_time_iso_8601": "2024-10-18T18:00:34.861909Z",
"url": "https://files.pythonhosted.org/packages/6e/20/8d1237b11a923c6cbf187d4aab60a4a0c1f90b1cab9f2708fc831a63132b/pymed_paperscraper-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-18 18:00:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jannisborn",
"github_project": "pymed",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "pymed-paperscraper"
}
JSON
