수행된 검색에 대한 메타데이터, 검색에 사용된 엔진에 대한 메타데이터 및 검색결과를 반환합니다.
HTTP 요청
GET https://customsearch.googleapis.com/customsearch/v1
URL은 gRPC 트랜스코딩 구문을 사용합니다.
쿼리 매개변수
| 매개변수 | |
|---|---|
| c2coff | 
 중국어 간체 및 번체 검색을 사용 설정하거나 사용 중지합니다. 이 매개변수의 기본값은 0 (영)이며 기능이 사용 설정되었음을 의미합니다. 지원되는 값은 다음과 같습니다. 
 | 
| cr | 
 출처가 특정 국가인 문서로 검색결과를 제한합니다. cr 매개변수의 값에 부울 연산자를 사용할 수 있습니다. Google 검색은 다음을 분석하여 문서의 국가를 결정합니다. 
 이 매개변수에 유효한 값 목록을 보려면 국가 매개변수 값 페이지를 참조하세요. | 
| cx | 
 이 요청에 사용할 프로그래밍 검색 엔진 ID입니다. | 
| dateRestrict | 
 날짜를 기준으로 한 URL로 검색결과를 제한합니다. 지원되는 값은 다음과 같습니다. 
 | 
| exactTerms | 
 검색 결과의 모든 문서에 포함해야 하는 구문을 식별합니다. | 
| excludeTerms | 
 검색결과의 어떤 문서에도 표시되어서는 안 되는 단어 또는 구문을 식별합니다. | 
| fileType | 
 지정된 확장자의 파일로 결과를 제한합니다. Google에서 색인을 생성할 수 있는 파일 형식 목록은 Search Console 고객센터에서 확인할 수 있습니다. | 
| filter | 
 중복 콘텐츠 필터를 사용 설정 또는 사용 중지할 수 있습니다. 
 사용 가능한 값: 
 | 
| gl | 
 최종 사용자의 위치정보입니다. 
 | 
| googlehost | 
 지원 중단됨.  검색을 수행하는 데 사용할 로컬 Google 도메인 (예: google.com, google.de 또는 google.fr). | 
| highRange | 
 검색 범위의 끝 값을 지정합니다. 
 | 
| hl | 
 사용자 인터페이스 언어를 설정합니다. 
 | 
| hq | 
 지정된 검색어를 논리 AND 연산자와 함께 사용한 것처럼 쿼리에 추가합니다. | 
| imgColorType | 
 흑백, 회색조, 투명 또는 컬러 이미지를 반환합니다. 사용 가능한 값: 
 | 
| imgDominantColor | 
 특정 주요 색상의 이미지를 반환합니다. 사용 가능한 값: 
 | 
| imgSize | 
 지정된 크기의 이미지를 반환합니다. 사용 가능한 값: 
 | 
| imgType | 
 유형의 이미지를 반환합니다. 사용 가능한 값: 
 | 
| linkSite | 
 모든 검색결과에 특정 URL로 연결되는 링크가 포함되도록 지정합니다. | 
| lowRange | 
 검색 범위의 시작 값을 지정합니다.  | 
| lr | 
 특정 언어 (예:  사용 가능한 값: 
 | 
| num | 
 반환할 검색결과 수입니다. 
 | 
| orTerms | 
 문서에서 확인할 추가 검색어를 제공합니다. 검색 결과의 각 문서에는 하나 이상의 추가 검색어가 포함되어야 합니다. | 
| q | 
 쿼리 | 
| relatedSite | 
 지원이 중단되었습니다. | 
| rights | 
 라이선스를 기반으로 한 필터입니다. 지원되는 값:  | 
| safe | 
 검색 안전 수준 사용 가능한 값: 
 | 
| searchType | 
 검색 유형( 사용 가능한 값: 
 | 
| siteSearch | 
 결과에 항상 포함되거나 제외되어야 하는 사이트를 지정합니다 (아래의  | 
| siteSearchFilter | 
 
 사용 가능한 값: 
 | 
| sort | 
 결과에 적용할 정렬 표현식입니다. 정렬 매개변수는 지정된 표현식(예: 날짜순 정렬)에 따라 결과가 정렬되도록 지정합니다. 예: sort=date. | 
| start | 
 반환할 첫 번째 결과의 색인입니다. 페이지당 기본 결과 수는 10개이므로  | 
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공한 경우 응답 본문에 Search의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위가 필요합니다.
- https://www.googleapis.com/auth/cse
자세한 내용은 OAuth 2.0 개요를 참고하세요.