newsdataapi 0.1.11

Python library for newsdata client-API Call

NewsData.io 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.

Installation

Supported Python Versions

Python >= 3.5 fully supported and tested.

Install Package

pip install newsdataapi

Documentation

Newsdataapi docs can be seen here.

Latest News API

GET /1/news

# To get latest news use our news_api method.

from newsdataapi import NewsDataApiClient

# API key authorization, Initialize the client with your API key

api = NewsDataApiClient(apikey='YOUR_API_KEY')
response = api.news_api(q='entertainment')
print(response)

# Latest news with page parameter

response = api.news_api(q='entertainment',page='nextPage_value')
print(response)

# To scroll through all latest news

response = api.news_api(q='entertainment',page='nextPage_value',scroll=True)
print(response)

News Archive API

GET /1/archive

# To get archive news use our archive_api method.

from newsdataapi import NewsDataApiClient

# API key authorization, Initialize the client with your API key

api = NewsDataApiClient(apikey='YOUR_API_KEY')
response = api.archive_api(q='olympic',from_date='2021-01-01',to_date='2021-06-06')
print(response)

# Archive news with page parameter

response = api.archive_api(q='olympic',from_date='2021-01-01',to_date='2021-06-06',page='nextPage_value')
print(response)

# To scroll through all archive news

response = api.archive_api(q='olympic',from_date='2021-01-01',to_date='2021-06-06',page='nextPage_value',scroll=True)
print(response)

News Sources API

GET /1/sources

# To get sources use our sources_api method.

from newsdataapi import NewsDataApiClient

# API key authorization, Initialize the client with your API key

api = NewsDataApiClient(apikey="YOUR_API_KEY")
response = api.sources_api()
print(response)

Crypto News API

GET /1/crypto

# To get crypto news use our crypto_api method.

from newsdataapi import NewsDataApiClient

# API key authorization, Initialize the client with your API key

api = NewsDataApiClient(apikey='YOUR_API_KEY')
response = api.crypto_api(q='bitcoin')
print(response)

# Crypto with page parameter

response = api.crypto_api(q='bitcoin',page='nextPage_value')
print(response)

# To scroll through all crypto news

response = api.crypto_api(q='bitcoin',page='nextPage_value',scroll=True)
print(response)

News API with Pagination

GET /1/news

from newsdataapi import NewsDataApiClient

# API key authorization, Initialize the client with your API key

api = NewsDataApiClient(apikey="YOUR_API_KEY")
response = api.news_api()

# You can go to next page by providing Page parameter

response = api.news_api(page = "nextPage value")

# You can paginate till last page by providing Page parameter in Loop

page=None
while True:
    response = api.news_api(page = page)
    page = response.get('nextPage',None)
    if not page:
        break

News API with Scrolling

# Note: Scrolling through all result will counsume api as per your defined size. you can also define max_result to stop scrolling at desired result size.scroll is avaliable in news_archive,news_api and news_crypto, it will return all result when scrolling is compleated.

from newsdataapi import NewsDataApiClient

# API key authorization, Initialize the client with your API key

api = NewsDataApiClient(apikey="YOUR_API_KEY")

response = api.news_api(q='entertainment',page='nextPage_value',scroll=True,max_result=1000)
print(response)

License

Provided under MIT 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.