---
title: Google Safe Browsing
slug: connectors/google-safe-browsing
docTags: 
createdAt: 2026-06-09T16:30:27.088Z
---

The Google Safe Browsing connector finds threat entries that match the Safe Browsing lists.

## Prerequisites

This connector requires that you have an API key to [https://safebrowsing.googleapis.com](https://safebrowsing.googleapis.com). Activate the key on the Google API page.

## Capabilities

Use the Google Safe Browsing connector to retrieve a URL from the Google Safe Browsing lists.

## Additional Documentation

- [Google Safe Browsing Connector Documentation](https://docs.swimlane.com/connectors/google-safe-browsing)
- [Google Safe Browsing API Documentation](https://developers.google.com/safe-browsing/v4/reference/rest)

# Configurations

## API Key Authentication

Authenticates using an API Key

### Configuration Parameters

| **Parameter** | **Description**                    | **Type** | **Required** |
| ------------- | ---------------------------------- | -------- | ------------ |
| url           | A URL to the target host.          | string   | Required     |
| key           | API key                            | string   | Required     |
| verify\_ssl   | Verify SSL certificate             | boolean  | Optional     |
| http\_proxy   | A proxy to route requests through. | string   | Optional     |

# Actions

## Get URL Threat Match

Check a URL against the Google Safe Browsing API for any threat entries that match the Safe Browsing lists

### Endpoint

- **URL:** `/v4/threatMatches:find`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                                                                                                                                       |
| --------------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client`                          | object   | Optional     | Client Information                                                                                                                                                                    |
| `client.clientId`                 | string   | Optional     | A client ID that (hopefully) uniquely identifies the client implementation of the Safe Browsing API.                                                                                  |
| `client.clientVersion`            | string   | Optional     | The version of the client implementation.                                                                                                                                             |
| `threatInfo`                      | object   | Optional     | Threat Information                                                                                                                                                                    |
| `threatInfo.threatTypes`          | array    | Optional     | The threat types to be checked.                                                                                                                                                       |
| `threatInfo.platformTypes`        | array    | Optional     | The platform types to be checked.                                                                                                                                                     |
| `threatInfo.threatEntryTypes`     | array    | Optional     | The entry types to be checked.                                                                                                                                                        |
| `threatInfo.threatEntries`        | array    | Required     | The threat entries to be checked.                                                                                                                                                     |
| `threatInfo.threatEntries.hash`   | string   | Optional     | A hash prefix, consisting of the most significant 4-32 bytes of a SHA256 hash. This field is in binary format. For JSON requests, hashes are base64-encoded. A base64-encoded string. |
| `threatInfo.threatEntries.url`    | string   | Optional     | A URL.                                                                                                                                                                                |
| `threatInfo.threatEntries.digest` | string   | Optional     | The digest of an executable in SHA256 format. The API supports both binary and hex digests. For JSON requests, digests are base64-encoded. A base64-encoded string.                   |

### Input Example

`{"client":{"clientId":"mycompany","clientVersion":"0.1"},"threatInfo":{"threatTypes":["string"],"platformTypes":["string"],"threatEntryTypes":["string"],"threatEntries":[{"hash":"string","url":"https://example.com/api/resource","digest":"string"}]}}`

### Output

| **Parameter** | **Type** | **Description**      |
| ------------- | -------- | -------------------- |
| `threat_type` | string   | Type of the resource |

### Output Example

`{"threat_type":"string"}`

# Response Headers

| **Header**   | **Description**                                       | **Example**                   |
| ------------ | ----------------------------------------------------- | ----------------------------- |
| Content-Type | The media type of the resource                        | application/json              |
| Date         | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |