XML API 참조

이 페이지에서는 Google 사이트 검색 고객에게만 제공되는 Custom Search JSON API의 XML 버전을 참조합니다.

1. 개요
2. 프로그래밍 검색 엔진 요청 형식
   1. 요청 개요
   2. 검색어
   3. 요청 매개변수
      1. 샘플 웹 검색어
      2. WebSearch 쿼리 매개변수 정의
      3. 고급검색
      4. 고급 검색 쿼리 매개변수
      5. 특별 질문 용어
      6. 샘플 이미지 쿼리
      7. 이미지 검색 쿼리 매개변수
      8. 요청 한도
   4. 질문 및 결과 표시의 다국어화
      1. 문자 인코딩
      2. 인터페이스 언어
      3. 중국어 간체 및 번체 검색
   5. 결과 필터링하기
      1. 검색 결과 자동 필터링
      2. 언어 및 국가 필터링
      3. 세이프서치로 성인용 콘텐츠 필터링하기
3. XML 결과
   1. Google XML 결과 DTD
   2. XML 응답 정보
   3. 일반, 이미지, 고급 검색어의 XML 결과
      1. 일반/고급 검색: 샘플 쿼리 및 XML 결과
      2. 일반/고급 검색: XML 태그
      3. 이미지 검색 쿼리의 XML 결과
      4. 이미지 검색: 샘플 쿼리 및 XML 결과
      5. 이미지 검색: XML 태그

개요

Google 웹 검색 서비스를 사용하면 Google 사이트 검색 고객이 자체 웹사이트에 Google 검색 결과를 표시할 수 있습니다. WebSearch 서비스는 간단한 HTTP 기반 프로토콜을 사용하여 검색 결과를 제공합니다. 검색 관리자는 검색 결과를 요청하는 방식과 최종 사용자에게 결과를 표시하는 방식을 완전히 제어할 수 있습니다. 이 문서에서는 Google 검색 요청 및 결과 형식의 기술 세부정보를 설명합니다.

Google 웹 검색 결과를 가져오려면 애플리케이션에서 Google에 간단한 HTTP 요청을 보냅니다. 그러면 Google에서 검색 결과를 XML 형식으로 반환합니다. XML 형식의 결과를 사용하면 검색 결과가 표시되는 방식을 맞춤설정할 수 있습니다.

WebSearch 요청 형식

• 요청 개요
• 검색어
• 요청 매개변수
• 샘플 웹 검색어
• WebSearch 쿼리 매개변수 정의
• 샘플 이미지 쿼리
• 이미지 검색 쿼리 매개변수 정의
• 고급 검색
  
• 고급 검색 쿼리 매개변수
• 특별 질문 용어
• 요청 한도

요청 개요

Google 검색 요청은 표준 HTTP GET 명령입니다. 여기에는 쿼리와 관련된 매개변수 모음이 포함됩니다. 이러한 매개변수는 앰퍼샌드 (&) 문자로 구분된 name=value 쌍으로 요청 URL에 포함됩니다. 매개변수에는 검색어와 HTTP 요청을 수행하는 엔진을 식별하는 고유 엔진 ID (cx)와 같은 데이터가 포함됩니다. WebSearch 또는 Image Search 서비스는 HTTP 요청에 대한 응답으로 XML 결과를 반환합니다.

검색어

대부분의 검색 요청에는 하나 이상의 쿼리어가 포함됩니다. 검색 요청에서 쿼리 용어가 매개변수 값으로 표시됩니다.

검색어는 Google에서 반환하는 검색 결과를 필터링하고 정리하기 위해 여러 유형의 정보를 지정할 수 있습니다. 검색어는 다음을 지정할 수 있습니다.

• 포함하거나 제외할 단어 또는 구문
  • 검색어의 모든 단어 (기본값)
  • 검색어의 정확한 문구
  • 검색어의 단어나 구문
• 문서의 어느 부분에서 검색어를 찾아야 하는지 나타냅니다.
  • 문서 전체 (기본값)
  • 문서의 링크에만
