Quickstart

Search news

from gnews import GNews

g = GNews()
articles = g.get_news("artificial intelligence")

for article in articles:
    print(article["title"])
    print(article["url"])

Top headlines

g = GNews(max_results=10)
articles = g.get_top_news()

Filter by language and country

g = GNews(language="de", country="DE", max_results=5)
articles = g.get_news("Bundesliga")

What you get back

Each article is a dict:

{
    "title": "OpenAI announces GPT-5",
    "description": "OpenAI has released...",
    "published date": "Mon, 15 Jun 2026 10:00:00 GMT",
    "url": "https://techcrunch.com/...",
    "publisher": "TechCrunch"
}

See Article Properties for the full field reference.