---
id: gnews
version: "0.8.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# gnews — Provide an API to search for articles on Google News and returns a usable JSON response.

License: permissive · Maintenance: active · Downloads: 124.4K/mo

## What it is and what it does

GNews is a lightweight Python wrapper around Google News RSS feeds that returns article metadata (title, description, publisher, URL, publication date) as JSON. It lets you search for news by keyword, topic (WORLD, BUSINESS, TECHNOLOGY, SPORTS, etc.), geographic location, or specific news site, with filtering options for language, country, date range, and result count. The package also supports fetching full article text and resolving Google News redirect URLs through optional dependencies.

The core use case is building news aggregation tools, monitoring systems, or analysis pipelines without writing custom RSS parsers or web scrapers. It handles the boilerplate of querying Google News, parsing feeds, and normalizing the response format. The package is actively maintained, has no known vulnerabilities, and depends only on standard HTTP and HTML parsing libraries.

Use it for:

- Monitor news headlines on a specific topic or keyword and trigger alerts when articles match certain criteria.
- Build a news dashboard that aggregates articles from multiple countries or languages into a single feed.
- Collect news data for sentiment analysis, topic modeling, or other NLP research on recent headlines.
- Track coverage of a specific company or person across different news sources and regions.
- Export filtered news results to CSV or JSON for downstream analysis or archival.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

GNews searches Google News RSS feeds and returns article metadata as JSON, with optional full-text extraction and support for filtering by keyword, topic, location, site, date range, and language across 141+ countries.

Yes. GNews is actively maintained, has no security vulnerabilities, low install friction, and solves a real problem—querying Google News without writing custom scrapers. The permissive MIT license removes legal friction. Install it if you need to aggregate news programmatically; skip it only if you require a commercial news API with SLA guarantees or need to handle Google's rate-limiting at scale.

## Install

pip install gnews
uv add gnews
poetry add gnews

## Installing gnews

Before you install: Low install friction with a pure-Python wheel and four common dependencies (feedparser, beautifulsoup4, dnspython, requests). Actively maintained with a recent release and 1003 repository stars.

License in practice: Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install gnews

from gnews import GNews

google_news = GNews()
articles = google_news.get_news('Pakistan')
print(articles[0])

Optional extras (gnews[fulltext] for article text, gnews[playwright] for URL resolution) require additional setup; base install works without them.

Verify before relying:

- Whether Google News actively blocks or rate-limits programmatic access and how often the package maintainer updates to handle such changes.
- Actual success rate and latency of RSS feed queries under typical usage patterns.
- Whether the package handles Google News feed schema changes automatically or requires manual updates.

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 124.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google news api python, news aggregation search, rss feed parser json, news by keyword location, article scraper google news, news-aggregation, rss-feed, web-scraping

[View on SkillFed](https://skillfed.io/packages/gnews) · [View on PyPI](https://pypi.org/project/gnews/)