• 문서 자체에 대한 제한사항
  • 특정 파일 형식(예: PDF 파일 또는 Word 문서)의 문서를 포함하거나 제외
• 검색을 실행하는 대신 지정된 URL에 관한 정보를 반환하는 특수 URL 쿼리
  • URL에 관한 일반 정보(예: Open Directory 카테고리, 스니펫, 언어)를 반환하는 쿼리
  • URL에 연결되는 웹페이지 집합을 반환하는 쿼리
  • 지정된 URL과 유사한 웹페이지 집합을 반환하는 쿼리

기본 검색

검색어 매개변수 값은 URL로 이스케이프되어야 합니다. 검색어의 공백 시퀀스는 더하기 기호 ('+')로 대체됩니다. 이에 대해서는 이 문서의 URL 이스케이핑 섹션에서 자세히 설명합니다.

검색어는 q 매개변수를 사용하여 WebSearch 서비스에 제출됩니다. 샘플 검색어는 다음과 같습니다.

q=horses+cows+pigs

기본적으로 Google WebSearch 서비스는 검색어의 모든 용어를 포함하는 문서만 반환합니다.

요청 매개변수

이 섹션에서는 검색 요청을 할 때 사용할 수 있는 매개변수를 나열합니다. 매개변수는 두 목록으로 나뉩니다. 첫 번째 목록에는 모든 검색 요청과 관련된 매개변수가 포함됩니다. 두 번째 목록에는 고급 검색 요청과 관련된 매개변수만 포함됩니다.

다음 세 가지 요청 매개변수가 필요합니다.

• client 매개변수를 google-csbe로 설정해야 합니다.
• output 매개변수는 반환된 XML 결과의 형식을 지정합니다. 결과는 Google의 DTD에 대한 참조와 함께 (xml) 또는 참조 없이 (xml_no_dtd) 반환될 수 있습니다. 이 값을 xml_no_dtd로 설정하는 것이 좋습니다. 참고: 이 매개변수를 지정하지 않으면 결과가 XML 대신 HTML로 반환됩니다.
  
• 엔진의 고유 ID를 나타내는 cx 매개변수입니다.
  

위에서 언급한 매개변수 외에 가장 흔히 사용되는 요청 매개변수는 다음과 같습니다.

• num: 요청된 검색 결과 수
• q: 검색어
• start: 결과의 시작 색인입니다.

샘플 웹 검색 쿼리

아래 예에서는 다양한 쿼리 매개변수가 사용되는 방식을 보여주기 위해 몇 가지 WebSearch HTTP 요청을 보여줍니다. 다양한 쿼리 매개변수의 정의는 이 문서의 WebSearch 쿼리 매개변수 정의 및 고급 검색 쿼리 매개변수 섹션에 제공됩니다.

이 요청은 'red sox'(q=red+sox)이라는 검색어에 대한 처음 10개의 결과(start=0&num=10)를 요청합니다. 또한 이 요청은 결과가 캐나다 웹사이트 (cr=countryCA)에서 제공되어야 하고 프랑스어 (lr=lang_fr)로 작성되어야 한다고 지정합니다. 마지막으로 이 요청은 client, output, cx 매개변수의 값을 지정합니다. 이 세 가지 매개변수는 모두 필수입니다.

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

이 예에서는 고급 검색 쿼리 매개변수를 사용하여 검색 쿼리를 추가로 맞춤설정합니다. 이 요청은 q 매개변수 대신 as_q 매개변수 (as_q=red+sox)를 사용합니다. 또한 as_eq 매개변수를 사용하여 'Yankees'라는 단어가 포함된 문서를 검색 결과에서 제외합니다 (as_eq=yankees).

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i  

WebSearch 쿼리 매개변수 정의

    <!DOCTYPE GSP SYSTEM "google.dtd">

고급검색

이미지 아래에 나열된 추가 쿼리 매개변수는 고급 검색어와 관련이 있습니다. 고급 검색을 제출하면 여러 매개변수 (예: as_eq, as_epq, as_oq 등)의 값이 모두 해당 검색의 검색어에 반영됩니다. 이미지는 Google의 고급 검색 페이지를 보여줍니다. 이미지에서 각 고급 검색 매개변수의 이름은 해당 매개변수가 해당하는 페이지의 필드 내부 또는 옆에 빨간색 텍스트로 작성되어 있습니다.

고급 검색 쿼리 매개변수

특수 검색어

Google 웹 검색에서는 Google 검색 엔진의 추가 기능에 액세스하는 여러 특수 쿼리어를 사용할 수 있습니다. 이러한 특수 검색어는 q 요청 매개변수의 값에 포함되어야 합니다. 다른 검색어와 마찬가지로 특수 검색어도 URL 이스케이프 처리되어야 합니다. 특수 쿼리 용어 중 다수에는 콜론 (:)이 포함됩니다. 이 문자도 URL로 이스케이프 처리해야 하며 URL로 이스케이프 처리된 값은 %3A입니다.

샘플 이미지 쿼리

아래 예는 다양한 쿼리 매개변수가 사용되는 방식을 보여주는 이미지 HTTP 요청을 보여줍니다. 다양한 쿼리 매개변수의 정의는 이 문서의 이미지 쿼리 매개변수 정의 섹션에 제공되어 있습니다.

이 요청은 파일 유형이 .png인 검색어 'monkey'(q=monkey)에 대한 처음 5개의 결과(start=0&num=5)를 요청합니다. 마지막으로 쿼리는 client, output, cx 매개변수의 값을 지정하며, 이 세 가지 매개변수는 모두 필수입니다.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

이미지 검색 쿼리 매개변수

요청 한도

아래 차트에는 Google에 전송하는 검색 요청에 대한 제한사항이 나와 있습니다.

질문 및 결과 표시 국제화

Google 웹 검색 서비스를 사용하면 여러 언어로 문서를 검색할 수 있습니다. HTTP 요청을 해석하고 XML 응답을 인코딩하는 데 사용할 문자 인코딩을 지정할 수 있습니다(ie 및 oe 검색 매개변수 사용). 특정 언어로 작성된 문서만 포함하도록 결과를 필터링할 수도 있습니다.

다음 섹션에서는 여러 언어로 검색하는 것과 관련된 문제를 설명합니다.

• 문자 인코딩
• 인터페이스 언어
• 중국어 간체 및 번체 검색

문자 인코딩

서버는 인코딩된 바이트 시퀀스로 웹페이지와 같은 데이터를 브라우저와 같은 사용자 에이전트에 전송합니다. 그러면 사용자 에이전트가 바이트를 문자 시퀀스로 디코딩합니다. WebSearch 서비스에 요청을 보낼 때 검색어와 수신하는 XML 응답의 인코딩 체계를 모두 지정할 수 있습니다.

ie 요청 매개변수를 사용하여 HTTP 요청의 문자 인코딩 메커니즘을 지정할 수 있습니다. oe 매개변수를 사용하여 Google에서 XML 응답을 인코딩하는 데 사용해야 하는 인코딩 스키마를 지정할 수도 있습니다. ISO-8859-1 (또는 latin1) 이외의 인코딩 체계를 사용하는 경우 ie 및 oe 매개변수에 올바른 값을 지정해야 합니다.

참고: 여러 언어의 검색 기능을 제공하는 경우 ie 및 oe 매개변수 모두에 utf8 (UTF-8) 인코딩 값을 사용하는 것이 좋습니다.

ie 및 oe 매개변수에 사용할 수 있는 값의 전체 목록은 문자 인코딩 방식 부록을 참고하세요.

문자 인코딩에 관한 일반적인 내용은 http://www.w3.org/TR/REC-html40/charset.html을 참고하세요.

인터페이스 언어

hl 요청 파라미터를 사용하여 그래픽 인터페이스의 언어를 식별할 수 있습니다. hl 파라미터 값은 특히 언어 제한 (lr 파라미터 사용)이 명시적으로 지정되지 않은 국제 검색어의 경우 XML 검색 결과에 영향을 줄 수 있습니다. 이러한 경우 hl 파라미터는 사용자의 입력 언어와 동일한 언어로 된 검색 결과를 우선적으로 표시할 수 있습니다.

Google이 각 쿼리에 대해 가장 높은 품질의 검색 결과를 선택하도록 검색 결과에서 hl 매개변수를 명시적으로 설정하는 것이 좋습니다.

hl 매개변수의 유효한 값의 전체 목록은 지원되는 인터페이스 언어 섹션을 참고하세요.

특정 언어로 작성된 문서 검색

lr 요청 매개변수를 사용하여 검색 결과를 특정 언어 또는 언어 집합으로 작성된 문서로 제한할 수 있습니다.

lr 매개변수는 불리언 연산자를 지원하므로 검색 결과에 포함 (또는 제외)할 여러 언어를 지정할 수 있습니다.

다음 예에서는 불리언 연산자를 사용하여 다양한 언어로 문서를 요청하는 방법을 보여줍니다.

일본어로 작성된 문서의 경우:

lr=lang_jp

이탈리아어 또는 독일어로 작성된 문서의 경우:

lr=lang_it|lang_de

헝가리어 또는 체코어로 작성되지 않은 문서의 경우:

lr=(-lang_hu).(-lang_cs)

lr 매개변수의 가능한 값의 전체 목록은 언어 컬렉션 값 섹션을 참고하고, 이러한 연산자 사용에 대한 전체 논의는 불리언 연산자 섹션을 참고하세요.

중국어 간체 및 번체 검색

중국어 간체와 중국어 번체는 중국어의 두 가지 쓰기 변형입니다. 동일한 개념이 각 변형에서 다르게 작성될 수 있습니다. 변형 중 하나로 검색어를 입력하면 Google 웹 검색 서비스에서 두 변형의 페이지를 모두 포함하는 결과를 반환할 수 있습니다.

이 기능을 사용하려면 다음과 같이 하세요.

1. c2coff 요청 매개변수를 0으로 설정합니다.
   그리고
2. 다음 중 한 가지 방법을 사용합니다.
   • lr 요청 매개변수를 설정하지 마세요.
     또는
   • lr 요청 매개변수를 lr=lang_zh-TW|lang_zh-CN으로 설정합니다.

다음 예에서는 간체 중국어와 번체 중국어로 결과를 요청할 때 포함할 쿼리 매개변수를 보여줍니다. (client와 같은 추가 필수 정보는 예에 포함되지 않습니다.)

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

결과 필터링

Google 웹 검색에서는 검색 결과를 필터링하는 다양한 방법을 제공합니다.

• 검색 결과 자동 필터링
• 언어 및 국가 필터링
• 세이프서치로 성인용 콘텐츠 필터링하기

검색 결과 자동 필터링

최상의 검색 결과를 제공하기 위해 Google에서는 다음 두 가지 기법을 사용하여 일반적으로 바람직하지 않은 것으로 간주되는 검색 결과를 자동으로 필터링합니다.

• 중복 콘텐츠: 여러 문서에 동일한 정보가 포함되어 있으면 해당 세트 중 가장 관련성이 높은 문서만 검색 결과에 포함됩니다.

• 호스트 크라우딩: 동일한 사이트의 검색 결과가 여러 개 있는 경우 Google에서는 해당 사이트의 결과를 모두 표시하지 않거나
  그렇지 않은 경우보다 순위를 낮춰 표시할 수 있습니다.

필터는 대부분의 검색 결과의 품질을 크게 향상시키므로 일반적인 검색 요청에는 이러한 필터를 사용 설정해 두는 것이 좋습니다. 하지만 검색 요청에서 filter 쿼리 매개변수를 0으로 설정하면 이러한 자동 필터를 우회할 수 있습니다.

언어 및 국가 필터링

Google WebSearch 서비스는 모든 웹 문서의 마스터 색인에서 결과를 반환합니다. 마스터 색인에는 언어와 출신 국가 등 특정 속성별로 그룹화된 문서의 하위 컬렉션이 포함됩니다.

lr 및 cr 요청 매개변수를 사용하여 검색 결과를 특정 언어로 작성되거나 특정 국가에서 유래한 문서의 하위 컬렉션으로 각각 제한할 수 있습니다.

