Referência da API XML

Esta página se refere à versão XML da API Custom Search JSON, que está disponível apenas para clientes do Pesquisa no site do Google.

1. Visão geral
2. Formato de solicitação do Mecanismo de Pesquisa Programável
   1. Visão geral da solicitação
   2. Termos de consulta
   3. Parâmetros de solicitação
      1. Exemplos de consultas da Pesquisa Google
      2. Definições de parâmetros de consulta da pesquisa na Web
      3. Pesquisa avançada
      4. Parâmetros de consulta da Pesquisa avançada
      5. Termos especiais de consulta
      6. Exemplos de consultas de imagens
      7. Parâmetros de consulta da Pesquisa de imagens
      8. Limites de solicitações
   4. Internacionalização de consultas e apresentação de resultados
      1. Codificação de caracteres
      2. Idiomas da interface
      3. Pesquisa em chinês simplificado e tradicional
   5. Como filtrar resultados
      1. Filtragem automática de resultados da pesquisa
      2. Filtragem por idioma e país
      3. Filtrar conteúdo adulto com o SafeSearch
3. Resultados em XML
   1. DTD de resultados XML do Google
   2. Sobre a resposta XML
   3. Resultados XML para consultas de pesquisa regular, de imagens e avançada
      1. Pesquisa regular/avançada: exemplo de consulta e resultado em XML
      2. Pesquisa regular/avançada: tags XML
      3. Resultados XML para consultas de pesquisa de imagens
      4. Pesquisa de imagens: exemplo de consulta e resultado XML
      5. Pesquisa de imagens: tags XML

Visão geral

O serviço Pesquisa na Web do Google permite que os clientes da Pesquisa no Site do Google mostrem resultados da pesquisa do Google nos próprios sites. O serviço WebSearch usa um protocolo simples baseado em HTTP para veicular resultados de pesquisa. Os administradores de pesquisa têm controle total sobre a forma como solicitam e apresentam os resultados aos usuários finais. Este documento descreve os detalhes técnicos dos formatos de solicitação e resultados da Pesquisa Google.

Para recuperar resultados da Pesquisa na Web do Google, seu aplicativo envia ao Google uma solicitação HTTP simples. Em seguida, o Google retorna os resultados da pesquisa em formato XML. Os resultados formatados em XML permitem personalizar a forma como os resultados da pesquisa são exibidos.

Formato da solicitação de pesquisa na Web

• Visão geral da solicitação
• Termos de consulta
• Parâmetros de solicitação
• Exemplos de consultas da Pesquisa Google
• Definições de parâmetros de consulta da pesquisa na Web
• Exemplos de consultas de imagens
• Definições de parâmetros de consulta de pesquisa de imagens
• Pesquisa avançada
  
• Parâmetros de consulta da pesquisa avançada
• Termos especiais de consulta
• Limites de solicitações

Visão geral da solicitação

A solicitação de pesquisa do Google é um comando HTTP GET padrão. Ele inclui uma coleção de parâmetros relevantes para suas consultas. Esses parâmetros são incluídos no URL da solicitação como pares nome=valor separados por caracteres de "e" comercial (&). Os parâmetros incluem dados como a consulta de pesquisa e um ID exclusivo do mecanismo (cx) que identifica o mecanismo que está fazendo a solicitação HTTP. O serviço WebSearch ou Pesquisa de imagens retorna resultados XML em resposta às suas solicitações HTTP.

Termos de consulta

A maioria das solicitações de pesquisa inclui um ou mais termos de consulta. Um termo de consulta aparece como o valor de um parâmetro na solicitação de pesquisa.

Os termos de consulta podem especificar vários tipos de informações para filtrar e organizar os resultados da pesquisa retornados pelo Google. As consultas podem especificar:

• Palavras ou frases para incluir ou excluir
  • Todas as palavras em uma consulta de pesquisa (padrão)
  • Uma frase exata na consulta de pesquisa
  • Qualquer palavra ou frase em uma consulta de pesquisa
• Onde em um documento procurar os termos de pesquisa
  • Em qualquer lugar do documento (padrão)
  • Apenas em links no documento
• Restrições nos próprios documentos
  • Incluir ou excluir documentos de tipos de arquivo específicos (como arquivos PDF ou documentos do Word)
