Metadata-Version: 2.1
Name: newsdataapi
Version: 0.1.1
Summary: Python library for newsdata client-API Call
Home-page: https://github.com/newsdataapi/python-client
Author: Newsdata
Author-email: contact@newsdata.io
License: MIT
Description: ![Alt text](https://raw.githubusercontent.com/newsdataapi/python-client/main/newsdata-logo.png)
        
        # <p align="center">Newsdataapi Python Client
        newsdataapi allows you to create a library for accessing http services easily, in a centralized way. An API defined by newsdataapi will return a JSON object when called.
        
        [![Build Status](https://img.shields.io/github/workflow/status/newsdataapi/python-client/Upload%20Python%20Package)](https://github.com/newsdataapi/python-client/actions/workflows/python-publish.yml)
        [![License](https://img.shields.io/badge/license-MIT-blue)](https://github.com/newsdataapi/python-client/blob/main/LICENSE)
        [![PyPI](https://img.shields.io/pypi/v/newsdataapi?color=084298)](https://pypi.org/project/newsdataapi)
        [![Supported Python versions](https://img.shields.io/pypi/pyversions/newsdataapi)](https://pypi.org/project/newsdataapi)
        [![Python](https://img.shields.io/badge/python-3-blue)](https://pypi.org/project/newsdataapi)
        
        
        <br />
        
        # Installation
        
        ## Supported Python Versions
        Python >= 3.5 fully supported and tested.
        
        ## Install Package
        ```
        pip install newsdataapi
        ```
        
        ## Quick Start
        
        Newsdataapi docs can be seen [here](https://newsdata.io/docs).
        
        <br />
        
        ### Latest News API
        
        `GET /1/news`
        
        ```
        from newsdataapi import NewsDataApiClient
        
        # API key authorization, Initialize the client with your API key
        api = NewsDataApiClient(apikey="API key")
        
        # You can pass empty or with request parameters {ex. (country = "us")}
        response = api.news_api()
        
        ```
        `API key` : Your private Newsdata API key. 
        
        `country` : You can pass a comma seperated string of 2-letter ISO 3166-1 countries (maximum 5) to restrict the search to. Possible Options: `us` `gb` `in` `jp` `ae` `sa` `au` `ca` `sg` 
        
        `category` : A comma seperated string of categories (maximum 5) to restrict the search to. Possible Options: `top`, `business`, `science`, `technology`, `sports`, `health`, `entertainment`
        
        `language` : A comma seperated string of languages (maximum 5) to restrict the search to. Possible Options: `en`, `ar`, `jp`, `in`, `es`, `fr`
        
        `domain` : A comma seperated string of domains (maximum 5) to restrict the search to. Use the /domains endpoint to find top sources id.
         
        `q` : Keywords or phrases to search for in the news title and content. The value must be URL-encoded. Advance search options: Search Social q=social, Search "Social Pizza" q=social pizza, Search Social but not with pizza. social -pizza q=social -pizza, Search Social but not with pizza and wildfire. social -pizza -wildfire q=social -pizza -wildfire, Search multiple keyword with AND operator. social AND pizza q=social AND pizza 
        
        `qInTitle` : Keywords or phrases to search for in the news title only.
        
        `page` : Use this to page through the results if the total results found is greater than the page size.
        
        
        
        <br />
        
        ### News Archive API
        
        `GET /1/archive`
        
        ```
        from newsdataapi import NewsDataApiClient
        
        # API key authorization, Initialize the client with your API key
        api = NewsDataApiClient(apikey="API key")
        
        # You can pass empty or with request parameters {ex. (country = "us")}
        response = api.archive_api()
        
        ```
        `API key` : Your private Newsdata API key. 
        
        `country` : You can pass a comma seperated string of 2-letter ISO 3166-1 countries (maximum 5) to restrict the search to. Possible Options: `us` `gb` `in` `jp` `ae` `sa` `au` `ca` `sg` 
        
        `category` : A comma seperated string of categories (maximum 5) to restrict the search to. Possible Options: `top`, `business`, `science`, `technology`, `sports`, `health`, `entertainment`
        
        `language` : A comma seperated string of languages (maximum 5) to restrict the search to. Possible Options: `en`, `ar`, `jp`, `in`, `es`, `fr`
        
        `domain` : A comma seperated string of domains (maximum 5) to restrict the search to. Use the /domains endpoint to find top sources id.
        
        `from_date` : A date and optional time for the oldest article allowed. This should be in ISO 8601 format (e.g. `2021-04-18` or `2021-04-18T04:04:34`)
        
        `to_date` : A date and optional time for the newest article allowed. This should be in ISO 8601 format (e.g. `2021-04-18` or `2021-04-18T04:04:34`)
         
        `q` : Keywords or phrases to search for in the news title and content. The value must be URL-encoded. Advance search options: Search Social q=social, Search "Social Pizza" q=social pizza, Search Social but not with pizza. social -pizza q=social -pizza, Search Social but not with pizza and wildfire. social -pizza -wildfire q=social -pizza -wildfire, Search multiple keyword with AND operator. social AND pizza q=social AND pizza 
        
        `qInTitle` : Keywords or phrases to search for in the news title only.
        
        `page` : Use this to page through the results if the total results found is greater than the page size.
        
        
        
        <br />
        
        
        ### News Sources API
        
        `GET /1/sources`
        
        ```
        from newsdataapi import NewsDataApiClient
        
        # API key authorization, Initialize the client with your API key
        api = NewsDataApiClient(apikey="API key")
        
        # You can pass empty or with request parameters {ex. (country = "us")}
        response = api.sources_api()
        
        ```
        `API key` : Your private Newsdata API key. 
        
        `country` : Find sources that display news in a specific country. Possible Options: `us` `gb` `in` `jp` `ae` `sa` `au` `ca` `sg` 
        
        `category` : Find sources that display news of this category. Possible Options: `top`, `business`, `science`, `technology`, `sports`, `health`, `entertainment`
        
        `language` : Find sources that display news in a specific language. Possible Options: `en`, `ar`, `jp`, `in`, `es`, `fr`
        
        <br />
        
        ## License
        
        Provided under [MIT License](https://github.com/newsdataapi/python-client/blob/main/LICENSE) by Matt Lisivick.
        
        ```
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
        FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
        COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
        IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
        CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
        ```
Keywords: news,news data
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Customer Service
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.5
Description-Content-Type: text/markdown