Google WebSearch는 다음 항목을 분석하여 문서의 언어를 결정합니다.

• 문서 URL의 최상위 도메인 (TLD)
• 문서 내 언어 메타 태그
• 문서의 본문 텍스트에 사용되는 기본 언어

언어를 기준으로 결과를 제한하는 방법에 대한 자세한 내용은 lr 매개변수 정의, 특정 언어로 작성된 문서 검색 섹션, lr 매개변수의 값으로 사용할 수 있는 언어 컬렉션 값을 참고하세요.

Google WebSearch는 다음 항목을 분석하여 문서의 국가를 결정합니다.

• 문서 URL의 최상위 도메인 (TLD)
• 웹 서버 IP 주소의 지리적 위치

원산지 국가별로 결과를 제한하는 방법에 대한 자세한 내용은 cr 매개변수 정의와 cr 매개변수의 값으로 사용할 수 있는 국가 컬렉션 값을 참고하세요.

참고: 언어 값과 국가 값을 결합하여 검색 결과를 맞춤설정할 수 있습니다. 예를 들어 프랑스나 캐나다에서 온 프랑스어로 작성된 문서를 요청하거나 네덜란드에서 온 영어로 작성되지 않은 문서를 요청할 수 있습니다. lr 및 cr 매개변수는 모두 불리언 연산자를 지원합니다.

세이프서치로 성인용 콘텐츠 필터링

많은 Google 고객은 성인용 콘텐츠가 포함된 사이트의 검색 결과를 표시하지 않기를 원합니다. Google의 세이프서치 필터를 사용하면 성인용 콘텐츠가 포함된 검색 결과를 검사하여 삭제할 수 있습니다. Google의 필터는 독점 기술을 사용하여 키워드, 문구, URL을 확인합니다. 100% 정확한 필터는 없지만 세이프서치는 검색 결과에서 대부분의 성인용 콘텐츠를 삭제합니다.

Google은 웹을 지속적으로 크롤링하고 사용자 제안의 업데이트를 통합하여 세이프서치를 최대한 최신 상태로 유지하기 위해 노력합니다.

세이프서치는 다음 언어로 제공됩니다.

safe 쿼리 매개변수를 사용하여 Google에서 성인용 콘텐츠를 필터링하는 정도를 조정할 수 있습니다. 다음 표에서는 Google 세이프서치 설정과 이러한 설정이 검색 결과에 미치는 영향을 설명합니다.

세이프서치를 사용 설정했는데 검색 결과에 불쾌감을 주는 콘텐츠가 포함된 사이트가 표시되면 사이트의 URL을 safesearch@google.com으로 이메일을 보내주세요. Google에서 사이트를 조사하겠습니다.

XML 결과

• Google XML 결과 DTD
• XML 응답 정보
• 일반 및 고급 검색어의 XML 결과
• 일반/고급 검색: 샘플 쿼리 및 XML 결과
• 일반/고급 검색: XML 태그

Google XML 결과 DTD

Google은 모든 유형의 검색 결과에 동일한 DTD를 사용하여 XML 형식을 설명합니다. 태그와 속성 대부분은 모든 검색 유형에 적용됩니다. 하지만 일부 태그는 특정 검색 유형에만 적용됩니다. 따라서 DTD의 정의는 이 문서에 제공된 정의보다 제한적이지 않을 수 있습니다.

이 문서에서는 웹 검색과 관련된 DTD의 측면을 설명합니다. DTD를 볼 때 WebSearch에서 작업하는 경우 여기에 문서화되지 않은 태그와 속성은 무시해도 됩니다. DTD와 문서 간에 정의가 다른 경우 이 문서에 해당 사실이 명시됩니다.

Google은 최신 DTD에 대한 참조를 포함하거나 포함하지 않고 XML 결과를 반환할 수 있습니다. DTD는 검색 관리자와 XML 파서가 Google의 XML 결과를 이해하는 데 도움이 되는 가이드입니다. Google의 XML 문법은 경우에 따라 변경될 수 있으므로 DTD를 사용하여 각 XML 결과를 검증하도록 파서를 구성해서는 안 됩니다.

