Skip to main content
https://readthedocs.org/projects/google-alerts/badge/?version=latest https://badge.fury.io/py/google-alerts.svg https://img.shields.io/badge/License-MIT-yellow.svg

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

  • 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

google-alerts-0.1.1.tar.gz (6.6 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

google_alerts-0.1.1-py3.6.egg (14.5 kB view details)

Uploaded Egg

google_alerts-0.1.1-py3-none-any.whl (7.5 kB view details)

Uploaded Python 3

File details

Details for the file google-alerts-0.1.1.tar.gz.

File metadata

  • Download URL: google-alerts-0.1.1.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for google-alerts-0.1.1.tar.gz
Algorithm Hash digest
SHA256 afc8f796f83298f259dc17dbf57889a6fd0325f6eea022f17807e65463a3be7b
MD5 9fae04ecc62947e6be6cfd971808d034
BLAKE2b-256 a97a0022a0ebb8046c917861991183ae543c795e4bee472ae19098318e7b5015

See more details on using hashes here.

File details

Details for the file google_alerts-0.1.1-py3.6.egg.

File metadata

File hashes

Hashes for google_alerts-0.1.1-py3.6.egg
Algorithm Hash digest
SHA256 b06d355c03b0a9f2247a14180b25e1a54bf9914e862554c9f11b52780f5c3218
MD5 677b761ba1352380d404e1b1eff6d51f
BLAKE2b-256 aa3219729d3f0f707c589ca85cbfccbcf47dbf55e21e48c192a1f6c5db7d7439

See more details on using hashes here.

File details

Details for the file google_alerts-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for google_alerts-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8c92c3bce50539a3c4a291830c67434d156b68eba7559ba71e02b2b00bbbc81a
MD5 d47fa74d208a46dd6766eb8ac2446b4b
BLAKE2b-256 f9b1c891fcacf916797e3c0c63c69721890311d5ded2ca167274a451c5716d14

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page