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.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

google-alerts-0.1.3.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.3-py3.6.egg (22.2 kB view details)

Uploaded Egg

google_alerts-0.1.3-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

google_alerts-0.1.3-py2.7.egg (22.8 kB view details)

Uploaded Egg

File details

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

File metadata

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

File hashes

Hashes for google-alerts-0.1.3.tar.gz
Algorithm Hash digest
SHA256 923fa23bc69a476581d60857d1bc98082a283dab5103576f2299ba9e3ffe8667
MD5 1143ef65a639ddde9f3bd0e450b50da3
BLAKE2b-256 8e4bbd2e1fee931b5b6b8c984cebb755616b775bb154f88af8e66b97be2be426

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for google_alerts-0.1.3-py3.6.egg
Algorithm Hash digest
SHA256 d70ae5f69dfbfd95266861d8a98cb6cb28b41344f84fbdc7fb3d18c923003fa4
MD5 2a72068120721bdb287e147ecc162537
BLAKE2b-256 34c8559722fbfb21d3f50f596700e379595a48291d2489035cef53ad7a722ebc

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for google_alerts-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 684526d50242f449b10eb4d5c8a23244b66ec30afdc554228d6b91c06084c758
MD5 c986e1652383f8e6a84be4bd42509e7a
BLAKE2b-256 f2de0a07ccd3c82a18998763419083b3cef003ad3261dea543768c4030c9da99

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for google_alerts-0.1.3-py2.7.egg
Algorithm Hash digest
SHA256 e43ae2fbdd0a8dbde20bcede2b2fa63a8293ae2cfaa04d32aabbfd73fd7ab177
MD5 8e3a569d666640dc92b1965928e128d7
BLAKE2b-256 90cdc2c1819d743845e336f21ed730dc5fc367b38047e3bdc782315c23c5266c

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