Referensi API XML

Halaman ini merujuk pada Custom Search JSON API versi XML, yang hanya tersedia untuk pelanggan Google Site Search.

1. Ringkasan
2. Format Permintaan Programmable Search Engine
   1. Ringkasan Permintaan
   2. Istilah Kueri
   3. Parameter Permintaan
      1. Contoh Kueri WebSearch
      2. Definisi Parameter Kueri WebSearch
      3. Penelusuran Lanjutan
      4. Parameter Kueri Penelusuran Lanjutan
      5. Istilah Kueri Khusus
      6. Contoh Kueri Gambar
      7. Parameter Kueri Penelusuran Gambar
      8. Batas Permintaan
   4. Presentasi Internasionalisasi Kueri dan Hasil
      1. Encoding Karakter
      2. Bahasa Antarmuka
      3. Penelusuran dalam Bahasa China Aksara Sederhana dan Tradisional
   5. Memfilter Hasil
      1. Pemfilteran Otomatis Hasil Penelusuran
      2. Pemfilteran Bahasa dan Negara
      3. Memfilter Konten Dewasa dengan SafeSearch
3. Hasil XML
   1. DTD Hasil XML Google
   2. Tentang Respons XML
   3. Hasil XML untuk Kueri Penelusuran Reguler, Gambar, dan Lanjutan
      1. Penelusuran Reguler/Lanjutan: Contoh Kueri dan Hasil XML
      2. Penelusuran Reguler/Lanjutan: Tag XML
      3. Hasil XML untuk Kueri Penelusuran Gambar
      4. Penelusuran Gambar: Contoh Kueri dan Hasil XML
      5. Penelusuran Gambar: Tag XML

Ringkasan

Layanan Google WebSearch memungkinkan pelanggan Google Site Search menampilkan hasil penelusuran Google di situs mereka sendiri. Layanan WebSearch menggunakan protokol berbasis HTTP sederhana untuk menayangkan hasil penelusuran. Administrator penelusuran memiliki kontrol penuh atas cara mereka meminta hasil penelusuran dan cara mereka menampilkan hasil tersebut kepada pengguna akhir. Dokumen ini menjelaskan detail teknis format permintaan dan hasil penelusuran Google.

Untuk mengambil hasil Google WebSearch, aplikasi Anda mengirimkan permintaan HTTP sederhana ke Google. Kemudian, Google akan menampilkan hasil penelusuran dalam format XML. Hasil berformat XML memberi Anda kemampuan untuk menyesuaikan cara hasil penelusuran ditampilkan.

Format Permintaan WebSearch

• Permintaan Ringkasan
• Istilah Kueri
• Parameter Permintaan
• Contoh Kueri WebSearch
• Kueri WebSearch Definisi Parameter
• Contoh Kueri Gambar
• Kueri Penelusuran Gambar Definisi Parameter
• Penelusuran Lanjutan
  
• Parameter Kueri Penelusuran Lanjutan
• Istilah Kueri Khusus
• Batas Permintaan

Ikhtisar Permintaan

Permintaan penelusuran Google adalah perintah HTTP GET standar. Objek ini mencakup kumpulan parameter yang relevan dengan kueri Anda. Parameter ini disertakan dalam URL permintaan sebagai pasangan name=value yang dipisahkan oleh karakter ampersand (&). Parameter mencakup data seperti kueri penelusuran dan ID mesin telusur unik (cx) yang mengidentifikasi mesin telusur yang membuat permintaan HTTP. Layanan WebSearch atau Penelusuran Gambar menampilkan hasil XML sebagai respons terhadap permintaan HTTP Anda.

Persyaratan Kueri

Sebagian besar permintaan penelusuran menyertakan satu atau beberapa istilah kueri. Istilah kueri muncul sebagai nilai parameter dalam permintaan penelusuran.

Istilah kueri dapat menentukan beberapa jenis informasi untuk memfilter dan mengatur hasil penelusuran yang ditampilkan Google. Kueri dapat menentukan:

• Kata atau frasa yang akan disertakan atau dikecualikan
  • Semua kata dalam kueri penelusuran (default)
  • Frasa persis dalam kueri penelusuran
  • Setiap kata atau frasa dalam kueri penelusuran
