Safe Browsing API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
클라이언트 애플리케이션이 웹 리소스 (가장 일반적으로는 URL)를 Google에서 생성한 안전하지 않은 웹 리소스 목록과 비교하여 확인할 수 있도록 지원합니다. Safe Browsing API는 비상업용으로만 사용할 수 있습니다. '판매 또는 수익 창출 목적'을 위한 상업적 목적으로 API를 사용하여 악성 URL을 감지해야 하는 경우 Web Risk API를 참고하세요.
서비스: safebrowsing.googleapis.com
서비스 엔드포인트
서비스 엔드포인트는 API 서비스의 네트워크 주소를 지정하는 기준 URL입니다. 하나의 서비스는 여러 서비스 엔드포인트를 포함할 수 있습니다. 이 서비스에는 다음 서비스 엔드포인트가 포함되고, 그 아래의 모든 URI가 이 서비스 엔드포인트와 관련됩니다.
https://safebrowsing.googleapis.com
| 메서드 |
get |
GET /v5alpha1/hashList/{name}
해시 목록의 최신 콘텐츠를 가져옵니다. |
| 메서드 |
batchGet |
GET /v5alpha1/hashLists:batchGet
한 번에 여러 해시 목록을 가져옵니다. |
list |
GET /v5alpha1/hashLists
해시 목록을 나열합니다. |
| 메서드 |
search |
GET /v5alpha1/hashes:search
지정된 접두사와 일치하는 전체 해시를 검색합니다. |
| 메서드 |
get |
GET /v5/hashList/{name}
해시 목록의 최신 콘텐츠를 가져옵니다. |
| 메서드 |
batchGet |
GET /v5/hashLists:batchGet
한 번에 여러 해시 목록을 가져옵니다. |
list |
GET /v5/hashLists
해시 목록을 나열합니다. |
| 메서드 |
search |
GET /v5/hashes:search
지정된 접두사와 일치하는 전체 해시를 검색합니다. |
| 메서드 |
find |
POST /v4/fullHashes:find
요청된 해시 접두사와 일치하는 전체 해시를 찾습니다. |
| 메서드 |
fetch |
POST /v4/threatListUpdates:fetch
최신 위협 목록 업데이트를 가져옵니다. |
| 메서드 |
list |
GET /v4/threatLists
다운로드할 수 있는 세이프 브라우징 위협 목록을 나열합니다. |
| 메서드 |
find |
POST /v4/threatMatches:find
세이프 브라우징 목록과 일치하는 위협 항목을 찾습니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThe Safe Browsing APIs enable client applications to cross-reference web resources, primarily URLs, with Google's lists of unsafe web resources for non-commercial use only.\u003c/p\u003e\n"],["\u003cp\u003eCommercial users seeking malicious URL detection should utilize the Web Risk API instead of the Safe Browsing APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe APIs offer various functionalities, including retrieving hash lists, searching for full hashes based on prefixes, and fetching recent threat list updates.\u003c/p\u003e\n"],["\u003cp\u003eThe service endpoint for accessing these APIs is \u003ccode\u003ehttps://safebrowsing.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eMultiple REST resources, such as \u003ccode\u003ev5alpha1.hashList\u003c/code\u003e, \u003ccode\u003ev5alpha1.hashLists\u003c/code\u003e, and \u003ccode\u003ev5alpha1.hashes\u003c/code\u003e, are available for interacting with the service.\u003c/p\u003e\n"]]],["The Safe Browsing APIs enable non-commercial client applications to verify web resources against Google's unsafe web resource lists; commercial use requires the Web Risk API. Key actions include: fetching threat list updates, searching for matching hash prefixes, retrieving full hashes, and listing available threat lists. Using the REST resource you can get individual hash lists, or get them in batches. The service endpoint is `https://safebrowsing.googleapis.com`.\n"],null,["# Safe Browsing API\n\nEnables 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.\n\n- [REST Resource: v5alpha1.hashList](#v5alpha1.hashList)\n- [REST Resource: v5alpha1.hashLists](#v5alpha1.hashLists)\n- [REST Resource: v5alpha1.hashes](#v5alpha1.hashes)\n- [REST Resource: v5.hashList](#v5.hashList)\n- [REST Resource: v5.hashLists](#v5.hashLists)\n- [REST Resource: v5.hashes](#v5.hashes)\n- [REST Resource: v4.fullHashes](#v4.fullHashes)\n- [REST Resource: v4.threatListUpdates](#v4.threatListUpdates)\n- [REST Resource: v4.threatLists](#v4.threatLists)\n- [REST Resource: v4.threatMatches](#v4.threatMatches)\n\nService: safebrowsing.googleapis.com\n------------------------------------\n\n### Service endpoint\n\nA [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:\n\n- `https://safebrowsing.googleapis.com`\n\nREST Resource: [v5alpha1.hashList](/safe-browsing/reference/rest/v5alpha1/hashList)\n-----------------------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------------|-------------------------------------------------------------------------|\n| [get](/safe-browsing/reference/rest/v5alpha1/hashList/get) | `GET /v5alpha1/hashList/{name}` Get the latest contents of a hash list. |\n\nREST Resource: [v5alpha1.hashLists](/safe-browsing/reference/rest/v5alpha1/hashLists)\n-------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------|---------------------------------------------------------------------|\n| [batchGet](/safe-browsing/reference/rest/v5alpha1/hashLists/batchGet) | `GET /v5alpha1/hashLists:batchGet` Get multiple hash lists at once. |\n| [list](/safe-browsing/reference/rest/v5alpha1/hashLists/list) | `GET /v5alpha1/hashLists` List hash lists. |\n\nREST Resource: [v5alpha1.hashes](/safe-browsing/reference/rest/v5alpha1/hashes)\n-------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------|---------------------------------------------------------------------------------------|\n| [search](/safe-browsing/reference/rest/v5alpha1/hashes/search) | `GET /v5alpha1/hashes:search` Search for full hashes matching the specified prefixes. |\n\nREST Resource: [v5.hashList](/safe-browsing/reference/rest/v5/hashList)\n-----------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------|-------------------------------------------------------------------|\n| [get](/safe-browsing/reference/rest/v5/hashList/get) | `GET /v5/hashList/{name}` Get the latest contents of a hash list. |\n\nREST Resource: [v5.hashLists](/safe-browsing/reference/rest/v5/hashLists)\n-------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------|---------------------------------------------------------------|\n| [batchGet](/safe-browsing/reference/rest/v5/hashLists/batchGet) | `GET /v5/hashLists:batchGet` Get multiple hash lists at once. |\n| [list](/safe-browsing/reference/rest/v5/hashLists/list) | `GET /v5/hashLists` List hash lists. |\n\nREST Resource: [v5.hashes](/safe-browsing/reference/rest/v5/hashes)\n-------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------|---------------------------------------------------------------------------------|\n| [search](/safe-browsing/reference/rest/v5/hashes/search) | `GET /v5/hashes:search` Search for full hashes matching the specified prefixes. |\n\nREST Resource: [v4.fullHashes](/safe-browsing/reference/rest/v4/fullHashes)\n---------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------|------------------------------------------------------------------------------------------|\n| [find](/safe-browsing/reference/rest/v4/fullHashes/find) | `POST /v4/fullHashes:find` Finds the full hashes that match the requested hash prefixes. |\n\nREST Resource: [v4.threatListUpdates](/safe-browsing/reference/rest/v4/threatListUpdates)\n-----------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------|---------------------------------------------------------------------------------|\n| [fetch](/safe-browsing/reference/rest/v4/threatListUpdates/fetch) | `POST /v4/threatListUpdates:fetch` Fetches the most recent threat list updates. |\n\nREST Resource: [v4.threatLists](/safe-browsing/reference/rest/v4/threatLists)\n-----------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------|------------------------------------------------------------------------------------|\n| [list](/safe-browsing/reference/rest/v4/threatLists/list) | `GET /v4/threatLists` Lists the Safe Browsing threat lists available for download. |\n\nREST Resource: [v4.threatMatches](/safe-browsing/reference/rest/v4/threatMatches)\n---------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| [find](/safe-browsing/reference/rest/v4/threatMatches/find) | `POST /v4/threatMatches:find` Finds the threat entries that match the Safe Browsing lists. |"]]