• Consultas especiais de URL que retornam informações sobre um determinado URL, em vez de fazer uma pesquisa.
  • Consultas que retornam informações gerais sobre um URL, como categoria, snippet ou idioma do Open Directory
  • Consultas que retornam o conjunto de páginas da Web vinculadas a um URL
  • Consultas que retornam um conjunto de páginas da Web semelhantes a um determinado URL

Pesquisa padrão

Os valores de parâmetro de consulta de pesquisa precisam ter escape de URL. Substitua o sinal de adição ("+") por qualquer sequência de espaços em branco na consulta de pesquisa. Isso é abordado na seção Escape de URL deste documento.

O termo de consulta de pesquisa é enviado ao serviço WebSearch usando o parâmetro q. Um exemplo de termo de pesquisa é:

q=horses+cows+pigs

Por padrão, o serviço Google WebSearch retorna apenas documentos que incluem todos os termos na consulta de pesquisa.

Parâmetros de solicitação

Esta seção lista os parâmetros que podem ser usados ao fazer uma solicitação de pesquisa. Eles são divididos em duas listas. A primeira contém parâmetros relevantes para todas as solicitações de pesquisa. A segunda contém parâmetros relevantes apenas para solicitações de pesquisa avançada.

Três parâmetros de solicitação são obrigatórios:

• O parâmetro client precisa ser definido como google-csbe.
• O parâmetro output especifica o formato dos resultados XML retornados. Eles podem ser retornados com (xml) ou sem (xml_no_dtd) uma referência à DTD do Google. Recomendamos definir esse valor como xml_no_dtd. Observação:se você não especificar esse parâmetro, os resultados serão retornados em HTML em vez de XML.
  
• O parâmetro cx, que representa o ID exclusivo do mecanismo.
  

Os parâmetros de solicitação usados com frequência, além dos mencionados acima, são:

• num: o número solicitado de resultados da pesquisa.
• q: os termos de pesquisa
• start: o índice inicial dos resultados

Exemplos de consultas de pesquisa na Web

Os exemplos abaixo mostram algumas solicitações HTTP do WebSearch para ilustrar como diferentes parâmetros de consulta são usados. As definições dos diferentes parâmetros de consulta estão nas seções Definições de parâmetros de consulta da pesquisa na Web e Parâmetros de consulta da pesquisa avançada deste documento.

Essa solicitação pede os 10 primeiros resultados (start=0&num=10) para o termo de consulta "red sox" (q=red+sox). A consulta também especifica que os resultados devem vir de sites canadenses (cr=countryCA) e estar em francês (lr=lang_fr). Por fim, a consulta especifica valores para os parâmetros client, output e cx, todos obrigatórios.

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

Este exemplo usa alguns dos parâmetros de consulta de pesquisa avançada para personalizar ainda mais a consulta. Essa solicitação usa o parâmetro as_q (as_q=red+sox) em vez do parâmetro q. Ele também usa o parâmetro as_eq para excluir dos resultados da pesquisa (as_eq=yankees) todos os documentos que contêm a palavra "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  

Definições de parâmetros de consulta da pesquisa na Web

    <!DOCTYPE GSP SYSTEM "google.dtd">

Pesquisa avançada

Os parâmetros de consulta adicionais listados abaixo da imagem são relevantes para consultas de pesquisa avançada. Quando você envia uma pesquisa avançada, os valores de vários parâmetros (por exemplo, as_eq, as_epq, as_oq etc.) são incluídos nos termos de consulta dessa pesquisa. A imagem mostra a página da Pesquisa avançada do Google. Na imagem, o nome de cada parâmetro de pesquisa avançada está escrito em texto vermelho dentro ou ao lado do campo na página a que o parâmetro corresponde.

Parâmetros de consulta da pesquisa avançada

Termos de consulta especiais

A Pesquisa na Web do Google permite o uso de vários termos de consulta especiais que acessam recursos adicionais do mecanismo de pesquisa do Google. Esses termos de consulta especiais precisam ser incluídos no valor do parâmetro de solicitação q. Assim como outros termos de consulta, os termos de consulta especiais precisam ser escapados por URL. Vários termos de consulta especiais contêm dois pontos (:). Esse caractere também precisa ser escapado por URL. O valor escapado por URL é %3A.

Exemplos de consultas de imagem

Os exemplos abaixo mostram algumas solicitações HTTP de imagem para ilustrar como diferentes parâmetros de consulta são usados. As definições dos diferentes parâmetros de consulta estão nas seções "Definições de parâmetros de consulta de imagem" deste documento.

Essa solicitação pede os cinco primeiros resultados (start=0&num=5) para o termo de consulta "macaco" (q=monkey), do tipo de arquivo .png. Por fim, a consulta especifica valores para os parâmetros client, output e cx, que são obrigatórios.

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

Parâmetros de consulta da Pesquisa de imagens

Limites de solicitação

O gráfico abaixo lista as limitações das solicitações de pesquisa que você envia ao Google:

Internacionalização de consultas e apresentação de resultados

O serviço Pesquisa na Web do Google permite pesquisar documentos em vários idiomas. Você pode especificar a codificação de caracteres que deve ser usada para interpretar sua solicitação HTTP e codificar sua resposta XML (usando os parâmetros de pesquisa ie e oe). Também é possível filtrar os resultados para incluir apenas documentos escritos em determinados idiomas.

As seções a seguir abordam questões relacionadas à pesquisa em vários idiomas:

• Codificação de caracteres
• Idiomas da interface
• Pesquisa em chinês simplificado e tradicional

Codificação de caracteres

Os servidores enviam dados, como páginas da Web, para agentes de usuários, como navegadores, como uma sequência de bytes codificados. Em seguida, o user agent decodifica os bytes em uma sequência de caracteres. Ao enviar solicitações para o serviço WebSearch, é possível especificar os esquemas de codificação para a consulta de pesquisa e para a resposta XML recebida.

Use o parâmetro de solicitação ie para especificar o mecanismo de codificação dos caracteres na sua solicitação HTTP. Também é possível usar o parâmetro oe para especificar o esquema de codificação que o Google deve usar para codificar sua resposta XML. Se você estiver usando um esquema de codificação diferente de ISO-8859-1 (ou latin1), especifique os valores corretos para os parâmetros ie e oe.

Observação:se você estiver oferecendo funcionalidade de pesquisa para vários idiomas, recomendamos usar o valor de codificação utf8 (UTF-8) para os parâmetros ie e oe.

Consulte o apêndice Esquemas de codificação de caracteres para ver uma lista completa dos valores que podem ser usados nos parâmetros ie e oe.

Para mais informações gerais sobre codificação de caracteres, consulte http://www.w3.org/TR/REC-html40/charset.html (em inglês).

Idiomas da interface

Você pode usar o parâmetro de solicitação hl para identificar o idioma da interface gráfica. O valor de parâmetro hl pode afetar os resultados da pesquisa XML, principalmente em consultas internacionais quando a restrição de idioma (usando o parâmetro lr) não é especificada explicitamente. Nesses casos, o parâmetro hl pode promover resultados da pesquisa no mesmo idioma do idioma de entrada do usuário.

Recomendamos que você defina explicitamente o parâmetro hl nos resultados da pesquisa para garantir que o Google selecione os resultados de pesquisa da mais alta qualidade para cada consulta.

Consulte a seção Idiomas da interface compatíveis para conferir uma lista completa de valores válidos para o parâmetro hl.

Pesquisar documentos escritos em idiomas específicos

Você pode usar o parâmetro de solicitação lr para restringir os resultados da pesquisa a documentos escritos em um idioma ou conjunto de idiomas específico.

O parâmetro lr é compatível com operadores booleanos para que você possa especificar vários idiomas que devem ser incluídos (ou excluídos) dos resultados da pesquisa.

Os exemplos a seguir mostram como usar operadores booleanos para solicitar documentos em diferentes idiomas.

Para documentos escritos em japonês:

lr=lang_jp

Para documentos escritos em italiano ou alemão:

lr=lang_it|lang_de

Para documentos que não foram escritos em húngaro ou tcheco:

lr=(-lang_hu).(-lang_cs)

Consulte a seção Valores da coleta de idioma para ver uma lista completa de valores possíveis para o parâmetro lr e a seção Operadores booleanos para uma discussão completa sobre o uso desses operadores.

Pesquisa em chinês simplificado e tradicional

O chinês simplificado e o chinês tradicional são duas variantes de escrita da língua chinesa. O mesmo conceito pode ser escrito de maneira diferente em cada variante. Com uma consulta em uma das variantes, o serviço Google WebSearch pode retornar resultados que incluem páginas nas duas variantes.

Para usar esse recurso:

1. Defina o parâmetro de solicitação c2coff como 0
   e
