# newsdata-client
Python client for [Newsdata API](https://newsdata.io/documentation)
# Installation
Install using pip:
```bash
pip install newsdata-client
```
# Usage
Import the `client` class into your project, and initialize using the `api_key`.
```python
from newsdata_client import NewsDataClient
news_client = NewsDataClient(api_key="pub_XXXXXXXXXXX")
```
# Endpoints
There are four endpoint functions you can use.
You can add keyword arguments for parameters you like.
You can read [this](https://newsdata.io/documentation#latest-news) for more detail
on the parameters available for all the endpoints
```python
# Latest news endpoint
response = news_client.latest()
# Crypto related news endpoint
response = news_client.crypto()
# News archive endpoint, for this endpoint you will have to
# give atleast one parameter, otherwise it will raise NewsDataException
response = news_client.archive(category=["technology"])
# News sources endpoint
response = news_client.sources()
```
# License
This project in under [MIT License](https://github.com/Vikuuu/newsdata-client/blob/main/LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "newsdata-client",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "newsdata, news, newsdata-api",
"author": "Aditya Vikram Singh",
"author_email": "Aditya Vikram Singh <adivik672@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/8a/03/fdc55a68df58998a10f204a4626e69200d298d6df93c03070ddb24ae49f5/newsdata_client-0.1.0.tar.gz",
"platform": null,
"description": "# newsdata-client\n\nPython client for [Newsdata API](https://newsdata.io/documentation)\n\n# Installation\n\nInstall using pip:\n\n```bash\npip install newsdata-client\n```\n\n# Usage\n\nImport the `client` class into your project, and initialize using the `api_key`.\n\n```python\nfrom newsdata_client import NewsDataClient\n\nnews_client = NewsDataClient(api_key=\"pub_XXXXXXXXXXX\")\n```\n# Endpoints\n\nThere are four endpoint functions you can use.\nYou can add keyword arguments for parameters you like.\nYou can read [this](https://newsdata.io/documentation#latest-news) for more detail\non the parameters available for all the endpoints\n\n```python\n# Latest news endpoint\nresponse = news_client.latest() \n\n# Crypto related news endpoint\nresponse = news_client.crypto()\n\n# News archive endpoint, for this endpoint you will have to\n# give atleast one parameter, otherwise it will raise NewsDataException\nresponse = news_client.archive(category=[\"technology\"])\n\n# News sources endpoint\nresponse = news_client.sources()\n```\n\n# License\n\nThis project in under [MIT License](https://github.com/Vikuuu/newsdata-client/blob/main/LICENSE)\n",
"bugtrack_url": null,
"license": null,
"summary": "Newsdata Python Client",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/Vikuuu/newsdata-client",
"Issues": "https://github.com/Vikuuu/newsdata-client/issues"
},
"split_keywords": [
"newsdata",
" news",
" newsdata-api"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "01fd428747f3f7823ae1c656f8c6e7220f1fe8ae45280d998f108d6656280d93",
"md5": "70a4de2aca29dcb74c1beda91a3de4ed",
"sha256": "f27b9f6630f48bb6ef5d800e59254c6e844ed5bff182010854a06a83593edb1c"
},
"downloads": -1,
"filename": "newsdata_client-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "70a4de2aca29dcb74c1beda91a3de4ed",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 6159,
"upload_time": "2025-09-16T16:29:30",
"upload_time_iso_8601": "2025-09-16T16:29:30.776299Z",
"url": "https://files.pythonhosted.org/packages/01/fd/428747f3f7823ae1c656f8c6e7220f1fe8ae45280d998f108d6656280d93/newsdata_client-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8a03fdc55a68df58998a10f204a4626e69200d298d6df93c03070ddb24ae49f5",
"md5": "108126c647e7112d5b849a2fc2312377",
"sha256": "b8e841de2c3e03712327d4dfae198d11bd334e508c934f60bfcf9e68d1d4d7bd"
},
"downloads": -1,
"filename": "newsdata_client-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "108126c647e7112d5b849a2fc2312377",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 3901,
"upload_time": "2025-09-16T16:29:32",
"upload_time_iso_8601": "2025-09-16T16:29:32.282486Z",
"url": "https://files.pythonhosted.org/packages/8a/03/fdc55a68df58998a10f204a4626e69200d298d6df93c03070ddb24ae49f5/newsdata_client-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-16 16:29:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Vikuuu",
"github_project": "newsdata-client",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "newsdata-client"
}
JSON
