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

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.4.tar.gz (6.9 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.4-py3.6.egg (22.3 kB view details)

Uploaded Egg

google_alerts-0.1.4-py2.7.egg (26.0 kB view details)

Uploaded Egg

google_alerts-0.1.4-py2-none-any.whl (10.6 kB view details)

Uploaded Python 2

File details

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

File metadata

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

File hashes

Hashes for google-alerts-0.1.4.tar.gz
Algorithm Hash digest
SHA256 11afb96238b5e7de70bb484e3c75212a8b03bf40168f209e26a5fa5673f6724f
MD5 0cfff3235aa76eafe69db8ace9c13c20
BLAKE2b-256 a9431af1b97473944c2166795de8bc9ac3445aa8ae4c5d2fbcccd281ee276782

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for google_alerts-0.1.4-py3.6.egg
Algorithm Hash digest
SHA256 7a5a905e0e95933bccaa94147c580f36a49338da20465015303c485a916c562a
MD5 91048a745146a6635699f36f031d872a
BLAKE2b-256 a6d11b34f1339316f6a6e956ca55b839a80a8fb735516185d537c147c4aa0491

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for google_alerts-0.1.4-py2.7.egg
Algorithm Hash digest
SHA256 e9ea59aa9157035a7c13125adb0fb64041784191c88a95218f92810b91f4e13a
MD5 b4de094d8349a253ffea1d5cbccc1c6c
BLAKE2b-256 b88d54ff70cdd7e44ca41242b58b143d150319ea20a382b76ac6be86521239b7

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for google_alerts-0.1.4-py2-none-any.whl
Algorithm Hash digest
SHA256 519e6178e0fdbc51c4115e9dbcd9197e1f3301ff9e16c09e23b0148f60896270
MD5 8d908cab2058bc5ccde51fae0bd76014
BLAKE2b-256 8912fb3ef50feedc6665c4effb8b43bd1ed8858be93cec433cfc10d9ff117b5a

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