2. Siga uma destas opções:
   • Não defina o parâmetro de solicitação lr
     ou
   • Defina o parâmetro de solicitação lr como lr=lang_zh-TW|lang_zh-CN.

O exemplo a seguir mostra os parâmetros de consulta que você incluiria em uma solicitação de resultados em chinês simplificado e tradicional. Outras informações obrigatórias, como o cliente, não estão incluídas no exemplo.

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

Filtrar resultados

A Pesquisa Google na Web oferece várias maneiras de filtrar os resultados da pesquisa:

• Filtragem automática de resultados da pesquisa
• Filtragem por idioma e país
• Filtrar conteúdo adulto com o SafeSearch

Filtragem automática de resultados da pesquisa

Para oferecer os melhores resultados possíveis, o Google usa duas técnicas para filtrar automaticamente os resultados que geralmente são considerados indesejáveis:

• Conteúdo duplicado: quando vários documentos têm as mesmas informações, apenas o documento mais relevante desse conjunto é incluído nos resultados da pesquisa.

• Host Crowding: se houver muitos resultados de pesquisa do mesmo site, o Google poderá não mostrar todos os resultados ou poderá mostrar os resultados mais abaixo na
  classificação do que eles estariam.

Recomendamos que você deixe esses filtros ativados para solicitações de pesquisa típicas, porque eles melhoram significativamente a qualidade da maioria dos resultados. No entanto, é possível ignorar esses filtros automáticos definindo o parâmetro de consulta filter como 0 na solicitação de pesquisa.

Filtragem por idioma e país

O serviço do Google WebSearch retorna resultados de um índice principal de todos os documentos da Web. O índice principal contém subcoleções de documentos agrupados por atributos específicos, incluindo idioma e país de origem.

Você pode usar os parâmetros de solicitação lr e cr para restringir os resultados da pesquisa a subcoleções de documentos escritos em idiomas específicos ou originários de países específicos, respectivamente.

O Google WebSearch determina o idioma de um documento analisando o seguinte:

• o domínio de nível superior (TLD) do URL do documento
• metatags de idioma no documento
• o idioma principal usado no corpo do texto do documento

Consulte também a definição do parâmetro lr, a seção Pesquisar documentos escritos em idiomas específicos e os Valores da coleção de idiomas que podem ser usados como valores do parâmetro lr para mais informações sobre como restringir os resultados com base no idioma.

O Google WebSearch determina o país de um documento analisando o seguinte:

• o domínio de nível superior (TLD) do URL do documento
• a localização geográfica do endereço IP do servidor da Web

Consulte também a definição do parâmetro cr e os valores da coleção de países que podem ser usados como valores do parâmetro cr para mais informações sobre como restringir os resultados por país de origem.

Observação:é possível combinar valores de idioma e país para personalizar os resultados da pesquisa. Por exemplo, você pode solicitar documentos escritos em francês e provenientes da França ou do Canadá, ou documentos da Holanda que não estejam em inglês. Os parâmetros lr e cr aceitam operadores booleanos.

Filtrar conteúdo adulto com o SafeSearch

Muitos clientes do Google não querem mostrar resultados da pesquisa para sites com conteúdo adulto. Usando nosso filtro do SafeSearch, você pode verificar e eliminar resultados da pesquisa que contenham conteúdo adulto. Os filtros do Google usam tecnologia proprietária para verificar palavras-chave, frases e URLs. Embora nenhum filtro seja 100% preciso, o SafeSearch remove a grande maioria do conteúdo adulto dos resultados da pesquisa.

O Google se esforça para manter o SafeSearch o mais atualizado e abrangente possível rastreando continuamente a Web e incorporando atualizações com base em sugestões dos usuários.

O SafeSearch está disponível nestes idiomas:

É possível ajustar o grau em que o Google filtra seus resultados para conteúdo adulto usando o parâmetro de consulta safe. A tabela a seguir explica as configurações do SafeSearch do Google e como elas afetam os resultados da pesquisa:

Se você ativou o SafeSearch e encontrou sites com conteúdo ofensivo nos resultados, envie o URL do site por e-mail para safesearch@google.com. Vamos investigar o site.

Resultados XML

• DTD de resultados XML do Google
• Sobre a resposta XML
• Resultados XML para consultas de pesquisa regular e avançada
• Pesquisa regular/avançada: exemplo de consulta e resultado em XML
• Pesquisa regular/avançada: tags XML

