Metadata-Version: 2.1
Name: newsi
Version: 0.0.5
Summary: Newsi is Free News API is able to fetch local news and category news in real time.
Home-page: UNKNOWN
Author: Mohammed Alaa Zaki
Author-email: <mohammedalaazakitayyem@gmail.com>
License: UNKNOWN
Keywords: python,news api,free news api,newsi,python free news api,rapidapi,news feed api,google news api,best news api,python news api,python news library,python news package,breaking news api,google news api free,news api for python,news library for python
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Description-Content-Type: text/markdown
License-File: LICENSE


# python-newsi-news-api

## Overview


Free News library for python is able to fetch local news and category news in real time.

Please email mohammedalaazakitayyem@gmail.com if you find any bugs.
This api works by : [Newsi](https://newsi-app.com)

## The News api

This news API supports local news and category news.

1. Top Headlines news
2. Local news
3. World news
4. business news
5. sports news
6. world news
7. politics news
8. technology news
9. entertainment news
10. science news



## Supported-language-and-countries
```
pip install newsi 
```



## Supported-language-and-countries

To get the country and its supported language



```python
from newsi import Supported_language_and_countries
supported_language_and_countries = Supported_language_and_countries()
print(supported_language_and_countries)
```

---


## Local news

Make a get request specifying the local of news you want

Field | Description
------|------------
language | The 2-letter ISO-639-1 code of the language you want to get headlines for. example: ```ar``` ```en``` ```es``` ```fr``` ```he``` .....
country | Find sources that display news in a specific country. Possible options: .```eg``` ```us``` ```es``` ```fr``` ```in``` .....
sort | The order to sort the articles in :<br/>```top``` = Fetch the top news.<br/>```last``` = Fetch the latest news.
page | Use this to page through the results.
limit | Use this to customize the number of stories per page <br/>```default``` = 20<br/> ```Max``` = 100

```python
from newsi import Local
local_news = Local("en","us","top",1,20)
print(local_news)
```

---




## Category news

Make a get request specifying the Category of news you want

Field | Description
------|------------
category | The category you want to get new for. Possible options:```sport``` ```world``` ```business``` ```science_and_technology``` ```education``` ```entertainment``` ```health``` ```travel```.
language | The 2-letter ISO-639-1 code of the language you want to get headlines for. example: ```ar``` ```en``` ```es``` ```fr``` ```he``` .....
country | Find sources that display news in a specific country. Possible options: .```eg``` ```us``` ```es``` ```fr``` ```in``` .....
sort | The order to sort the articles in :<br/>```top``` = Fetch the top news.<br/>```last``` = Fetch the latest news.
page | Use this to page through the results.


```python
from newsi import Category
category_news = Category("world","en","us","top",1,20)
print(category_news)
```

---

