Referensi API XML

Halaman ini merujuk ke versi XML JSON API Custom Search, yang hanya tersedia untuk Pelanggan Google Penelusuran Situs.

1. Ringkasan
2. Format Permintaan Programmable Search Engine
   1. Ringkasan Permintaan
   2. Persyaratan Kueri
   3. Parameter Permintaan
      1. Contoh Kueri WebSearch
      2. Definisi Parameter Kueri WebSearch
      3. Penelusuran Lanjutan
      4. Parameter Kueri Penelusuran Lanjutan
      5. Persyaratan Kueri Khusus
      6. Contoh Kueri Gambar
      7. Parameter Kueri Penelusuran Gambar
      8. Batas Permintaan
   4. Internasionalisasi Kueri dan Presentasi Hasil
      1. Encoding Karakter
      2. Bahasa Antarmuka
      3. Penelusuran China Aksara Sederhana dan Tradisional
   5. Memfilter Hasil
      1. Pemfilteran Otomatis Hasil Penelusuran
      2. Pemfilteran Bahasa dan Negara
      3. Memfilter Konten Khusus Dewasa dengan SafeSearch
3. Hasil XML
   1. DTD Hasil XML Google
   2. Tentang Respons XML
   3. Hasil XML untuk Reguler, Gambar, dan Kueri Penelusuran 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 Google Site Search pelanggan untuk menampilkan hasil penelusuran Google di situs web mereka. Tujuan Layanan WebSearch menggunakan protokol berbasis HTTP sederhana untuk melayani penelusuran hasil pengujian tersebut. Administrator penelusuran memiliki kontrol penuh atas cara mereka meminta hasil penelusuran dan cara hasil tersebut ditampilkan kepada pengguna akhir. Dokumen ini menjelaskan detail teknis Google format permintaan penelusuran dan hasil penelusuran.

Untuk mengambil hasil Google WebSearch, aplikasi Anda akan mengirim permintaan HTTP sederhana ke Google. Google kemudian menampilkan hasil penelusuran dalam XML format font. Hasil berformat XML memberi Anda kemampuan untuk menyesuaikan bagaimana hasil penelusuran ditampilkan.

Format Permintaan WebSearch

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

Ikhtisar Permintaan

Permintaan penelusuran Google adalah perintah HTTP GET standar. Ini berisi kumpulan parameter yang relevan dengan terhadap kueri. Parameter ini disertakan dalam URL permintaan sebagai name=value pasangan yang dipisahkan oleh karakter ampersand (&). Parameter mencakup data seperti kueri penelusuran dan ID mesin unik (cx) yang mengidentifikasi yang membuat permintaan HTTP. Layanan WebSearch atau Penelusuran Gambar menampilkan XML menghasilkan 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 yang akan difilter dan mengatur hasil penelusuran yang ditampilkan Google. Kueri dapat menentukan:

• Kata atau frasa yang akan disertakan atau kecuali
  • Semua kata dalam kueri penelusuran (default)
  • Frasa yang sama persis di kueri penelusuran
  • Kata atau frasa apa pun dalam kueri penelusuran
• Lokasi dalam dokumen untuk mencari istilah penelusuran
  • Di mana saja dalam dokumen (default)
  • Hanya dalam isi dokumen
  • Hanya dalam judul dokumen
  • Hanya dalam URL dokumen
  • Hanya di link dalam dokumen
• Batasan pada dokumen itu sendiri
  • Menyertakan atau mengecualikan dokumen dari jenis file tertentu (seperti file PDF atau dokumen Word)
• Kueri URL khusus yang menampilkan tentang URL tertentu, daripada melakukan penelusuran
  • Kueri yang menampilkan informasi umum tentang URL, seperti kategori, cuplikan, atau bahasa Direktori Terbukanya
  • Kueri yang menampilkan kumpulan halaman web yang tertaut ke sebuah URL
  • Kueri yang menampilkan kumpulan halaman web yang mirip dengan URL tertentu

Penelusuran Default

Nilai parameter kueri penelusuran harus berupa URL yang di-escape. Perlu diketahui bahwa Anda akan menggantikan tanda plus ("+") untuk setiap urutan spasi kosong pada kueri penelusuran. Hal ini dibahas lebih lanjut di bagian Pelarian URL dalam dokumen ini.

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

q=horses+cows+pigs

Secara default, layanan Google WebSearch hanya menampilkan dokumen menyertakan semua istilah dalam kueri pencarian.

Parameter Permintaan

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

Tiga parameter permintaan diperlukan:

• Parameter client harus ditetapkan ke google-csbe
• Parameter output menentukan format hasil XML yang dikembalikan; hasil dapat ditampilkan dengan (xml) atau tanpa (xml_no_dtd) referensi ke DTD Google. Saran dari kami menetapkan nilai ini ke xml_no_dtd. Catatan: Jika Anda tidak menentukan parameter ini, hasilnya akan ditampilkan dalam HTML bukan XML.
  