• Di mana dalam dokumen untuk mencari istilah penelusuran
  • Di mana pun dalam dokumen (default)
  • Hanya di link dalam dokumen
• Pembatasan pada dokumen itu sendiri
  • Menyertakan atau mengecualikan dokumen dengan jenis file tertentu (seperti file PDF atau dokumen Word)
• Kueri URL khusus yang menampilkan informasi tentang URL tertentu, bukan melakukan penelusuran
  • Kueri yang menampilkan informasi umum tentang URL, seperti kategori, cuplikan, atau bahasa Open Directory-nya
  • Kueri yang menampilkan kumpulan halaman web yang menautkan ke URL
  • Kueri yang menampilkan sekumpulan halaman web yang mirip dengan URL tertentu

Penelusuran Default

Nilai parameter kueri penelusuran harus di-escape URL. Perhatikan bahwa Anda akan mengganti tanda plus ("+") untuk urutan spasi apa pun dalam kueri penelusuran. Hal ini dibahas lebih lanjut di bagian URL Escaping dalam dokumen ini.

Istilah kueri penelusuran dikirimkan ke layanan WebSearch menggunakan parameter q. A contoh istilah kueri penelusuran adalah:

q=horses+cows+pigs

Secara default, layanan Google WebSearch hanya menampilkan dokumen yang mencakup semua istilah dalam kueri penelusuran.

Parameter Permintaan

Bagian ini mencantumkan parameter yang dapat Anda gunakan saat membuat permintaan penelusuran. Parameter dibagi menjadi dua daftar. Daftar pertama berisi parameter yang relevan dengan semua permintaan penelusuran. Daftar kedua berisi parameter yang hanya relevan dengan permintaan penelusuran lanjutan.

Tiga parameter permintaan diperlukan:

• Parameter client harus disetel ke google-csbe
• Parameter output menentukan format hasil XML yang ditampilkan; hasil dapat ditampilkan dengan (xml) atau tanpa (xml_no_dtd) referensi ke DTD Google. Sebaiknya tetapkan nilai ini menjadi xml_no_dtd. Catatan: Jika Anda tidak menentukan parameter ini, hasil akan ditampilkan dalam HTML, bukan XML.
  
• Parameter cx yang merepresentasikan ID unik mesin.
  

Parameter permintaan yang paling umum digunakan selain yang disebutkan di atas adalah:

• num—jumlah hasil penelusuran yang diminta
• q—istilah penelusuran
• start—indeks awal untuk hasil

Contoh Kueri Penelusuran Web

Contoh di bawah menunjukkan beberapa permintaan HTTP WebSearch untuk mengilustrasikan cara penggunaan berbagai parameter kueri. Definisi untuk berbagai parameter kueri disediakan di bagian Definisi Parameter Kueri WebSearch dan Parameter Kueri Penelusuran Lanjutan dalam dokumen ini.

Permintaan ini meminta 10 hasil pertama (start=0&num=10) untuk istilah kueri "red sox" (q=red+sox). Kueri juga menentukan bahwa hasil harus berasal dari situs web Kanada (cr=countryCA) dan harus ditulis dalam bahasa Prancis (lr=lang_fr). Terakhir, kueri menentukan nilai untuk parameter client, output, dan cx, yang ketiganya wajib diisi.

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

Contoh ini menggunakan beberapa parameter kueri penelusuran lanjutan untuk menyesuaikan kueri penelusuran lebih lanjut. Permintaan ini menggunakan parameter as_q (as_q=red+sox) dan bukan parameter q. Hal ini juga menggunakan parameter as_eq untuk mengecualikan dokumen yang berisi kata "Yankees" dari hasil penelusuran (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  

Definisi Parameter Kueri WebSearch

    <!DOCTYPE GSP SYSTEM "google.dtd">

Penelusuran Lanjutan

Parameter kueri tambahan yang tercantum di bawah gambar relevan dengan kueri penelusuran lanjutan. Saat Anda mengirimkan penelusuran lanjutan, nilai beberapa parameter (misalnya, as_eq, as_epq, as_oq, dll.) semuanya diperhitungkan dalam istilah kueri untuk penelusuran tersebut. Gambar ini menampilkan halaman Penelusuran Lanjutan Google. Pada gambar, nama setiap parameter penelusuran lanjutan ditulis dalam teks merah di dalam atau di samping kolom di halaman yang sesuai dengan parameter tersebut.

Parameter Kueri Penelusuran Lanjutan

Istilah Kueri Khusus

Google WebSearch mengizinkan penggunaan beberapa istilah kueri khusus yang mengakses kemampuan tambahan mesin telusur Google. Istilah kueri khusus ini harus disertakan dalam nilai parameter permintaan q. Seperti istilah kueri lainnya, istilah kueri khusus harus di-escape URL. Sejumlah istilah kueri khusus berisi titik dua (:). Karakter ini juga harus di-escape URL; nilai yang di-escape URL adalah %3A.

Contoh Kueri Gambar

Contoh di bawah menunjukkan beberapa permintaan HTTP Gambar untuk mengilustrasikan cara penggunaan berbagai parameter kueri. Definisi untuk berbagai parameter kueri disediakan di bagian Definisi Parameter Kueri Gambar dalam dokumen ini.

Permintaan ini meminta 5 hasil pertama (start=0&num=5) untuk istilah kueri "monkey" (q=monkey), dengan jenis file .png. Terakhir, kueri menentukan nilai untuk parameter client, output, dan cx, yang ketiganya wajib diisi.

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

Parameter Kueri Penelusuran Gambar

Batas Permintaan

Diagram di bawah mencantumkan batasan pada permintaan penelusuran yang Anda kirim ke Google:

Menginternasionalisasi Kueri dan Presentasi Hasil

Layanan Google WebSearch memungkinkan Anda menelusuri dokumen dalam beberapa bahasa. Anda dapat menentukan encoding karakter yang harus digunakan untuk menafsirkan permintaan HTTP dan mengenkode respons XML (menggunakan parameter penelusuran ie dan oe). Anda juga dapat memfilter hasil untuk hanya menyertakan dokumen yang ditulis dalam bahasa tertentu.

Bagian berikut membahas masalah terkait penelusuran dalam beberapa bahasa:

• Encoding Karakter
• Bahasa Antarmuka
• China Aksara Sederhana dan Tradisional Penelusuran

Encoding Karakter

Server mengirimkan data, seperti halaman web, ke agen pengguna, seperti browser, sebagai urutan byte yang dienkode. Agen pengguna kemudian mendekode byte menjadi urutan karakter. Saat mengirim permintaan ke layanan WebSearch, Anda dapat menentukan skema encoding untuk kueri penelusuran dan respons XML yang Anda terima.

Anda dapat menggunakan parameter permintaan ie untuk menentukan mekanisme encoding untuk karakter dalam permintaan HTTP Anda. Anda juga dapat menggunakan parameter oe untuk menentukan skema encoding yang harus digunakan Google untuk mengenkode respons XML Anda. Jika Anda menggunakan skema encoding selain ISO-8859-1 (atau latin1), pastikan Anda menentukan nilai yang benar untuk parameter ie dan oe.

Catatan: Jika Anda menyediakan fungsi penelusuran untuk beberapa bahasa, sebaiknya gunakan nilai encoding utf8 (UTF-8) untuk parameter ie dan oe.

Lihat lampiran Skema Encoding Karakter untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan untuk parameter ie dan oe.

Untuk informasi umum selengkapnya tentang encoding karakter, lihat http://www.w3.org/TR/REC-html40/charset.html.

Bahasa Antarmuka

Anda dapat menggunakan parameter permintaan hl untuk mengidentifikasi bahasa antarmuka grafis Anda. Nilai parameter hl dapat memengaruhi hasil penelusuran XML, terutama pada kueri internasional jika batasan bahasa (menggunakan parameter lr) tidak ditentukan secara eksplisit. Dalam kasus tersebut, parameter hl dapat mempromosikan hasil penelusuran dalam bahasa yang sama dengan bahasa input pengguna.

Sebaiknya Anda menetapkan parameter hl secara eksplisit dalam hasil penelusuran untuk memastikan bahwa Google memilih hasil penelusuran berkualitas tertinggi untuk setiap kueri.

Lihat bagian Bahasa Antarmuka yang Didukung untuk mengetahui daftar lengkap nilai yang valid untuk parameter hl.

Menelusuri Dokumen yang Ditulis dalam Bahasa Tertentu

Anda dapat menggunakan parameter permintaan lr untuk membatasi hasil penelusuran pada dokumen yang ditulis dalam bahasa atau sekumpulan bahasa tertentu.

Parameter lr mendukung Operator Boolean untuk memungkinkan Anda menentukan beberapa bahasa yang harus disertakan (atau dikecualikan) dari hasil penelusuran.

Contoh berikut menunjukkan cara Anda dapat menggunakan Operator Boolean untuk meminta dokumen dalam bahasa yang berbeda.

Untuk dokumen yang ditulis dalam bahasa Jepang:

lr=lang_jp

Untuk dokumen yang ditulis dalam bahasa Italia atau Jerman:

lr=lang_it|lang_de

Untuk dokumen yang tidak ditulis dalam bahasa Hungaria atau Ceko:

lr=(-lang_hu).(-lang_cs)

Lihat bagian Nilai Kumpulan Bahasa untuk mengetahui daftar lengkap kemungkinan nilai untuk parameter lr dan bagian Operator Boolean untuk mengetahui pembahasan lengkap tentang penggunaan operator ini.

Penelusuran dalam Bahasa China Sederhana dan Tradisional

China Sederhana dan China Tradisional adalah dua varian penulisan bahasa China. Konsep yang sama dapat ditulis secara berbeda di setiap varian. Mengingat kueri dalam salah satu varian, layanan Google WebSearch dapat menampilkan hasil yang menyertakan halaman dalam kedua varian.

Untuk menggunakan fitur ini:

1. Tetapkan parameter permintaan c2coff ke 0
   dan
2. Lakukan salah satu hal berikut:
   • Jangan tetapkan parameter permintaan lr
     atau
   • Tetapkan parameter permintaan lr ke lr=lang_zh-TW|lang_zh-CN

Contoh berikut menunjukkan parameter kueri yang akan Anda sertakan dalam permintaan hasil dalam bahasa China yang disederhanakan dan tradisional. (Perhatikan bahwa informasi tambahan yang diperlukan, seperti klien, tidak disertakan dalam contoh.)

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

Memfilter Hasil

Penelusuran Web Google menyediakan sejumlah cara untuk memfilter hasil penelusuran Anda:

• Pemfilteran Otomatis Hasil Penelusuran
• Pemfilteran Bahasa dan Negara
• Memfilter Konten Dewasa dengan SafeSearch

Pemfilteran Otomatis Hasil Penelusuran

Dalam upaya untuk memberikan hasil penelusuran terbaik, Google menggunakan dua teknik untuk secara otomatis memfilter hasil penelusuran yang umumnya dianggap tidak diinginkan:

• Konten Duplikat—Jika beberapa dokumen berisi informasi yang sama, hanya dokumen paling relevan dari kumpulan tersebut yang disertakan dalam hasil penelusuran Anda.

• Host Crowding—Jika ada banyak hasil penelusuran dari situs yang sama, Google mungkin tidak menampilkan semua hasil dari situs tersebut atau mungkin menampilkan hasil dengan peringkat yang lebih rendah
  daripada yang seharusnya.

Sebaiknya Anda tetap mengaktifkan filter ini untuk permintaan penelusuran umum karena filter ini meningkatkan kualitas sebagian besar hasil penelusuran secara signifikan. Namun, Anda dapat melewati filter otomatis ini dengan menyetel parameter kueri filter ke 0 dalam permintaan penelusuran.

Pemfilteran Bahasa dan Negara

Layanan Google WebSearch menampilkan hasil dari indeks utama semua dokumen Web. Indeks utama berisi subkoleksi dokumen yang dikelompokkan berdasarkan atribut tertentu, termasuk bahasa dan negara asal.

Anda dapat menggunakan parameter permintaan lr dan cr untuk membatasi hasil penelusuran ke subkoleksi dokumen yang ditulis dalam bahasa tertentu atau berasal dari negara tertentu.

Google WebSearch menentukan bahasa dokumen dengan menganalisis:

• domain level teratas (TLD) dari URL dokumen
• tag meta bahasa dalam dokumen
• bahasa utama yang digunakan dalam teks isi dokumen

Lihat juga definisi parameter lr, bagian tentang Menelusuri Dokumen yang Ditulis dalam Bahasa Tertentu, dan Nilai Kumpulan Bahasa yang dapat digunakan sebagai nilai untuk parameter lr untuk mengetahui informasi selengkapnya tentang pembatasan hasil berdasarkan bahasa.

Google WebSearch menentukan negara dokumen dengan menganalisis:

• domain level teratas (TLD) dari URL dokumen
• lokasi geografis alamat IP server Web

Lihat juga definisi parameter cr dan Nilai Kumpulan Negara yang dapat digunakan sebagai nilai untuk parameter cr guna mengetahui informasi selengkapnya tentang membatasi hasil menurut negara asal.

Catatan: Anda dapat menggabungkan nilai bahasa dan nilai negara untuk menyesuaikan hasil penelusuran Anda. Misalnya, Anda dapat meminta dokumen yang ditulis dalam bahasa Prancis dan berasal dari Prancis atau Kanada, atau Anda dapat meminta dokumen yang berasal dari Belanda dan tidak ditulis dalam bahasa Inggris. Parameter lr dan cr mendukung Operator Boolean.

Memfilter Konten Dewasa dengan SafeSearch

Banyak pelanggan Google tidak ingin menampilkan hasil penelusuran untuk situs yang berisi konten dewasa. Dengan filter SafeSearch kami, Anda dapat menyaring hasil penelusuran yang berisi konten dewasa dan menghapusnya. Filter Google menggunakan teknologi eksklusif untuk memeriksa kata kunci, frasa, dan URL. Meskipun tidak ada filter yang 100 persen akurat, SafeSearch akan menghapus sebagian besar konten dewasa dari hasil penelusuran Anda.

Google berupaya menjaga agar SafeSearch selalu terbaru dan sekomprehensif mungkin dengan terus meng-crawl Web dan menyertakan pembaruan dari saran pengguna.

SafeSearch tersedia dalam bahasa berikut:

Anda dapat menyesuaikan tingkat pemfilteran hasil penelusuran Anda oleh Google untuk konten dewasa menggunakan parameter kueri safe. Tabel berikut menjelaskan setelan SafeSearch Google dan pengaruh setelan tersebut terhadap hasil penelusuran Anda:

Jika Anda telah mengaktifkan SafeSearch dan menemukan situs yang berisi konten menyinggung dalam hasil penelusuran Anda, kirimkan URL situs tersebut melalui email ke safesearch@google.com, dan kami akan menyelidiki situs tersebut.

Hasil XML

• DTD Hasil XML Google
• Tentang Respons XML
• XML Hasil untuk Kueri Penelusuran Reguler dan Lanjutan
• Penelusuran Reguler/Lanjutan: Contoh Kueri dan Hasil XML
• Penelusuran Reguler/Lanjutan: Tag XML

DTD Hasil XML Google

Google menggunakan DTD yang sama untuk menjelaskan format XML untuk semua jenis hasil penelusuran. Banyak tag dan atribut yang berlaku untuk semua jenis penelusuran. Namun, beberapa tag hanya berlaku untuk jenis penelusuran tertentu. Akibatnya, definisi dalam DTD mungkin kurang membatasi daripada definisi yang diberikan dalam dokumen ini.

Dokumen ini menjelaskan aspek DTD yang relevan untuk WebSearch. Saat melihat DTD, jika Anda sedang mengerjakan WebSearch, Anda dapat mengabaikan tag dan atribut yang tidak didokumentasikan di sini. Jika definisi berbeda antara DTD dan dokumentasi, fakta tersebut dicatat dalam dokumen ini.

Google dapat menampilkan hasil XML dengan atau tanpa referensi ke DTD terbaru. DTD adalah panduan untuk membantu administrator penelusuran dan parser XML memahami hasil XML Google. Karena tata bahasa XML Google dapat berubah dari waktu ke waktu, Anda tidak boleh mengonfigurasi parser untuk menggunakan DTD guna memvalidasi setiap hasil XML.

Selain itu, Anda tidak boleh mengonfigurasi parser XML untuk mengambil DTD setiap kali Anda mengirimkan permintaan penelusuran. Google jarang memperbarui DTD, dan permintaan ini menyebabkan penundaan dan persyaratan bandwidth yang tidak perlu.

Google merekomendasikan agar Anda menggunakan format output xml_no_dtd untuk mendapatkan hasil XML. Jika Anda menentukan format output xml dalam permintaan penelusuran, satu-satunya perbedaan adalah penyertaan baris berikut dalam hasil XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Anda dapat mengakses DTD terbaru di http://www.google.com/google.dtd.

Perhatikan bahwa tidak semua fitur dalam DTD mungkin tersedia atau didukung untuk saat ini.

Tentang Respons XML

• Semua nilai elemen adalah HTML yang valid dan cocok untuk ditampilkan, kecuali jika dinyatakan lain dalam definisi tag XML.
• Beberapa nilai elemen adalah URL yang perlu dienkode HTML sebelum ditampilkan.
• Parser XML Anda harus mengabaikan atribut dan tag yang tidak terdokumentasi. Hal ini memungkinkan aplikasi Anda terus berfungsi tanpa modifikasi jika Google menambahkan lebih banyak fitur ke output XML.
• Karakter tertentu harus di-escape jika disertakan sebagai nilai dalam tag XML. Prosesor XML Anda harus mengonversi kembali entitas ini menjadi karakter yang sesuai. Jika Anda tidak mengonversi entitas dengan benar, browser dapat, misalnya, merender karakter & sebagai "&". XML Standard mendokumentasikan karakter ini; karakter ini direproduksi dalam tabel di bawah:

  Karakter	Formulir yang di-escape	Entitas	Kode Karakter
  Ampersand	&	&	&
  Petik Satu	'	'	'
  Petik Dua	"	"	"
  Lebih Dari	>	>	>
  Kurang Dari	<	&lt;	&#60;

Hasil XML untuk Kueri Penelusuran Reguler dan Lanjutan

Penelusuran Reguler/Lanjutan: Contoh Kueri dan Hasil XML

Contoh permintaan WebSearch ini meminta 10 hasil (num=10) tentang istilah penelusuran "socer" (q=socer), yang merupakan kata "soccer" yang sengaja salah dieja untuk contoh ini.)

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

Permintaan ini menghasilkan hasil XML di bawah. Perhatikan bahwa ada beberapa komentar dalam hasil XML untuk menunjukkan tempat munculnya tag tertentu yang tidak disertakan dalam hasil.

<?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>

Penelusuran Reguler/Lanjutan: Tag XML

Respons XML untuk permintaan penelusuran reguler dan permintaan penelusuran lanjutan menggunakan set tag XML yang sama. Tag XML ini ditampilkan dalam contoh XML di atas dan dijelaskan dalam tabel di bawah.

Tag XML di bawah dicantumkan menurut nama tag secara alfabetis, dan setiap definisi tag berisi deskripsi tag, contoh yang menunjukkan cara tag akan muncul dalam hasil XML, dan format konten tag. Jika tag adalah sub-tag dari tag XML lain atau jika tag memiliki sub-tag atau atributnya sendiri, informasi tersebut juga diberikan dalam tabel definisi tag.

Simbol tertentu dapat ditampilkan di samping beberapa subtag dalam definisi di bawah. Berikut adalah simbol-simbol tersebut, beserta maknanya:

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

Hasil XML untuk Kueri Penelusuran Gambar

Contoh permintaan Gambar ini meminta 5 hasil (num=5) tentang istilah penelusuran "monyet" (q=monyet).

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

Permintaan ini menghasilkan hasil XML di bawah.

<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>

Penelusuran Gambar: Tag XML

Tabel di bawah ini menunjukkan tag XML tambahan yang digunakan dalam respons XML untuk kueri penelusuran gambar.

Simbol tertentu dapat ditampilkan di samping beberapa subtag dalam definisi di bawah. Berikut adalah simbol-simbol tersebut, beserta maknanya: