# ranahaani/GNews

A Happy and lightweight Python Package that Provides an API to search for articles on Google News and returns a JSON response.

Repository: https://github.com/ranahaani/GNews
Canonical: https://ross.abutalabs.com/products/gnews
Homepage: https://pypi.org/project/gnews/
Language: Python
License: MIT
License Family: permissive
Topics: gnews, newspaper3k, article, google-news, google-news-api, google-news-scraper, python, rss-feed, google-news-homepage, google-news-rss, hacktoberfest, news, hacktoberfest-accepted, hacktoberfest2025
Last push: 2026-08-31T08:40:52+00:00

## Health v2 (maintenance only)
Score: 68/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 100, release rhythm 8, longevity 100
- inputs: {"age_days": 2023, "days_push": 2, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1006, forks 150 (observed 2026-09-01T02:14:06.193768+00:00)

## What it is
GNews is a lightweight Python package that queries the Google News RSS feed and returns article results as usable JSON. It supports keyword, topic, site, and geo-based searches across 141+ countries and 41+ languages, with optional full-text article extraction and a CLI.

## Use cases
- scrape google news articles in python
- get top news headlines as json
- search news by keyword or topic
- fetch full article text from news urls
- monitor news for a specific country or language
- collect news articles for nlp datasets

## When to choose
- you need a simple, dependency-light way to query Google News without an official API key
- you want JSON results with optional full article extraction
- you need multi-country and multi-language news coverage

## When to avoid
- you need a guaranteed SLA or commercial-grade news API (Google may block or change the RSS feed)
- you need non-Google news sources or deep historical archives
- you need high-volume scraping at scale

## Facets
- artifact type: library
- maturity: active
- function: web-scraping, http-client, search-engine, cli, json
- domain: crawlers, developer-tools
- platform: python, cli, cross-platform
- tags: google-news, rss-feed, news-scraper, article-extraction, newspaper3k, news, natural-language-processing

## Member repositories
- ranahaani/GNews (main) score 68

## Provenance
- Observed fields: from GitHub, fetched 2026-09-01T02:14:06.193768+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:13:39.692329+00:00, confidence not recorded.
  - readme: https://github.com/ranahaani/GNews (fetched 2026-09-01T02:14:06.193768+00:00, sha 092a42b7ca7d)
  - homepage: https://pypi.org/project/gnews/ (fetched 2026-08-29T13:13:26.151259+00:00, sha 79e0a9458453)
  - registry_pypi: https://pypi.org/pypi/gnews/json (fetched 2026-08-29T13:13:26.161247+00:00, sha 089f98076fa4)
- Data as of 2026-08-30T08:39:29.467469+00:00.