• Parameter cx yang mewakili ID mesin telusur.
  

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

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

Contoh Kueri WebSearch

Contoh di bawah ini menunjukkan beberapa permintaan HTTP WebSearch untuk menggambarkan bagaimana parameter kueri yang berbeda digunakan. Definisi untuk parameter kueri yang berbeda disediakan dalam Kueri WebSearch Definisi Parameter dan Kueri Penelusuran Lanjutan Parameter 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 client, output, dan parameter cx, yang ketiganya diperlukan.

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 kueri penelusuran lanjutan parameter untuk menyesuaikan kueri penelusuran lebih lanjut. Permintaan ini menggunakan as_q parameter (as_q=red+sox), bukan parameter q. Model ini juga menggunakan 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 melakukan penelusuran lanjutan, nilai beberapa parameter (mis. as_eq, as_epq, as_oq, dll.) semuanya diperhitungkan dalam kueri istilah untuk penelusuran tersebut. Gambar menampilkan halaman Penelusuran Lanjutan Google. Pada gambar, nama masing-masing Parameter penelusuran lanjutan ditulis dalam teks merah di dalam atau di samping bidang pada halaman yang sesuai dengan parameter tersebut.

Parameter Kueri Penelusuran Lanjutan

Istilah Kueri Khusus

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

Contoh Kueri Gambar

Contoh di bawah ini menunjukkan beberapa permintaan HTTP Gambar untuk mengilustrasikan bagaimana parameter kueri yang berbeda digunakan. Definisi untuk berbagai parameter kueri diberikan di bagian Definisi Parameter Kueri Gambar dalam dokumen ini.

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

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 ini mencantumkan batasan terkait permintaan penelusuran yang kirim ke Google:

Menginternasionalkan Kueri dan Presentasi Hasil

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

Bagian berikut membahas masalah yang terkait dengan penelusuran di beberapa bahasa:

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

Pengkodean Karakter

Server mengirim data, seperti halaman web, ke agen pengguna, seperti {i>browser<i}, sebagai urutan byte yang dienkode. Agen pengguna kemudian mendekode {i>byte<i} menjadi urutan karakter. Saat mengirim permintaan ke WebSearch, Anda dapat menentukan skema encoding untuk dan untuk respons XML yang diterima.

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

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

Silakan lihat Karakter Lampiran Skema Encoding untuk daftar lengkap nilai yang yang dapat Anda gunakan untuk parameter ie dan oe.

Untuk informasi umum lebih lanjut 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. Nilai parameter hl dapat memengaruhi hasil penelusuran XML, terutama pada kueri internasional jika pembatasan bahasa (menggunakan parameter lr) tidak ditentukan secara eksplisit. Dengan demikian kasus, parameter hl dapat mempromosikan hasil penelusuran dalam bahasa yang sama dengan bahasa input pengguna.

Sebaiknya tetapkan parameter hl secara eksplisit di hasil penelusuran untuk memastikan bahwa Google memilih kualitas tertinggi hasil penelusuran untuk setiap kueri.

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

Mencari Dokumen yang Tertulis dalam Bahasa Tertentu

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

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

Contoh berikut menunjukkan bagaimana Anda dapat menggunakan Operator Boolean untuk meminta dokumen di 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 Koleksi Bahasa Bagian Values untuk daftar lengkap nilai yang mungkin untuk parameter lr dan Boolean Operator untuk diskusi lengkap tentang penggunaan operator.

Penelusuran China Aksara Sederhana dan Tradisional

China Aksara Sederhana dan China Aksara Tradisional adalah dua varian tulisan berbahasa China. Konsep yang sama dapat ditulis secara berbeda dalam setiap varian. Dengan kueri di salah satu variannya, Google Layanan WebSearch dapat menampilkan hasil yang menyertakan halaman dalam pada semua varian.

Untuk menggunakan fitur ini:

1. Setel parameter permintaan c2coff ke 0
   dan
2. Lakukan salah satu hal berikut:
   • Jangan setel 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 Aksara Sederhana dan Tradisional. (Perhatikan bahwa informasi tambahan yang diperlukan, seperti sebagai klien, tidak disertakan dalam contoh.)

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

Memfilter Hasil

Google WebSearch menyediakan sejumlah cara untuk memfilter penelusuran hasil:

• Otomatis Pemfilteran Hasil Penelusuran
• Pemfilteran Bahasa dan Negara
• Memfilter Konten Khusus 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, maka 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 tampilkan hasil yang lebih rendah di
  peringkat daripada yang seharusnya.

Sebaiknya biarkan filter ini aktif untuk permintaan penelusuran umum karena filter tersebut meningkatkan kualitas sebagian besar konten penelusuran secara signifikan hasil pengujian tersebut. Namun, Anda dapat mengabaikan filter otomatis ini dengan menetapkan parameter kueri filter ke 0 di kolom permintaan penelusuran.

Pemfilteran Bahasa dan Negara

Layanan Google WebSearch mengembalikan hasil dari indeks master berupa semua dokumen Web. Indeks master berisi subkoleksi dari dokumen yang dikelompokkan menurut atribut tertentu, termasuk bahasa dan negara asal.

Anda dapat menggunakan parameter permintaan lr dan cr untuk membatasi hasil penelusuran ke subkoleksi dari 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 Menelusuri Dokumen yang Ditulis dalam Bahasa Tertentu dan Nilai Pengumpulan Bahasa yang dapat digunakan sebagai nilai untuk parameter lr untuk mengetahui informasi tentang cara membatasi hasil berdasarkan bahasa.

Google WebSearch menentukan negara dokumen dengan menganalisis:

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

Lihat juga definisi parameter cr dan Pengumpulan Negara Nilai yang dapat digunakan sebagai nilai untuk parameter cr guna mendapatkan informasi selengkapnya tentang cara membatasi hasil berdasarkan negara tempat asal.

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

Memfilter Konten Khusus Dewasa dengan SafeSearch

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

Google berusaha menjaga SafeSearch tetap terbaru dan komprehensif bisa dilakukan dengan terus meng-crawl Web dan menggabungkan update dari saran pengguna.

SafeSearch tersedia dalam bahasa berikut:

Anda dapat menyesuaikan sejauh mana Google memfilter hasil Anda konten khusus dewasa menggunakan parameter kueri safe. Tabel berikut menjelaskan setelan SafeSearch Google dan bagaimana setelan tersebut setelan akan memengaruhi hasil penelusuran Anda:

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

Hasil XML

• XML Google DTD hasil
• 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 mendeskripsikan format XML untuk semua jenis hasil penelusuran. Banyak tag dan atribut berlaku untuk semua jenis penelusuran. Namun, beberapa tag hanya berlaku untuk jenis penelusuran. Akibatnya, definisi dalam DTD mungkin kurang membatasi dari definisi yang diberikan dalam dokumen ini.

Dokumen ini menjelaskan aspek-aspek DTD yang relevan untuk WebSearch. Saat Anda melihat DTD, jika Anda sedang mengerjakan WebSearch, Anda dapat mengabaikan tag dan atribut yang tidak didokumentasikan di sini. Jika definisinya 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 XML Google tata bahasa dapat berubah dari waktu ke waktu, Anda sebaiknya tidak mengonfigurasi menggunakan DTD untuk memvalidasi setiap hasil XML.

Selain itu, Anda tidak boleh mengonfigurasi parser XML untuk mengambil DTD setiap kali Anda mengirimkan permintaan penelusuran. Google memperbarui DTD jarang, dan permintaan ini menimbulkan penundaan dan {i>bandwidth<i} yang tidak perlu lainnya.

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.

Perlu diketahui bahwa tidak semua fitur di DTD dapat tersedia atau didukung saat ini.

Tentang Respons XML

• Semua nilai elemen adalah HTML valid yang cocok untuk ditampilkan kecuali dinyatakan lain dalam definisi tag XML.
• Beberapa nilai elemen adalah URL yang harus dienkode dengan HTML sebelum kolom tersebut 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 saat disertakan sebagai nilai dalam Tag XML. Prosesor XML Anda harus mengonversi entitas ini kembali ke karakter yang sesuai. Jika Anda tidak mengonversi entity dengan benar, browser dapat, misalnya, merender & karakter sebagai "&amp;". Elemen XML Standard mendokumentasikan karakter-karakter ini; karakter-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 "sepak bola" sengaja dieja salah 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 akan memberikan hasil XML di bawah. Perhatikan bahwa ada beberapa komentar dalam hasil XML untuk menunjukkan di mana tag tertentu 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 penelusuran lanjutan keduanya menggunakan rangkaian tag XML yang sama. Tag XML ini ditampilkan di contoh XML di atas dan dijelaskan dalam tabel di bawah.

Tag XML di bawah ini dicantumkan menurut abjad berdasarkan nama tag, dan masing-masing berisi deskripsi tag, contoh yang menunjukkan cara tag akan muncul dalam hasil XML dan format tag saat ini. Jika tag merupakan subtag dari tag XML lain atau jika tag memiliki sub tag atau atribut sendiri, informasi itu juga disediakan dalam di tabel definisi tag.

Simbol tertentu mungkin ditampilkan di sebelah beberapa sub tag dalam di bawah ini. 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 akan memberikan 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 menampilkan tag XML tambahan yang digunakan dalam respons XML untuk kueri penelusuran gambar.

Simbol tertentu mungkin ditampilkan di sebelah beberapa sub tag dalam di bawah ini. Berikut adalah simbol-simbol tersebut, beserta maknanya: