gnewsio 0.1.6

A Python client for the GNews API with category, country, and language filtering

GNews IO Client

A Python client for the gnews.io APIs that supports category, country, and language filtering.

Installation

pip install gnewsio

Usage

from gnews.client_builder import Gnews
from gnews.enums import Category, Country, Language
from datetime import datetime

API_KEY = "YOUR_API_KEY"

gnews_client = (Gnews(api_key=API_KEY)
                .set_category(Category.NATION)
                .set_country(Country.UNITED_STATES)
                .set_language(Language.ENGLISH)
                .set_max_article_count(2)
                .set_from_date(datetime(2024, 10, 11, 0, 0, 0))  # YYYY-MM-DDThh:mm:ssZ
                .set_to_date(datetime(2024, 10, 11, 23, 59, 59))  # YYYY-MM-DDThh:mm:ssZ
                .build())

# Response as JSON
response = gnews_client.fetch_top_headlines(to_json=True)
print(response)

# Response as Articles
try:
    response = gnews_client.fetch_top_headlines()
    print(f"Total Articles: {response.total_articles}")
    for article in response.articles:
        print(article)
except Exception as e:
    print(f"Error: {e}")