DTD de resultados XML do Google

O Google usa a mesma DTD para descrever o formato XML de todos os tipos de resultados da pesquisa. Muitas das tags e atributos são aplicáveis a todos os tipos de pesquisa. No entanto, algumas tags são aplicáveis apenas a determinados tipos de pesquisa. Consequentemente, as definições na DTD podem ser menos restritivas do que as apresentadas neste documento.

Este documento descreve os aspectos da DTD relevantes para a pesquisa na Web. Ao analisar a DTD, se você estiver trabalhando na Pesquisa na Web, ignore as tags e os atributos que não estão documentados aqui. Se a definição for diferente entre a DTD e a documentação, isso será indicado neste documento.

O Google pode retornar resultados XML com ou sem uma referência à DTD mais recente. O DTD é um guia para ajudar os administradores de pesquisa e os analisadores XML a entender os resultados XML do Google. Como a gramática XML do Google pode mudar periodicamente, não configure seu analisador para usar a DTD e validar cada resultado XML.

Além disso, não configure seu analisador XML para buscar a DTD sempre que você enviar uma solicitação de pesquisa. O Google atualiza a DTD com pouca frequência, e essas solicitações criam requisitos desnecessários de atraso e largura de banda.

O Google recomenda usar o formato de saída xml_no_dtd para receber resultados em XML. Se você especificar o formato xml output na sua solicitação de pesquisa, a única diferença será a inclusão da seguinte linha nos resultados XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Acesse a DTD mais recente em http://www.google.com/google.dtd.

Nem todos os recursos na DTD estão disponíveis ou são compatíveis no momento.

Sobre a resposta XML

• Todos os valores de elementos são HTML válidos adequados para exibição, a menos que indicado de outra forma nas definições de tag XML.
• Alguns valores de elementos são URLs que precisam ser codificados em HTML antes de serem exibidos.
• Seu analisador XML precisa ignorar atributos e tags não documentados. Isso permite que seu aplicativo continue funcionando sem modificações se o Google adicionar mais recursos à saída XML.
• Alguns caracteres precisam ter escape quando incluídos como valores em tags XML. Seu processador XML precisa converter essas entidades de volta para os caracteres apropriados. Se você não converter as entidades corretamente, o navegador poderá, por exemplo, renderizar o caractere "&" como "&". O padrão XML documenta esses caracteres, que são reproduzidos na tabela abaixo:

  Personagem	Formulários de escape	Entidade	Código de caractere
  E comercial	&	&	&
  Aspas simples	'	'	'
  Aspas duplas	"	"	"
  Maior que	>	>	>
  Menor que	<	&lt;	&#60;

Resultados XML para consultas de pesquisa regular e avançada

Pesquisa comum/avançada: exemplo de consulta e resultado em XML

Esta amostra de solicitação WebSearch pede 10 resultados (num=10) sobre o termo de pesquisa "socer" (q=socer), que é a palavra "soccer" (futebol) escrita incorretamente de propósito para este exemplo.

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

Essa solicitação gera o resultado XML abaixo. Há vários comentários no resultado XML para indicar onde determinadas tags não incluídas no resultado apareceriam.

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

Pesquisa regular/avançada: tags XML

As respostas XML para solicitações de pesquisa regulares e avançadas usam o mesmo conjunto de tags XML. Essas tags XML são mostradas no exemplo acima e explicadas nas tabelas abaixo.

As tags XML abaixo estão listadas em ordem alfabética por nome, e cada definição contém uma descrição da tag, um exemplo de como ela apareceria em um resultado XML e o formato do conteúdo. Se a tag for uma subtag de outra tag XML ou se tiver subtags ou atributos próprios, essas informações também serão fornecidas na tabela de definição da tag.

Alguns símbolos podem aparecer ao lado de algumas subtags nas definições abaixo. Esses símbolos e seus significados são:

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

Resultados XML para consultas de pesquisa de imagens

Esta solicitação de imagem de exemplo pede cinco resultados (num=5) sobre o termo de pesquisa "macaco" (q=macaco).

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

Essa solicitação gera o resultado XML abaixo.

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

Pesquisa de imagens: tags XML

A tabela abaixo mostra outras tags XML usadas em respostas XML para consultas de pesquisa por imagens.

Alguns símbolos podem aparecer ao lado de algumas subtags nas definições abaixo. Esses símbolos e seus significados são: