[](https://badge.fury.io/py/googlenewsdecoder)
[](https://pypi.org/project/googlenewsdecoder/)
[](https://pepy.tech/project/googlenewsdecoder)
[](https://pepy.tech/project/googlenewsdecoder)
# Google News Decoder
Google News Decoder is a Python package that can decode Google News links or Google News URLs to their original URLs. It is a simple tool that saves you time and effort. If you find it useful, please support the package by hitting the star on GitHub. Your support helps keep the project going!
## Update
- **Version 0.1.7**:
- **New Feature**: Added **proxy support** to handle rate limiting and bypass restrictions.
- **Improved**: Enhanced error handling with a fallback mechanism for decoding parameters.
- **Refined**: Optimized `get_decoding_params` to try decoding via `https://news.google.com/articles` first, falling back to `https://news.google.com/rss/articles` if needed.
- **Updated**: Reduced occurrences of HTTP 429 (Too Many Requests).
- **Removed**: Logging functionality for a cleaner codebase.
- **Fixed**: Resolved time delay issue between requests.
## Demo
## Installation
You can install this package using pip:
```sh
pip install googlenewsdecoder
```
- You can upgrade this package using pip (upgrade to latest version):
```sh
pip install googlenewsdecoder --upgrade
```
## Supported Proxy Formats
- **HTTP/HTTPS Proxy**:
- **With authentication**: `http://user:pass@host:port` or `https://user:pass@host:port`
- **Without authentication**: `http://host:port` or `https://host:port`
- **SOCKS5 Proxy**:
- **With authentication**: `socks5://user:pass@host:port`
- **Without authentication**: `socks5://host:port`
- **IP and Port Only**:
- **HTTP**: `http://127.0.0.1:8080`
- **SOCKS5**: `socks5://127.0.0.1:1080`
## Usage
Here is an example of how to use this package with different decoders:
### Using gnewsdecoder
```python
from googlenewsdecoder import gnewsdecoder
def main():
interval_time = 1 # interval is optional, default is None
source_url = "https://news.google.com/read/CBMi2AFBVV95cUxPd1ZCc1loODVVNHpnbFFTVHFkTG94eWh1NWhTeE9yT1RyNTRXMVV2S1VIUFM3ZlVkVjl6UHh3RkJ0bXdaTVRlcHBjMWFWTkhvZWVuM3pBMEtEdlllRDBveGdIUm9GUnJ4ajd1YWR5cWs3VFA5V2dsZnY1RDZhVDdORHRSSE9EalF2TndWdlh4bkJOWU5UMTdIV2RCc285Q2p3MFA4WnpodUNqN1RNREMwa3d5T2ZHS0JlX0MySGZLc01kWDNtUEkzemtkbWhTZXdQTmdfU1JJaXY?hl=en-US&gl=US&ceid=US%3Aen"
try:
decoded_url = gnewsdecoder(source_url, interval=interval_time)
if decoded_url.get("status"):
print("Decoded URL:", decoded_url["decoded_url"])
else:
print("Error:", decoded_url["message"])
except Exception as e:
print(f"Error occurred: {e}")
if __name__ == "__main__":
main()
```
### Using gnewsdecoder with proxy
```python
from googlenewsdecoder import gnewsdecoder
def main():
interval_time = 1 # interval is optional, default is None
proxy = "http://user:pass@localhost:8080" # proxy is optional, default is None
source_url = "https://news.google.com/read/CBMi2AFBVV95cUxPd1ZCc1loODVVNHpnbFFTVHFkTG94eWh1NWhTeE9yT1RyNTRXMVV2S1VIUFM3ZlVkVjl6UHh3RkJ0bXdaTVRlcHBjMWFWTkhvZWVuM3pBMEtEdlllRDBveGdIUm9GUnJ4ajd1YWR5cWs3VFA5V2dsZnY1RDZhVDdORHRSSE9EalF2TndWdlh4bkJOWU5UMTdIV2RCc285Q2p3MFA4WnpodUNqN1RNREMwa3d5T2ZHS0JlX0MySGZLc01kWDNtUEkzemtkbWhTZXdQTmdfU1JJaXY?hl=en-US&gl=US&ceid=US%3Aen"
try:
decoded_url = gnewsdecoder(source_url, interval=interval_time, proxy=proxy)
if decoded_url.get("status"):
print("Decoded URL:", decoded_url["decoded_url"])
else:
print("Error:", decoded_url["message"])
except Exception as e:
print(f"Error occurred: {e}")
if __name__ == "__main__":
main()
```
### Using a for loop to decode multiple URLs
```python
from googlenewsdecoder import gnewsdecoder
def main():
interval_time = 1 # interval is optional, default is None
source_urls = [
"https://news.google.com/read/CBMilgFBVV95cUxOM0JJaFRwV2dqRDk5dEFpWmF1cC1IVml5WmVtbHZBRXBjZHBfaUsyalRpa1I3a2lKM1ZnZUI4MHhPU2sydi1nX3JrYU0xWjhLaHNfU0N6cEhOYVE2TEptRnRoZGVTU3kzZGJNQzc2aDZqYjJOR0xleTdsemdRVnJGLTVYTEhzWGw4Z19lR3AwR0F1bXlyZ0HSAYwBQVVfeXFMTXlLRDRJUFN5WHg3ZTI0X1F4SjN6bmFIck1IaGxFVVZyOFQxdk1JT3JUbl91SEhsU0NpQzkzRFdHSEtjVGhJNzY4ZTl6eXhESUQ3XzdWVTBGOGgwSmlXaVRmU3BsQlhPVjV4VWxET3FQVzJNbm5CUDlUOHJUTExaME5YbjZCX1NqOU9Ta3U?hl=en-US&gl=US&ceid=US%3Aen",
"https://news.google.com/read/CBMiiAFBVV95cUxQOXZLdC1hSzFqQVVLWGJVZzlPaDYyNjdWTURScV9BbVp0SWhFNzZpSWZxSzdhc0tKbVlHMU13NmZVOFdidFFkajZPTm9SRnlZMWFRZ01CVHh0dXU0TjNVMUxZNk9Ibk5DV3hrYlRiZ20zYkIzSFhMQVVpcTFPc00xQjhhcGV1aXM00gF_QVVfeXFMTmtFQXMwMlY1el9WY0VRWEh5YkxXbHF0SjFLQVByNk1xS3hpdnBuUDVxOGZCQXl1QVFXaUVpbk5lUGgwRVVVT25tZlVUVWZqQzc4cm5MSVlfYmVlclFTOUFmTHF4eTlfemhTa2JKeG14bmNabENkSmZaeHB4WnZ5dw?hl=en-US&gl=US&ceid=US%3Aen"
]
for url in source_urls:
try:
decoded_url = gnewsdecoder(url, interval=interval_time)
if decoded_url.get("status"):
print("Decoded URL:", decoded_url["decoded_url"])
else:
print("Error:", decoded_url["message"])
except Exception as e:
print(f"Error occurred: {e}")
if __name__ == "__main__":
main()
```
### Using a for loop to decode multiple URLs with Proxy
```python
from googlenewsdecoder import gnewsdecoder
def main():
interval_time = 1 # interval is optional, default is None
proxy = "http://user:pass@localhost:8080" # proxy is optional, default is None
source_urls = [
"https://news.google.com/read/CBMilgFBVV95cUxOM0JJaFRwV2dqRDk5dEFpWmF1cC1IVml5WmVtbHZBRXBjZHBfaUsyalRpa1I3a2lKM1ZnZUI4MHhPU2sydi1nX3JrYU0xWjhLaHNfU0N6cEhOYVE2TEptRnRoZGVTU3kzZGJNQzc2aDZqYjJOR0xleTdsemdRVnJGLTVYTEhzWGw4Z19lR3AwR0F1bXlyZ0HSAYwBQVVfeXFMTXlLRDRJUFN5WHg3ZTI0X1F4SjN6bmFIck1IaGxFVVZyOFQxdk1JT3JUbl91SEhsU0NpQzkzRFdHSEtjVGhJNzY4ZTl6eXhESUQ3XzdWVTBGOGgwSmlXaVRmU3BsQlhPVjV4VWxET3FQVzJNbm5CUDlUOHJUTExaME5YbjZCX1NqOU9Ta3U?hl=en-US&gl=US&ceid=US%3Aen",
"https://news.google.com/read/CBMiiAFBVV95cUxQOXZLdC1hSzFqQVVLWGJVZzlPaDYyNjdWTURScV9BbVp0SWhFNzZpSWZxSzdhc0tKbVlHMU13NmZVOFdidFFkajZPTm9SRnlZMWFRZ01CVHh0dXU0TjNVMUxZNk9Ibk5DV3hrYlRiZ20zYkIzSFhMQVVpcTFPc00xQjhhcGV1aXM00gF_QVVfeXFMTmtFQXMwMlY1el9WY0VRWEh5YkxXbHF0SjFLQVByNk1xS3hpdnBuUDVxOGZCQXl1QVFXaUVpbk5lUGgwRVVVT25tZlVUVWZqQzc4cm5MSVlfYmVlclFTOUFmTHF4eTlfemhTa2JKeG14bmNabENkSmZaeHB4WnZ5dw?hl=en-US&gl=US&ceid=US%3Aen"
]
for url in source_urls:
try:
decoded_url = gnewsdecoder(url, interval=interval_time, proxy=proxy)
if decoded_url.get("status"):
print("Decoded URL:", decoded_url["decoded_url"])
else:
print("Error:", decoded_url["message"])
except Exception as e:
print(f"Error occurred: {e}")
if __name__ == "__main__":
main()
```
## Thank You
Thank you for installing and using Google News Decoder! I hope this tool saves you time and effort when working with Google News URLs. If you find it useful, please consider hitting the star button on GitHub. If you’d like to contribute or fork the project, your support is greatly appreciated. Thank you for your support!
## Credits
- Original script by [huksley](https://gist.github.com/huksley/)
Raw data
{
"_id": null,
"home_page": "https://github.com/SSujitX/google-news-url-decoder",
"name": "googlenewsdecoder",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "google news decoder",
"author": "Sujit Biswas",
"author_email": "ssujitxx@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/9f/99/d01ae4a3aa30e4d75e7ab6832cb44d79b298a2083b7776f3c8b8830b0aba/googlenewsdecoder-0.1.7.tar.gz",
"platform": null,
"description": "[](https://badge.fury.io/py/googlenewsdecoder)\n[](https://pypi.org/project/googlenewsdecoder/)\n[](https://pepy.tech/project/googlenewsdecoder)\n[](https://pepy.tech/project/googlenewsdecoder)\n\n# Google News Decoder\n\nGoogle News Decoder is a Python package that can decode Google News links or Google News URLs to their original URLs. It is a simple tool that saves you time and effort. If you find it useful, please support the package by hitting the star on GitHub. Your support helps keep the project going!\n\n## Update\n\n- **Version 0.1.7**:\n - **New Feature**: Added **proxy support** to handle rate limiting and bypass restrictions.\n - **Improved**: Enhanced error handling with a fallback mechanism for decoding parameters.\n - **Refined**: Optimized `get_decoding_params` to try decoding via `https://news.google.com/articles` first, falling back to `https://news.google.com/rss/articles` if needed.\n - **Updated**: Reduced occurrences of HTTP 429 (Too Many Requests).\n - **Removed**: Logging functionality for a cleaner codebase.\n - **Fixed**: Resolved time delay issue between requests.\n\n## Demo\n\n\n\n## Installation\n\nYou can install this package using pip:\n\n```sh\npip install googlenewsdecoder\n```\n\n- You can upgrade this package using pip (upgrade to latest version):\n\n```sh\npip install googlenewsdecoder --upgrade\n```\n\n## Supported Proxy Formats\n\n- **HTTP/HTTPS Proxy**:\n\n - **With authentication**: `http://user:pass@host:port` or `https://user:pass@host:port`\n - **Without authentication**: `http://host:port` or `https://host:port`\n\n- **SOCKS5 Proxy**:\n\n - **With authentication**: `socks5://user:pass@host:port`\n - **Without authentication**: `socks5://host:port`\n\n- **IP and Port Only**:\n - **HTTP**: `http://127.0.0.1:8080`\n - **SOCKS5**: `socks5://127.0.0.1:1080`\n\n## Usage\n\nHere is an example of how to use this package with different decoders:\n\n### Using gnewsdecoder\n\n```python\nfrom googlenewsdecoder import gnewsdecoder\n\ndef main():\n interval_time = 1 # interval is optional, default is None\n\n source_url = \"https://news.google.com/read/CBMi2AFBVV95cUxPd1ZCc1loODVVNHpnbFFTVHFkTG94eWh1NWhTeE9yT1RyNTRXMVV2S1VIUFM3ZlVkVjl6UHh3RkJ0bXdaTVRlcHBjMWFWTkhvZWVuM3pBMEtEdlllRDBveGdIUm9GUnJ4ajd1YWR5cWs3VFA5V2dsZnY1RDZhVDdORHRSSE9EalF2TndWdlh4bkJOWU5UMTdIV2RCc285Q2p3MFA4WnpodUNqN1RNREMwa3d5T2ZHS0JlX0MySGZLc01kWDNtUEkzemtkbWhTZXdQTmdfU1JJaXY?hl=en-US&gl=US&ceid=US%3Aen\"\n\n try:\n decoded_url = gnewsdecoder(source_url, interval=interval_time)\n\n if decoded_url.get(\"status\"):\n print(\"Decoded URL:\", decoded_url[\"decoded_url\"])\n else:\n print(\"Error:\", decoded_url[\"message\"])\n except Exception as e:\n print(f\"Error occurred: {e}\")\n\nif __name__ == \"__main__\":\n main()\n```\n\n### Using gnewsdecoder with proxy\n\n```python\nfrom googlenewsdecoder import gnewsdecoder\n\ndef main():\n interval_time = 1 # interval is optional, default is None\n proxy = \"http://user:pass@localhost:8080\" # proxy is optional, default is None\n\n source_url = \"https://news.google.com/read/CBMi2AFBVV95cUxPd1ZCc1loODVVNHpnbFFTVHFkTG94eWh1NWhTeE9yT1RyNTRXMVV2S1VIUFM3ZlVkVjl6UHh3RkJ0bXdaTVRlcHBjMWFWTkhvZWVuM3pBMEtEdlllRDBveGdIUm9GUnJ4ajd1YWR5cWs3VFA5V2dsZnY1RDZhVDdORHRSSE9EalF2TndWdlh4bkJOWU5UMTdIV2RCc285Q2p3MFA4WnpodUNqN1RNREMwa3d5T2ZHS0JlX0MySGZLc01kWDNtUEkzemtkbWhTZXdQTmdfU1JJaXY?hl=en-US&gl=US&ceid=US%3Aen\"\n\n try:\n decoded_url = gnewsdecoder(source_url, interval=interval_time, proxy=proxy)\n\n if decoded_url.get(\"status\"):\n print(\"Decoded URL:\", decoded_url[\"decoded_url\"])\n else:\n print(\"Error:\", decoded_url[\"message\"])\n except Exception as e:\n print(f\"Error occurred: {e}\")\n\nif __name__ == \"__main__\":\n main()\n```\n\n### Using a for loop to decode multiple URLs\n\n```python\nfrom googlenewsdecoder import gnewsdecoder\n\ndef main():\n interval_time = 1 # interval is optional, default is None\n\n source_urls = [\n \"https://news.google.com/read/CBMilgFBVV95cUxOM0JJaFRwV2dqRDk5dEFpWmF1cC1IVml5WmVtbHZBRXBjZHBfaUsyalRpa1I3a2lKM1ZnZUI4MHhPU2sydi1nX3JrYU0xWjhLaHNfU0N6cEhOYVE2TEptRnRoZGVTU3kzZGJNQzc2aDZqYjJOR0xleTdsemdRVnJGLTVYTEhzWGw4Z19lR3AwR0F1bXlyZ0HSAYwBQVVfeXFMTXlLRDRJUFN5WHg3ZTI0X1F4SjN6bmFIck1IaGxFVVZyOFQxdk1JT3JUbl91SEhsU0NpQzkzRFdHSEtjVGhJNzY4ZTl6eXhESUQ3XzdWVTBGOGgwSmlXaVRmU3BsQlhPVjV4VWxET3FQVzJNbm5CUDlUOHJUTExaME5YbjZCX1NqOU9Ta3U?hl=en-US&gl=US&ceid=US%3Aen\",\n \"https://news.google.com/read/CBMiiAFBVV95cUxQOXZLdC1hSzFqQVVLWGJVZzlPaDYyNjdWTURScV9BbVp0SWhFNzZpSWZxSzdhc0tKbVlHMU13NmZVOFdidFFkajZPTm9SRnlZMWFRZ01CVHh0dXU0TjNVMUxZNk9Ibk5DV3hrYlRiZ20zYkIzSFhMQVVpcTFPc00xQjhhcGV1aXM00gF_QVVfeXFMTmtFQXMwMlY1el9WY0VRWEh5YkxXbHF0SjFLQVByNk1xS3hpdnBuUDVxOGZCQXl1QVFXaUVpbk5lUGgwRVVVT25tZlVUVWZqQzc4cm5MSVlfYmVlclFTOUFmTHF4eTlfemhTa2JKeG14bmNabENkSmZaeHB4WnZ5dw?hl=en-US&gl=US&ceid=US%3Aen\"\n ]\n\n for url in source_urls:\n try:\n decoded_url = gnewsdecoder(url, interval=interval_time)\n if decoded_url.get(\"status\"):\n print(\"Decoded URL:\", decoded_url[\"decoded_url\"])\n else:\n print(\"Error:\", decoded_url[\"message\"])\n except Exception as e:\n print(f\"Error occurred: {e}\")\n\nif __name__ == \"__main__\":\n main()\n```\n\n### Using a for loop to decode multiple URLs with Proxy\n\n```python\nfrom googlenewsdecoder import gnewsdecoder\n\ndef main():\n interval_time = 1 # interval is optional, default is None\n proxy = \"http://user:pass@localhost:8080\" # proxy is optional, default is None\n\n source_urls = [\n \"https://news.google.com/read/CBMilgFBVV95cUxOM0JJaFRwV2dqRDk5dEFpWmF1cC1IVml5WmVtbHZBRXBjZHBfaUsyalRpa1I3a2lKM1ZnZUI4MHhPU2sydi1nX3JrYU0xWjhLaHNfU0N6cEhOYVE2TEptRnRoZGVTU3kzZGJNQzc2aDZqYjJOR0xleTdsemdRVnJGLTVYTEhzWGw4Z19lR3AwR0F1bXlyZ0HSAYwBQVVfeXFMTXlLRDRJUFN5WHg3ZTI0X1F4SjN6bmFIck1IaGxFVVZyOFQxdk1JT3JUbl91SEhsU0NpQzkzRFdHSEtjVGhJNzY4ZTl6eXhESUQ3XzdWVTBGOGgwSmlXaVRmU3BsQlhPVjV4VWxET3FQVzJNbm5CUDlUOHJUTExaME5YbjZCX1NqOU9Ta3U?hl=en-US&gl=US&ceid=US%3Aen\",\n \"https://news.google.com/read/CBMiiAFBVV95cUxQOXZLdC1hSzFqQVVLWGJVZzlPaDYyNjdWTURScV9BbVp0SWhFNzZpSWZxSzdhc0tKbVlHMU13NmZVOFdidFFkajZPTm9SRnlZMWFRZ01CVHh0dXU0TjNVMUxZNk9Ibk5DV3hrYlRiZ20zYkIzSFhMQVVpcTFPc00xQjhhcGV1aXM00gF_QVVfeXFMTmtFQXMwMlY1el9WY0VRWEh5YkxXbHF0SjFLQVByNk1xS3hpdnBuUDVxOGZCQXl1QVFXaUVpbk5lUGgwRVVVT25tZlVUVWZqQzc4cm5MSVlfYmVlclFTOUFmTHF4eTlfemhTa2JKeG14bmNabENkSmZaeHB4WnZ5dw?hl=en-US&gl=US&ceid=US%3Aen\"\n ]\n\n for url in source_urls:\n try:\n decoded_url = gnewsdecoder(url, interval=interval_time, proxy=proxy)\n if decoded_url.get(\"status\"):\n print(\"Decoded URL:\", decoded_url[\"decoded_url\"])\n else:\n print(\"Error:\", decoded_url[\"message\"])\n except Exception as e:\n print(f\"Error occurred: {e}\")\n\nif __name__ == \"__main__\":\n main()\n```\n\n## Thank You\n\nThank you for installing and using Google News Decoder! I hope this tool saves you time and effort when working with Google News URLs. If you find it useful, please consider hitting the star button on GitHub. If you\u2019d like to contribute or fork the project, your support is greatly appreciated. Thank you for your support!\n\n## Credits\n\n- Original script by [huksley](https://gist.github.com/huksley/)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python package to decode Google News URLs to their original sources.",
"version": "0.1.7",
"project_urls": {
"Bug Tracker": "https://github.com/SSujitX/google-news-url-decoder/issues",
"Documentation": "https://github.com/SSujitX/google-news-url-decoder#readme",
"Homepage": "https://github.com/SSujitX/google-news-url-decoder",
"Source Code": "https://github.com/SSujitX/google-news-url-decoder"
},
"split_keywords": [
"google",
"news",
"decoder"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c5820ff6da895449c6703d24129c4319c5cc2545b0c2c39893f95156b1d841ae",
"md5": "9efc11767aa79c920465faefcff9a6c5",
"sha256": "a8be897bb41864a82d81da6e05777d8c795989cf65f14b41e8e772b3f5a8354d"
},
"downloads": -1,
"filename": "googlenewsdecoder-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9efc11767aa79c920465faefcff9a6c5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 16520,
"upload_time": "2025-01-18T20:05:09",
"upload_time_iso_8601": "2025-01-18T20:05:09.778983Z",
"url": "https://files.pythonhosted.org/packages/c5/82/0ff6da895449c6703d24129c4319c5cc2545b0c2c39893f95156b1d841ae/googlenewsdecoder-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9f99d01ae4a3aa30e4d75e7ab6832cb44d79b298a2083b7776f3c8b8830b0aba",
"md5": "fffae25aee7122dd2b166f7d79c3a435",
"sha256": "0fcd8fa2aa6a145f84798921aeef0ec45d40bcf5ceebb467742f0efd068d3902"
},
"downloads": -1,
"filename": "googlenewsdecoder-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "fffae25aee7122dd2b166f7d79c3a435",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 12591,
"upload_time": "2025-01-18T20:05:11",
"upload_time_iso_8601": "2025-01-18T20:05:11.741436Z",
"url": "https://files.pythonhosted.org/packages/9f/99/d01ae4a3aa30e4d75e7ab6832cb44d79b298a2083b7776f3c8b8830b0aba/googlenewsdecoder-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-18 20:05:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SSujitX",
"github_project": "google-news-url-decoder",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "googlenewsdecoder"
}
JSON