또한 검색 요청을 제출할 때마다 DTD를 가져오도록 XML 파서를 구성해서는 안 됩니다. Google은 DTD를 자주 업데이트하지 않으며 이러한 요청은 불필요한 지연과 대역폭 요구사항을 만듭니다.

XML 결과를 얻으려면 xml_no_dtd 출력 형식을 사용하는 것이 좋습니다. 검색 요청에서 xml 출력 형식을 지정하면 XML 결과에 다음 줄이 포함된다는 점만 다릅니다.

<!DOCTYPE GSP SYSTEM "google.dtd">

최신 DTD는 http://www.google.com/google.dtd에서 확인할 수 있습니다.

현재 DTD의 일부 기능은 지원되지 않을 수 있습니다.

XML 응답 정보

• 모든 요소 값은 XML 태그 정의에 달리 명시되지 않는 한 표시하기에 적합한 유효한 HTML입니다.
• 일부 요소 값은 표시되기 전에 HTML로 인코딩해야 하는 URL입니다.
• XML 파서는 문서화되지 않은 속성과 태그를 무시해야 합니다. 이렇게 하면 Google에서 XML 출력에 기능을 추가하더라도 애플리케이션이 수정 없이 계속 작동할 수 있습니다.
• 특정 문자는 XML 태그에 값으로 포함될 때 이스케이프해야 합니다. XML 프로세서는 이러한 엔티티를 적절한 문자로 다시 변환해야 합니다. 엔티티를 올바르게 변환하지 않으면 브라우저에서 예를 들어 '&' 문자를 '&'로 렌더링할 수 있습니다. XML 표준에 이러한 문자가 문서화되어 있으며 아래 표에 이러한 문자가 재현되어 있습니다.

  문자	이스케이프된 양식	항목	문자 코드
  앰퍼샌드	&	&	&
  작은따옴표	'	'	'
  큰따옴표	"	"	"
  초과	>	>	>
  미만	<	&lt;	&#60;

일반 및 고급 검색어의 XML 결과

일반/고급 검색: 샘플 쿼리 및 XML 결과

이 샘플 WebSearch 요청은 검색어 'socer'(q=socer)에 관한 10개의 결과(num=10)를 요청합니다. 'socer'는 이 예시를 위해 의도적으로 잘못된 철자로 입력된 단어 'soccer'입니다.

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i 

이 요청은 아래의 XML 결과를 생성합니다. 결과에 포함되지 않은 특정 태그가 표시되는 위치를 나타내는 주석이 XML 결과에 여러 개 있습니다.

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

일반/고급 검색: XML 태그

일반 검색 요청과 고급 검색 요청의 XML 응답은 모두 동일한 XML 태그 집합을 사용합니다. 이러한 XML 태그는 위의 XML 예에 표시되어 있으며 아래 표에 설명되어 있습니다.

아래 XML 태그는 태그 이름의 알파벳순으로 나열되어 있으며 각 태그 정의에는 태그 설명, XML 결과에 태그가 표시되는 방식을 보여주는 예, 태그 콘텐츠 형식이 포함되어 있습니다. 태그가 다른 XML 태그의 하위 태그이거나 태그에 자체 하위 태그나 속성이 있는 경우 해당 정보도 태그의 정의 표에 제공됩니다.

아래 정의의 일부 하위 태그 옆에 특정 기호가 표시될 수 있습니다. 이러한 기호와 기호의 의미는 다음과 같습니다.

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

이미지 검색 쿼리의 XML 결과

이 샘플 이미지 요청은 검색어 'monkey'(q=monkey)에 대한 5개의 결과(num=5)를 요청합니다.

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

이 요청은 아래의 XML 결과를 생성합니다.

<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

이미지 검색: XML 태그

아래 표에는 이미지 검색 쿼리의 XML 응답에 사용되는 추가 XML 태그가 나와 있습니다.

아래 정의의 일부 하위 태그 옆에 특정 기호가 표시될 수 있습니다. 이러한 기호와 기호의 의미는 다음과 같습니다.