skillfed

googlenewsdecoder

A Python package to decode Google News URLs to their original sources.

googlenewsdecoder v0.1.7 278.2K downloads/30d#8,134 on PyPI295
Permissive license MIT Active released

What it is and what it does

Google News Decoder is a utility that reverses Google News' URL obfuscation, converting redirect links back to their original article sources. It works by making HTTP requests to Google News endpoints and extracting the target URL from the response. The package is designed to save time when you need to access the actual source of a news article shared via Google News.

The package includes proxy support (HTTP/HTTPS and SOCKS5) to handle rate limiting and bypass restrictions, with optional request intervals to reduce HTTP 429 errors. It returns a dictionary with a status flag and either the decoded URL or an error message. The implementation uses requests for HTTP operations and selectolax for parsing, with pysocks enabling SOCKS5 proxy functionality.

Use it for:

  • Batch-decode multiple Google News URLs to their original sources for content aggregation or archival
  • Integrate into a news scraper to resolve obfuscated links before storing article metadata
  • Use with a proxy rotation service to decode large volumes of Google News links without hitting rate limits
  • Extract source URLs from Google News feeds for automated content distribution or analysis
  • Bypass Google News URL encoding in scripts that need direct access to publisher sites

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Decodes Google News redirect URLs to their original source URLs, with support for HTTP/HTTPS and SOCKS5 proxies to handle rate limiting.

Yes, if you regularly work with Google News URLs. The package is actively maintained, has no known vulnerabilities, installs with low friction, and solves a specific problem well. The MIT license is permissive. Consider it essential for news aggregation or scraping workflows; optional for one-off URL decoding.

Install

googlenewsdecoder on PyPI

pip

pip install googlenewsdecoder

uv

uv add googlenewsdecoder

poetry

poetry add googlenewsdecoder

Installing googlenewsdecoder

Before you install

Low friction install with three common dependencies (requests, selectolax, pysocks). Package is actively maintained with recent updates; last commit 2026-08-03 and latest release 2025-01-18. Requires Python 3.9 or later.

License in practice

MIT license is permissive, allowing free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install googlenewsdecoder

from googlenewsdecoder import gnewsdecoder

source_url = "https://news.google.com/read/CBMi..."
decoded = gnewsdecoder(source_url, interval=1, proxy="http://host:port")
if decoded.get("status"):
    print(decoded["decoded_url"])
else:
    print(decoded["message"])

Requires Python 3.9 or later.

Verify before relying

  • Whether the package handles all current Google News URL formats or only specific patterns
  • Rate-limiting behavior and effectiveness of the fallback mechanism across different proxy types
  • Error handling specifics when decoding fails (e.g., network errors vs. malformed URLs)

Package facts

License MIT (permissive)
Python support supports the current Python release (>=3.9)
Install friction low — pure-Python wheel
Runtime dependencies 3 — requests, selectolax, pysocks
Maintenance actively maintained — 573 days since the last release
Last repo commit
First released
Downloads 278,220/month — #8,134 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: googlenewsdecoder-0.1.7-py3-none-any.whl

Keywords: google, news, decoder

License :: OSI Approved :: MIT LicenseOperating System :: OS IndependentProgramming Language :: Python :: 3

Tags

google news url decoderdecode google news linksextract original url from google newsgoogle news redirect resolverbypass google news url encodinggoogle news proxy support
web-scrapingurl-parsingnews-aggregation

More WWW/HTTP packages