⚠️ Not yet functional, given that there seems to be no support for JSON output yet.

Python client library for Google Safe Browsing Update API v5.

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

Instructions to procure API key can be found here.

    python setup.py install

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

from gglsbl5 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))

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

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

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

gglsbl5_client.py --help

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

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.