# Safe Browsing API API

> Safe Browsing API API on Apizie: 5 endpoints (Gets the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such…, Gets multiple hash lists at once. It is very common for a client to need to get multiple hash lists. Using…, Lists hash lists. In the V5 API, Google will never remove a hash list that has ever been returned by this…, Searches for full hashes matching the specified prefixes. This is a custom method as defined by…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `analytics:googleapis-safebrowsing`
- Category: Analytics
- Status: byok
- Source: https://developers.google.com/safe-browsing/
- Page: https://www.apizie.tech/api/analytics/googleapis-safebrowsing
- OpenAPI: https://www.apizie.tech/api/analytics/googleapis-safebrowsing/openapi.json

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…

## Endpoints

### Gets the latest contents of a hash list. A hash list may either by a threat list or a non-threat list such…
`GET https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/safebrowsing-hash-list-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Required. The name of this particular hash list. It may be a threat list, or it may be the Global Cache. |
| sizeConstraints.maxDatabaseEntries | integer | no | Sets the maximum number of entries that the client is willing to have in the local database for the list. (The server MAY cause the client… |
| sizeConstraints.maxUpdateEntries | integer | no | The maximum size in number of entries. The update will not contain more entries than this value, but it is possible that the update will… |
| version | string | no | The version of the hash list that the client already has. If this is the first time the client is fetching the hash list, this field MUST… |

### Gets multiple hash lists at once. It is very common for a client to need to get multiple hash lists. Using…
`GET https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/safebrowsing-hash-lists-batch-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| names | string | no | Required. The names of the particular hash lists. The list MAY be a threat list, or it may be the Global Cache. The names MUST NOT contain… |
| sizeConstraints.maxDatabaseEntries | integer | no | Sets the maximum number of entries that the client is willing to have in the local database for the list. (The server MAY cause the client… |
| sizeConstraints.maxUpdateEntries | integer | no | The maximum size in number of entries. The update will not contain more entries than this value, but it is possible that the update will… |
| version | string | no | The versions of the hash list that the client already has. If this is the first time the client is fetching the hash lists, the field… |

### Lists hash lists. In the V5 API, Google will never remove a hash list that has ever been returned by this…
`GET https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/safebrowsing-hash-lists-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pageSize | integer | no | The maximum number of hash lists to return. The service may return fewer than this value. If unspecified, the server will choose a page… |
| pageToken | string | no | A page token, received from a previous `ListHashLists` call. Provide this to retrieve the subsequent page. |

### Searches for full hashes matching the specified prefixes. This is a custom method as defined by…
`GET https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/safebrowsing-hashes-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| hashPrefixes | string | no | Required. The hash prefixes to be looked up. Clients MUST NOT send more than 1000 hash prefixes. However, following the URL processing… |

### Searches for URLs matching known threats. Each URL and it's host-suffix and path-prefix expressions (up to a…
`GET https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/safebrowsing-urls-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| urls | string | no | Required. The URLs to be looked up. Clients MUST NOT send more than 50 URLs. |

## Example
```
curl "https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/safebrowsing-hash-list-get" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Safe Browsing API API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/analytics:googleapis-safebrowsing/safebrowsing-hash-list-get with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Safe Browsing API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Safe Browsing API itself also needs your own key from googleapis.com.

### Can AI agents use the Safe Browsing API API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key analytics:googleapis-safebrowsing.

### What is the status of the Safe Browsing API API?
Needs your own provider key (bring your own key)