The google-alerts Python module provides an abstract interface for the Google Alerts service. Google does not provide an official API for this service, so interactions are done through web scripting.
Quick Start
Install the library:
pip install google-alerts or python setup.py install
Save your configuration:
google-alerts setup --email <your.mail@foo.com> --password 'password'
Create a monitor:
google-alerts create --term "hello world" --delivery 'rss'
List monitors:
google-alerts list
Delete a monitor:
google-alerts delete --id '89e517961a3148c7:c395b7d271b4eccc:com:en:US'
Sample Code
This sample code shows some of the range of functionality within the module:
from google_alerts import GoogleAlerts
# Create an instance
ga = GoogleAlerts('your.email@gmail.com', '**password**')
# Authenticate your user
ga.authenticate()
# List configured monitors
ga.list()
# Add a new monitor
ga.create("Hello World", {'delivery': 'RSS'})
# Modify an existing monitor
ga.modify("89e517961a3148c7:c395b7d271b4eccc:com:en:US", {'delivery': 'RSS', 'monitor_match': 'ALL'})
# Delete a monitor
ga.delete("89e517961a3148c7:c395b7d271b4eccc:com:en:US")
Example Output
Below is an example monitor:
[{
"term": "hello world",
"user_id": "09738342945634096720",
"language": "en",
"monitor_id": "89e517961a3148c7:c395b7d271b4eccc:com:en:US",
"region": "US",
"rss_link": "https://google.com/alerts/feeds/09738342945634096720/9663349274289663466",
"delivery": "RSS",
"match_type": "BEST"
}]
Features
Add new monitors (RSS or Mail)
Modify existing monitors
Delete monitors by ID or term
List all monitors with details
Changelog
04-29-18
Feature: Allow users to setup exact match queries
Change: Added support for Python3
Bugfix: Removed extra calls causing an error in the decrypt process
04-26-18
Feature: Added a command line utility to the code for easy testing
Bugfix: Removed clobbering error inside of delete routine
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file google-alerts-0.1.2.tar.gz.
File metadata
- Download URL: google-alerts-0.1.2.tar.gz
- Upload date:
- Size: 6.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb64323c05eb7762fc926b20214229c31186799aee566883f08f990a545b35df
|
|
| MD5 |
6d9359b7dfe1f15d8c2966a615d123f7
|
|
| BLAKE2b-256 |
a6bb2a643727736a1bace215784c0c6cf9c93b290caad5bebcc615784bb0cd38
|
File details
Details for the file google_alerts-0.1.2-py3-none-any.whl.
File metadata
- Download URL: google_alerts-0.1.2-py3-none-any.whl
- Upload date:
- Size: 7.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1d34c48b8b864c90ce7c6d5d6bf4a38a28667e7e55d7e963cffa5188ccf7e1d0
|
|
| MD5 |
55e68e60c4df9bc329ee773600a69e99
|
|
| BLAKE2b-256 |
3ae43815c247a1d868937eed71d26e2b8391e0dd5f733bcfaf40ef18772fc5d6
|