Metadata-Version: 2.1
Name: worldnewsapi
Version: 1.2.0
Summary: The world's news wrapped into a single API.
Home-page: 
Author: David Urbansky
Author-email: David Urbansky <mail@worldnewsapi.com>
Project-URL: Homepage, https://worldnewsapi.com
Project-URL: Documentation, https://worldnewsapi.com/docs
Project-URL: Repository, https://github.com/ddsky/world-news-api-clients/tree/main/python
Project-URL: Bug Tracker, https://github.com/ddsky/world-news-api-clients/issues
Keywords: OpenAPI,OpenAPI-Generator,World News API
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: urllib3<2.1.0,>=1.25.3
Requires-Dist: python-dateutil
Requires-Dist: pydantic>=2
Requires-Dist: typing-extensions>=4.7.1

# worldnewsapi
The World News API gives you access to thousands of news sources in over 50 languages from over 150 countries. News are semantically tagged allowing for semantic news search like never before.

This is the python-package for easy acccess to the api.

## Resources

- [Homepage](https://worldnewsapi.com/)
- [Tutorial](https://worldnewsapi.com/docs/#Tutorial-Getting-Started)
- [Full API Documentation](https://github.com/ddsky/world-news-api-clients/blob/main/python/README.md)

## Requirements

Python 3.7+

## Installation & Usage
### pip install

This package is hosted on PyPi, you can install directly using:

```sh
pip install worldnewsapi
```
(you may need to run `pip` with root permission: `sudo pip install worldnewsapi`)

Then import the package:
```python
import worldnewsapi
```

### Setuptools

Install via [Setuptools](http://pypi.python.org/pypi/setuptools).

```sh
python setup.py install --user
```
(or `sudo python setup.py install` to install the package for all users)

Then import the package:
```python
import worldnewsapi
```

### Tests

Execute `pytest` to run the tests.

