Custom Search JSON API
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Custom Search JSON API를 사용하면 프로그래밍 검색 엔진의 검색결과를 프로그래매틱 방식으로 검색하여 표시하는 웹사이트와 애플리케이션을 개발할 수 있습니다.
이 API를 사용하면 RESTful 요청을 사용하여 웹 검색 또는 이미지 검색 결과를 JSON 형식으로 얻을 수 있습니다.
Custom Search JSON API는 JSON 데이터 형식으로 결과를 반환할 수 있습니다.
Custom Search JSON API는 OpenSearch 1.1 사양을 사용합니다.
기본 요건
검색엔진 ID
Custom Search JSON API를 사용하기 전에 먼저 프로그래밍 검색 엔진을 만들고 구성해야 합니다. 아직 프로그래밍 검색 엔진을 만들지 않았다면 프로그래밍 검색 엔진 제어판을 방문하여 시작할 수 있습니다.
다양한 구성 옵션에 대한 자세한 내용은 튜토리얼을 참조하세요.
프로그래밍 검색 엔진을 만든 후 고객센터를 방문하여 검색엔진 ID를 찾는 방법을 알아보세요.
API 키
Custom Search JSON API를 사용하려면 API 키를 사용해야 합니다.
키 가져오기
가격 책정
Custom Search JSON API는 하루에 100개의 검색어를 무료로 제공합니다.
더 필요한 경우 API 콘솔에서 billing에
가입할 수 있습니다. 추가 요청 비용은 쿼리 1,000개당 $5이며 하루에 최대 쿼리 10,000개까지 가능합니다.
모니터링
Custom Search JSON API의 기본 모니터링은 Cloud Platform 콘솔의 API 대시보드를 통해 사용할 수 있습니다. 고급 모니터링 기능을 사용하려면 Google Cloud 운영 제품군 (이전 명칭: Stackdriver)을 사용하세요.
Google Cloud 운영을 사용하면 커스텀 대시보드를 만들고, 알림을 설정하고, 프로그래매틱 방식으로 측정항목 데이터에 액세스할 수 있습니다. Google Cloud 운영에서 Custom Search JSON API 사용 데이터에 액세스하려면 '리소스 유형: 사용된 API'를 선택하고 쿼리 빌더에서 'service = 'customsearch.googleapis.com'으로 필터링하세요.
API 대시보드 및 Google Cloud 운영 제품군에서 제공하는 다양한 모니터링 및 알림 기능에 대한 설명은 API 사용량 모니터링을 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThe Custom Search JSON API allows you to programmatically retrieve and display web and image search results from your Programmable Search Engine using RESTful requests.\u003c/p\u003e\n"],["\u003cp\u003eResults are delivered in JSON format and the API adheres to the OpenSearch 1.1 Specification.\u003c/p\u003e\n"],["\u003cp\u003eTo use the API, you need a Search engine ID (obtained by creating a Programmable Search Engine) and an API key.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers 100 free daily search queries, with additional usage billed at $5 per 1000 queries (up to 10,000 per day).\u003c/p\u003e\n"],["\u003cp\u003eMonitor API usage and performance through the Cloud Platform Console's API Dashboard or Google Cloud's Operations suite for more advanced insights.\u003c/p\u003e\n"]]],[],null,["# Custom Search JSON API\n\nThe Custom Search JSON API lets you develop websites and applications to retrieve\nand display search results from Programmable Search Engine programmatically.\nWith this API, you can use RESTful requests to get either **web search** or\n**image search** results in JSON format.\n\nData format\n-----------\n\nCustom Search JSON API can return results in [JSON](/custom-search/docs/glossary#json) data format.\n\nRelated documents\n-----------------\n\nThe Custom Search JSON API uses the [OpenSearch 1.1 Specification](https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md).\n\nPrerequisites\n-------------\n\n### Search engine ID\n\nBefore using the Custom Search JSON API you will first need to create and configure your Programmable Search Engine. If you have not already created a Programmable Search Engine, you can start by visiting the [Programmable Search Engine control panel](https://programmablesearchengine.google.com/controlpanel/all).\n\nFollow the [tutorial](/custom-search/docs/tutorial/creatingcse) to learn more about different configuration options.\n\nAfter you have created a Programmable Search Engine, visit the [help center](https://support.google.com/programmable-search/answer/2649143) to learn how to locate your Search engine ID.\n\n### API key\n\nCustom Search JSON API requires the use of an API key.\nGet a Key\n\nPricing\n-------\n\nCustom Search JSON API provides 100 search queries per day for free.\nIf you need more, you may sign up for [billing](https://cloud.google.com/billing/docs/how-to/manage-billing-account)\nin the API Console. Additional requests cost $5 per 1000\nqueries, up to 10k queries per day.\n\nMonitoring\n----------\n\nBasic monitoring for the Custom Search JSON API is available through [Cloud Platform Console's API Dashboard](https://console.cloud.google.com/apis/dashboard). For more advanced monitoring [Google Cloud's Operations suite](https://cloud.google.com/products/operations) (formerly Stackdriver) is available.\n\nWith Google Cloud Operations you can create [custom dashboards](https://cloud.google.com/monitoring/charts), [set up\nalerts](https://cloud.google.com/monitoring/alerts), and\n[access metrics data programmatically](https://cloud.google.com/monitoring/api/v3). To access Custom Search JSON API usage data in Google Cloud Operations, select \"Resource type: Consumed API\" and filter on \"service = 'customsearch.googleapis.com'\" in the Query Builder.\n\nSee [Monitoring Your API Usage](https://cloud.google.com/apis/docs/monitoring) for a discussion of the different monitoring and alerting capabilities provided by the API Dashboard and the Google Cloud Operations suite."]]
