A JavaScript client for Google Safe Browsing API (https://developers.google.com/safe-browsing)
- Zero dependencies
- Built-in support for Edge runtime
- Typesafe with TypeScript
- Supports all Google Safe Browsing API v4 endpoints
- Fully documented
Finds the threat entries that match the Safe Browsing lists.
import { findThreadMatches } from '@hckhanh/google-safe-browsing'
const result = await findThreadMatches('apiKey', {
client: {
clientId: 'uniqueClientId',
clientVersion: '1.0.0',
},
threatInfo: {
threatTypes: ['MALWARE', 'SOCIAL_ENGINEERING'],
platformTypes: ['ALL_PLATFORMS'],
threatEntryTypes: ['URL'],
threatEntries: [
{ url: 'http://malware.testing.google.test/testing/malware/' },
],
},
})
const hasRisk = result.matches !== undefined && result.matches.length > 0
You can go to Releases page to see the release notes.
Note
The Safe Browsing API is 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.