---
id: google-cloud-webrisk
version: "1.22.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# google-cloud-webrisk — Google Cloud Webrisk API client library

License: permissive · Maintenance: active · Downloads: 76.2K/mo

## What it is and what it does

google-cloud-webrisk is the official Python client for Google Cloud's Web Risk API, a security service that maintains constantly updated lists of unsafe URLs. It wraps the underlying gRPC and REST interfaces to provide a Pythonic way to query whether a given URL is known to be malicious, phishing, or otherwise unsafe.

The library depends on google-api-core, google-auth, grpcio, proto-plus, and protobuf to handle authentication, transport, and protocol buffer serialization. It is designed for production use (Development Status 5) and actively maintained by Google. Setup requires a Google Cloud project with billing enabled and the Web Risk API activated; once configured, the client handles authentication and communicates with Google's service to evaluate URLs in real time.

Use it for:

- Check user-submitted URLs before allowing them in your application or redirecting to them.
- Scan links in user-generated content (comments, posts, messages) for malware or phishing threats.
- Build security dashboards that report on URL safety across your organization's web traffic.
- Integrate URL validation into email or messaging systems to warn users about unsafe links.
- Audit historical URL logs to identify which links were flagged as unsafe after the fact.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for Google Cloud Web Risk, enabling applications to check URLs against Google's lists of unsafe web resources.

Yes. The library is production-stable, actively maintained, has no known vulnerabilities, and low install friction. Install it if you need to validate URLs against Google's threat lists in a Python application and have access to a Google Cloud project with Web Risk enabled.

## Install

pip install google-cloud-webrisk
uv add google-cloud-webrisk
poetry add google-cloud-webrisk

## Installing google-cloud-webrisk

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with recent releases (53 days since last update). Supports current Python versions (3.10 through 3.14).

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install google-cloud-webrisk

from google.cloud import webrisk_v1

client = webrisk_v1.WebRiskServiceClient()
# Check URL against Google's Web Risk lists

Requires Google Cloud project setup, billing enabled, Web Risk API enabled, and authentication credentials configured.

Verify before relying:

- Specific latency or throughput characteristics for URL checking operations.
- Rate limiting or quota details for the Web Risk API calls.
- Whether the library caches results or always queries the service.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

url safety checking, web risk api client, malware detection, phishing url detection, google cloud security, unsafe url detection, web threat detection, security, google-cloud, url-validation

[View on SkillFed](https://skillfed.io/packages/google-cloud-webrisk) · [View on PyPI](https://pypi.org/project/google-cloud-webrisk/)