shanewan / googlesafebrowsing

Python client library for Google Safe Browsing API

gglsbl

Python client library for Google Safe Browsing Update API v4.

The code was developed according to official Developers Guide, however this is not a reference implementation.

Quick start

Get Google API key

Instructions to procure API key can be found here. Please note that v3/v4 key is different from v2.2 API. API v3 key may work with current API v4.

Install the library

    python setup.py install

To sync local hash prefix cache

    from gglsbl import SafeBrowsingList
    sbl = SafeBrowsingList('API KEY GOES HERE')
    sbl.update_hash_prefix_cache()

URL lookup

    from gglsbl import SafeBrowsingList
    sbl = SafeBrowsingList('API KEY GOES HERE')
    threat_list = sbl.lookup_url('http://github.com/')
    if threat_list == None:
      print("no threat')
    else: 
      print('threats: ' + str(threat_list))

CLI Tool

bin/gglsbl_client.py can be used for a quick check or as a code example.

To immediately sync local cache with Safe Browsing API.

    gglsbl_client.py --api-key 'API KEY GOES HERE' --onetime

Please mind Request Frequency policy if you are going to use this command for more than a one-time test.

To look up URL

    gglsbl_client.py --api-key 'API KEY GOES HERE' --check-url http://github.com/

Fore more options please see

    gglsbl_client.py --help

Running in Distributed Environment

For cases when multiple apps and/or servers would benifit from sharing same GSB cache please see gglsbl-rest project maintained by Alexandre Sieira.

Running on Python3

Current version of library is fully compatible with both python2.7 and python3.

If you prefer to use older v3 version of Safe Browsing API there is a python3 port of the legacy version made by Stefan.