googlenewsdecoder
A Python package to decode Google News URLs to their original sources.
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 googlenewsdecoderuv
uv add googlenewsdecoderpoetry
poetry add googlenewsdecoderInstalling 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
Tags
More WWW/HTTP packages
urllib3 is an HTTP client library that provides…
permissive · top 100 on PyPI
requestsRequests is a Python HTTP library that…
permissive · top 100 on PyPI
h11h11 is a pure-Python HTTP/1.1 protocol…
permissive · top 100 on PyPI
httpxHTTPX is a fully featured HTTP client library…
permissive · top 100 on PyPI
httpcoreA minimal low-level HTTP client library that…
permissive · top 100 on PyPI
aiohttpaiohttp is an async HTTP client and server…
permissive · top 100 on PyPI
gnewsGNews searches Google News RSS feeds and…
permissive · top 15,000 on PyPI
ultimate-sitemap-parserParses and crawls sitemaps in multiple formats…
copyleft · top 15,000 on PyPI
SocketSwapSocketSwap intercepts and redirects network…
permissive · top 15,000 on PyPI
websockets-proxyEnables WebSocket connections through HTTP and…
permissive · top 15,000 on PyPI
duckduckgo-searchRetrieves search results from DuckDuckGo for…
permissive · top 5,000 on PyPI
aiohttp_socksProvides a proxy connector for aiohttp that…
permissive · top 5,000 on PyPI
date-guesserExtracts publication dates from web pages by…
permissive · top 15,000 on PyPI
gdownDownloads files and folders from Google Drive,…
permissive · top 5,000 on PyPI
httpx-socksAdds SOCKS4(a), SOCKS5(h), and HTTP CONNECT…
permissive · top 5,000 on PyPI
play-scraperScrapes application metadata and listings from…
permissive · top 15,000 on PyPI