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' --frequency 'realtime'

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

10-13-18

  • Feature: Detect when user changes between Python versions during setup

  • Bugfix: Setup process appears to finally be bug-free, screw python2 support

07-10-18

  • Feature: Added the ability to set the frequency when creating alerts

  • Bugfix: Fixed frequency settings when using the mail delivery method

05-30-18

  • Change: Explicitly detect when a CAPTCHA is being thrown

05-28-18

  • Feature: Take advantage of the config file concept inside of the class

  • Feature: Authenticate users with a session file if it’s available

  • Change: Tell Chrome to avoid using Javascript so we get the old form

05-25-18

  • Change: Added headers to all calls to look like less of a bot

  • Bugfix: Wrapped a problem area when inspecting the forms in a page

  • Bugfix: Handled setup error for Python3

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

google-alerts-0.1.9.tar.gz (9.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.9-py3.6.egg (28.3 kB view details)

Uploaded Egg

google_alerts-0.1.9-py2.7.egg (28.3 kB view details)

Uploaded Egg

google_alerts-0.1.9-py2-none-any.whl (12.8 kB view details)

Uploaded Python 2

File details

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

File metadata

  • Download URL: google-alerts-0.1.9.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.23.0 CPython/2.7.10

File hashes

Hashes for google-alerts-0.1.9.tar.gz
Algorithm Hash digest
SHA256 d6e3810962fbd8018446e9cfea23a58f61a5ade12a9daec9f0179aaafc48c646
MD5 638003d50219729e6f585114bf0827f2
BLAKE2b-256 8d978bf7171677ced7e48d1e7b26c0e6c786880dff3ba14678e585b6e580692a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: google_alerts-0.1.9-py3.6.egg
  • Upload date:
  • Size: 28.3 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.20.1 setuptools/39.1.0 requests-toolbelt/0.8.0 tqdm/4.23.1 CPython/3.6.5

File hashes

Hashes for google_alerts-0.1.9-py3.6.egg
Algorithm Hash digest
SHA256 16c7e10aa0e6a16da6a6d78192480733de496e36d32c56acfa326e5cfd502f70
MD5 fc82f3dda051f96b8bfd01958b397e96
BLAKE2b-256 6f6b0ecc435f5a0b28f957802c7041c347f5cadd4313fb7c289803177f826fe3

See more details on using hashes here.

File details

Details for the file google_alerts-0.1.9-py2.7.egg.

File metadata

  • Download URL: google_alerts-0.1.9-py2.7.egg
  • Upload date:
  • Size: 28.3 kB
  • Tags: Egg
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.20.1 setuptools/39.1.0 requests-toolbelt/0.8.0 tqdm/4.23.1 CPython/3.6.5

File hashes

Hashes for google_alerts-0.1.9-py2.7.egg
Algorithm Hash digest
SHA256 13b9cf5b9a928b3ab78e9d9b6fd3a0704aaa46d9a254158bfaea29a737806e24
MD5 5d18dd736cfdbcaea73aaece72ae798a
BLAKE2b-256 31203b7171823ced0d6802eb93b1d68509fd11d2aacdbcb26c1bb90b632392ca

See more details on using hashes here.

File details

Details for the file google_alerts-0.1.9-py2-none-any.whl.

File metadata

  • Download URL: google_alerts-0.1.9-py2-none-any.whl
  • Upload date:
  • Size: 12.8 kB
  • Tags: Python 2
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.23.0 CPython/2.7.10

File hashes

Hashes for google_alerts-0.1.9-py2-none-any.whl
Algorithm Hash digest
SHA256 d8c2831a1b01bb63d6949e9c794dc8bb954330d5f8806fa7ce022b9399ef3c51
MD5 85f3603824e7529c1ef50acf4f2396ca
BLAKE2b-256 4ddb169563afe2120c622ebc682893963995b14ee0eb005551a8fd4f5e8cbf76

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 Pingdom Monitoring Sentry Error logging StatusPage Status page