---
id: googlenewsdecoder
version: "0.1.7"
license: MIT
license_treatment: permissive
maintenance: active
---

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

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

## 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 above — 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

pip install googlenewsdecoder
uv add googlenewsdecoder
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_current
- Install friction: low
- Maintenance: active
- Downloads: 278.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google news url decoder, decode google news links, extract original url from google news, google news redirect resolver, bypass google news url encoding, google news proxy support, web-scraping, url-parsing, news-aggregation

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