# Safe Browsing API

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes -- meaning "for sale or revenue-generating purposes" -- please refer to the Web Risk API.

- [REST Resource: v5alpha1.hashList](https://developers.google.com/safe-browsing/reference/rest#v5alpha1.hashList)
- [REST Resource: v5alpha1.hashLists](https://developers.google.com/safe-browsing/reference/rest#v5alpha1.hashLists)
- [REST Resource: v5alpha1.hashes](https://developers.google.com/safe-browsing/reference/rest#v5alpha1.hashes)
- [REST Resource: v5alpha1.urls](https://developers.google.com/safe-browsing/reference/rest#v5alpha1.urls)
- [REST Resource: v5.hashList](https://developers.google.com/safe-browsing/reference/rest#v5.hashList)
- [REST Resource: v5.hashLists](https://developers.google.com/safe-browsing/reference/rest#v5.hashLists)
- [REST Resource: v5.hashes](https://developers.google.com/safe-browsing/reference/rest#v5.hashes)
- [REST Resource: v5.urls](https://developers.google.com/safe-browsing/reference/rest#v5.urls)
- [REST Resource: v4.fullHashes](https://developers.google.com/safe-browsing/reference/rest#v4.fullHashes)
- [REST Resource: v4.threatListUpdates](https://developers.google.com/safe-browsing/reference/rest#v4.threatListUpdates)
- [REST Resource: v4.threatLists](https://developers.google.com/safe-browsing/reference/rest#v4.threatLists)
- [REST Resource: v4.threatMatches](https://developers.google.com/safe-browsing/reference/rest#v4.threatMatches)

## Service: safebrowsing.googleapis.com

### Service endpoint

A [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

- `https://safebrowsing.googleapis.com`

## REST Resource: [v5alpha1.hashList](https://developers.google.com/safe-browsing/reference/rest/v5alpha1/hashList)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5alpha1/hashList/get` | `GET /v5alpha1/hashList/{name}` Gets the latest contents of a hash list. |

## REST Resource: [v5alpha1.hashLists](https://developers.google.com/safe-browsing/reference/rest/v5alpha1/hashLists)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5alpha1/hashLists/batchGet` | `GET /v5alpha1/hashLists:batchGet` Gets multiple hash lists at once. |
| `https://developers.google.com/safe-browsing/reference/rest/v5alpha1/hashLists/list` | `GET /v5alpha1/hashLists` Lists hash lists. |

## REST Resource: [v5alpha1.hashes](https://developers.google.com/safe-browsing/reference/rest/v5alpha1/hashes)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5alpha1/hashes/search` | `GET /v5alpha1/hashes:search` Searches for full hashes matching the specified prefixes. |

## REST Resource: [v5alpha1.urls](https://developers.google.com/safe-browsing/reference/rest/v5alpha1/urls)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5alpha1/urls/search` | `GET /v5alpha1/urls:search` Searches for URLs matching known threats. |

## REST Resource: [v5.hashList](https://developers.google.com/safe-browsing/reference/rest/v5/hashList)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5/hashList/get` | `GET /v5/hashList/{name}` Gets the latest contents of a hash list. |

## REST Resource: [v5.hashLists](https://developers.google.com/safe-browsing/reference/rest/v5/hashLists)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5/hashLists/batchGet` | `GET /v5/hashLists:batchGet` Gets multiple hash lists at once. |
| `https://developers.google.com/safe-browsing/reference/rest/v5/hashLists/list` | `GET /v5/hashLists` Lists hash lists. |

## REST Resource: [v5.hashes](https://developers.google.com/safe-browsing/reference/rest/v5/hashes)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5/hashes/search` | `GET /v5/hashes:search` Searches for full hashes matching the specified prefixes. |

## REST Resource: [v5.urls](https://developers.google.com/safe-browsing/reference/rest/v5/urls)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v5/urls/search` | `GET /v5/urls:search` Searches for URLs matching known threats. |

## REST Resource: [v4.fullHashes](https://developers.google.com/safe-browsing/reference/rest/v4/fullHashes)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v4/fullHashes/find` | `POST /v4/fullHashes:find` Finds the full hashes that match the requested hash prefixes. |

## REST Resource: [v4.threatListUpdates](https://developers.google.com/safe-browsing/reference/rest/v4/threatListUpdates)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v4/threatListUpdates/fetch` | `POST /v4/threatListUpdates:fetch` Fetches the most recent threat list updates. |

## REST Resource: [v4.threatLists](https://developers.google.com/safe-browsing/reference/rest/v4/threatLists)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v4/threatLists/list` | `GET /v4/threatLists` Lists the Safe Browsing threat lists available for download. |

## REST Resource: [v4.threatMatches](https://developers.google.com/safe-browsing/reference/rest/v4/threatMatches)

| Methods ||
|---|---|
| `https://developers.google.com/safe-browsing/reference/rest/v4/threatMatches/find` | `POST /v4/threatMatches:find` Finds the threat entries that match the Safe Browsing lists. |