Referencia de la API de XML

En esta página, se hace referencia a la versión XML de la API de Custom Search JSON, que está disponible solo para los clientes de Google Site Search.

  1. Descripción general
  2. Formato de solicitud del Motor de Búsqueda Programable
    1. Descripción general de la solicitud
    2. Términos de búsqueda
    3. Parámetros de la solicitud
      1. Ejemplos de consultas de WebSearch
      2. Definiciones de los parámetros de búsqueda de WebSearch
      3. Búsqueda avanzada
      4. Parámetros de búsqueda avanzada
      5. Términos de búsqueda especiales
      6. Consultas de imágenes de ejemplo
      7. Parámetros de búsqueda de imágenes
      8. Límites de solicitud
    4. Internacionalización de consultas y presentación de resultados
      1. Codificación de caracteres
      2. Idiomas de interfaz
      3. Búsqueda en chino simplificado y tradicional
    5. Filtrado de resultados
      1. Filtrado automático de los resultados de la búsqueda
      2. Filtros por idioma y país
      3. Cómo filtrar contenido para adultos con SafeSearch
  3. Resultados XML
    1. DTD de resultados XML de Google
    2. Información acerca de la respuesta XML
    3. Resultados XML para consultas de búsqueda normales, de imagen y avanzada
      1. Búsqueda regular y avanzada: consulta de muestra y resultado XML
      2. Búsqueda estándar/avanzada: etiquetas XML
      3. Resultados XML para búsquedas de imágenes
      4. Búsqueda de imágenes: Consulta de muestra y resultado XML
      5. Búsqueda de imágenes: etiquetas XML

Descripción general

El servicio de Google WebSearch permite a los clientes de Google Site Search mostrar resultados de la Búsqueda de Google en sus propios sitios web. El servicio WebSearch usa un protocolo simple basado en HTTP para entregar los resultados de la búsqueda. Los administradores de búsqueda tienen control total sobre la forma en que solicitan resultados de la búsqueda y cómo los presentan al usuario final. En este documento, se describen los detalles técnicos de la solicitud de la Búsqueda de Google y los formatos de resultados.

Para recuperar resultados de Google WebSearch, tu aplicación envía a Google una solicitud HTTP simple. Luego, Google mostrará los resultados de la búsqueda en formato XML. Los resultados con formato XML te permiten personalizar la forma en que se muestran los resultados de la búsqueda.

Formato de solicitud de WebSearch

Descripción general de la solicitud

La solicitud de búsqueda de Google es un comando HTTP GET estándar. Incluye una colección de parámetros relevantes para tus consultas. Estos parámetros se incluyen en la URL de la solicitud como pares nombre=valor separados por caracteres de unión (&). Los parámetros incluyen datos como la búsqueda y un ID de motor único (cx) que identifica el motor que realiza la solicitud HTTP. El servicio WebSearch o Image Search muestra resultados XML en respuesta a tus solicitudes HTTP.

Términos de búsqueda

La mayoría de las solicitudes de búsqueda incluyen uno o más términos de búsqueda. Un término de consulta aparece como el valor de un parámetro en la solicitud de búsqueda.

Los términos de búsqueda pueden especificar varios tipos de información para filtrar y organizar los resultados de la búsqueda que muestra Google. Las consultas pueden especificar lo siguiente:

  • Palabras o frases para incluir o excluir
    • Todas las palabras de una búsqueda (predeterminado)
    • Una frase exacta en la búsqueda
    • Cualquier palabra o frase en una búsqueda
  • En qué parte del documento se deben buscar los términos de búsqueda.
    • En cualquier parte del documento (predeterminado)
    • Solo en el cuerpo del documento
    • Solo en el título del documento
    • Solo en la URL del documento
    • Solo en los vínculos del documento
  • Restricciones en los documentos en sí
    • Incluir o excluir documentos de tipos de archivo específicos (como archivos PDF o documentos de Word)
  • Consultas de URL especiales que muestran información sobre una URL determinada, en lugar de realizar una búsqueda
    • Consultas que muestran información general sobre una URL, como su categoría, fragmento o lenguaje de Open Directory
    • Consultas que muestran el conjunto de páginas web que vinculan a una URL
    • Consultas que muestran un conjunto de páginas web similares a una URL determinada

Búsqueda predeterminada

Los valores de los parámetros de búsqueda deben tener escape de URL. Ten en cuenta que debes sustituir el signo más (“+”) por cualquier secuencia de espacios en blanco en la búsqueda. Esto se analiza más a fondo en la sección Escapado de URL de este documento.

El término de búsqueda se envía al servicio WebSearch mediante el parámetro q. Un término de búsqueda de muestra es el siguiente:

q=horses+cows+pigs

De forma predeterminada, el servicio Google WebSearch solo muestra documentos que incluyan todos los términos en la búsqueda.

Parámetros de la solicitud

En esta sección, se enumeran los parámetros que puedes usar cuando realizas una solicitud de búsqueda. Los parámetros se dividen en dos listas. La primera lista contiene parámetros que son relevantes para todas las solicitudes de búsqueda. La segunda lista contiene parámetros que solo son relevantes para las solicitudes de búsqueda avanzada.

Se requieren tres parámetros de solicitud:

  • El parámetro client se debe establecer en google-csbe
  • El parámetro output especifica el formato de los resultados en formato XML que se muestran. Los resultados se pueden mostrar con (xml) o sin (xml_no_dtd) una referencia al DTD de Google. Te recomendamos establecer este valor en xml_no_dtd. Nota: Si no especificas este parámetro, los resultados se mostrarán en HTML en lugar de XML.
  • El parámetro cx que representa el ID único del motor

Los parámetros de solicitud más usados, distintos de los mencionados anteriormente, son los siguientes:

  • num: La cantidad solicitada de resultados de la búsqueda
  • q: Los términos de búsqueda
  • start: el índice de inicio para los resultados

Ejemplos de consultas de WebSearch

En los siguientes ejemplos, se muestran un par de solicitudes HTTP de WebSearch para ilustrar cómo se usan los diferentes parámetros de consulta. Las definiciones de los diferentes parámetros de búsqueda se proporcionan en las secciones Definiciones de parámetros de consulta de WebSearch y Parámetros de búsqueda de búsqueda avanzada de este documento.

En esta solicitud, se solicitan los primeros 10 resultados (start=0&num=10) para el término de consulta "red sox" (q=red+sox). La consulta también especifica que los resultados deben provenir de sitios web canadienses (cr=countryCA) y deben escribirse en francés (lr=lang_fr). Por último, la consulta especifica valores para los parámetros client, output y cx, los tres son obligatorios.

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

En este ejemplo, se usan algunos de los parámetros de búsqueda avanzada para personalizar aún más la búsqueda. Esta solicitud usa el parámetro as_q (as_q=red+sox) en lugar del parámetro q. También usa el parámetro as_eq para excluir cualquier documento que contenga la palabra "Yankees" de los resultados de la búsqueda (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

Definiciones de los parámetros de consulta de WebSearch

c2coff
Descripción

Opcional: El parámetro c2coff habilita o inhabilita la función de búsqueda en chino simplificado y tradicional.

El valor predeterminado para este parámetro es 0 (cero), lo que significa que la función está habilitada. Los valores del parámetro c2coff son los siguientes:

Valor Acción
1 Inhabilitado
0 Habilitada
Ejemplos q=google&c2coff=1

client
Descripción

Obligatorio: El parámetro client debe establecerse en google-csbe.

Ejemplos q=google&client=google-csbe

cr
Descripción

Opcional: El parámetro cr restringe los resultados de la búsqueda a los documentos que se originan en un país en particular. Puedes usar operadores booleanos en el valor del parámetro cr.

Para determinar el país de un documento, Google WebSearch analiza lo siguiente:

  • El dominio de nivel superior (TLD) de la URL del documento
  • la ubicación geográfica de la dirección IP del servidor web

Consulta la sección Valores del parámetro de país (cr) para obtener una lista de los valores válidos para este parámetro.

Ejemplos q=Frodo&cr=countryNZ

cx
Descripción

Obligatorio: El parámetro cx especifica un código único que identifica un motor de búsqueda personalizado. Debes especificar un Motor de Búsqueda Programable con el parámetro cx para recuperar los resultados de la búsqueda de ese motor.

Para encontrar el valor del parámetro cx, ve a Panel de control > pestaña Códigos de tu motor y lo encontrarás en el área de texto de la sección "Pega este código en la página en la que deseas que aparezca tu cuadro de búsqueda. Los resultados de la búsqueda se mostrarán en una página alojada en Google.

Ejemplos q=Frodo&cx=00255077836266642015:u-scht7a-8i

filter
Descripción

Opcional: El parámetro filter activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta la sección Filtrado automático de este documento para obtener más información acerca de los filtros de resultados de la Búsqueda de Google.

El valor predeterminado del parámetro filter es 1, lo que indica que la función está habilitada. Los valores válidos para este parámetro son los siguientes:

Valor Acción
1 Inhabilitado
0 Habilitada

Nota: De forma predeterminada, Google aplica el filtrado en todos los resultados de la búsqueda para mejorar su calidad.

Ejemplos q=google&filter=0

gl
Descripción

Opcional: El valor del parámetro gl es un código de país de dos letras. En el caso de los resultados de WebSearch, el parámetro gl potencia los resultados de la búsqueda cuyo país de origen coincide con el valor del parámetro. Consulta la sección Códigos de país para obtener una lista de los valores válidos.

Especificar un valor del parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto se aplica en particular a clientes internacionales y, más específicamente, a clientes de países de habla inglesa que no sean Estados Unidos.

Ejemplos

Esta solicitud mejora los documentos escritos en el Reino Unido en los resultados de WebSearch:
q=pizza&gl=uk


hl
Descripción

Opcional: El parámetro hl especifica el idioma de la interfaz (idioma host) de tu interfaz de usuario. Para mejorar el rendimiento y la calidad de los resultados de la búsqueda, te recomendamos que establezcas este parámetro de forma explícita.

Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información y, también, Idiomas de interfaz compatibles para obtener una lista de los idiomas compatibles.

Ejemplos

Esta solicitud se orienta a los anuncios de vino en francés. (Vin es el término francés para el vino).

q=vin&ip=10.10.10.10&ad=w5&hl=fr

hq
Descripción

Opcional: El parámetro hq anexa los términos especificados a la consulta, como si se combinaran con un operador lógico AND.

Ejemplos

Esta solicitud busca "pizza" Y "queso". La expresión es la misma que q=pizza+cheese.

q=pizza&hq=cheese


ie
Descripción

Opcional: El parámetro ie establece el esquema de codificación de caracteres que se debe usar para interpretar la cadena de consulta. El valor predeterminado de ie es latin1.

Consulta la sección Codificación de caracteres para saber cuándo deberías usar este parámetro.

Consulta la sección Esquemas de codificación de caracteres para obtener una lista de valores ie posibles.

Ejemplos q=google&ie=utf8&oe=utf8
lr
Descripción

Opcional: El parámetro lr (restricción de idioma) restringe los resultados de la búsqueda a los documentos escritos en un idioma específico.

Para determinar el idioma de un documento, Google WebSearch analiza lo siguiente:

  • El dominio de nivel superior (TLD) de la URL del documento
  • metaetiquetas de idioma del documento
  • idioma principal utilizado en el cuerpo del texto del documento
  • idiomas secundarios, si los hay, utilizados en el texto del cuerpo del documento

Consulta la sección Valores de la colección de idioma (lr) para obtener una lista de los valores válidos para este parámetro.

Ejemplos q=Frodo&lr=lang_en

num
Descripción

Opcional: El parámetro num identifica la cantidad de resultados de la búsqueda que se mostrarán.

El valor predeterminado de num es 10 y el valor máximo es 20. Si solicitas más de 20 resultados, solo se mostrarán 20.

Nota: Si la cantidad total de resultados de la búsqueda es menor que la cantidad solicitada, se mostrarán todos los resultados de la búsqueda disponibles.

Ejemplos q=google&num=10

oe
Descripción

Opcional: El parámetro oe establece el esquema de codificación de caracteres que se debe usar para decodificar el resultado en formato XML. El valor predeterminado de oe es latin1.

Consulta la sección Codificación de caracteres para saber cuándo deberías usar este parámetro.

Consulta la sección Esquemas de codificación de caracteres para obtener una lista de valores oe posibles.

Ejemplos q=google&ie=utf8&oe=utf8

salida
Descripción

Obligatorio: El parámetro output especifica el formato de los resultados XML. Los únicos valores válidos para este parámetro son xml y xml_no_dtd. En el siguiente gráfico, se explica cómo difieren estos valores de parámetros.

Valor Formato de salida
xml_no_dtd Los resultados XML no incluirán una sentencia !DOCTYPE. (Recomendado)
xml Los resultados XML contendrán una referencia de Google DTD. La segunda línea del resultado identificará el tipo de definición del documento (DTD) que usan los resultados:
    <!DOCTYPE GSP SYSTEM "google.dtd">
Ejemplos output=xml_no_dtd
output=xml

q
Descripción

Opcional: El parámetro q especifica la búsqueda ingresada por el usuario. Aunque este parámetro es opcional, debes especificar un valor para al menos uno de los parámetros de consulta (as_epq, as_lq, as_oq o as_q) para obtener resultados de la búsqueda.

También hay una serie de términos de búsqueda especiales que se pueden usar como parte del valor del parámetro q. Para obtener una lista con sus definiciones, consulta los términos de consulta especiales.

En el panel de control de la Búsqueda de Google, se incluye un informe de las principales búsquedas que se enviaron con el parámetro q.

Nota: El valor especificado para el parámetro q debe tener escape de URL.

Ejemplos q=vacation&as_oq=london+paris

seguro
Descripción

Opcional: El parámetro safe indica cómo se deben filtrar los resultados de la búsqueda por contenido pornográfico y para adultos. El valor predeterminado del parámetro safe es off. Los valores de parámetros válidos son los siguientes:

Valor Acción
off Inhabilitar SafeSearch
medium Habilitar SafeSearch
high Habilita una versión más estricta de SafeSearch

Consulta la sección Cómo filtrar contenido para adultos con SafeSearch para obtener más información acerca de esta función.

Ejemplos q=adult&safe=high

start
Descripción

Opcional: El parámetro start indica el primer resultado coincidente que debe incluirse en los resultados de la búsqueda. El parámetro start usa un índice basado en cero, lo que significa que el primer resultado es 0, el segundo es 1 y así sucesivamente.

El parámetro start funciona junto con el parámetro num para determinar qué resultados de la búsqueda mostrar. Ten en cuenta que no se mostrarán más de 1,000 resultados para cualquier consulta, aunque haya más de 1,000 documentos que coincidan con ella. Por lo tanto, si estableces un inicio en 1,000 o más, no se producirán resultados.

Ejemplos start=10

sort
Descripción

Opcional: El parámetro sort especifica que los resultados se deben ordenar según la expresión especificada. Por ejemplo, ordena por fecha.

Ejemplos

sort=date


UD
Descripción

Opcional: El parámetro ud indica si la respuesta XML debe incluir la URL codificada con IDN para el resultado de la búsqueda. La codificación de IDN (nombre de dominio internacional) permite que los dominios se muestren en idiomas locales, por ejemplo:

http://www.花井鮨.com

Los valores válidos para este parámetro son 1 (predeterminado), lo que significa que el resultado XML debe incluir URLs codificadas con IDN, y 0, lo que significa que el resultado XML no debe incluir URLs codificadas con IDN. Si el parámetro ud se establece en 1, la URL codificada aparecerá en la etiqueta UD en tus resultados XML.

Si el parámetro ud se establece en 0, la URL del ejemplo anterior se mostrará de la siguiente manera:

http://www.xn--elq438j.com.

Nota: Esta es una función beta.

Ejemplos q=google&ud=1

Los parámetros adicionales que se enumeran debajo de la imagen son relevantes para las consultas de búsqueda avanzada. Cuando envías una búsqueda avanzada, los valores de varios parámetros (p.ej., as_eq, as_epq, as_oq, etc.) se incluyen en los términos de consulta para esa búsqueda. En la imagen, se muestra la página de Búsqueda avanzada de Google. En la imagen, el nombre de cada parámetro de búsqueda avanzada se escribe en texto red dentro del campo en la página al que corresponde ese parámetro o junto a él.



Parámetros de búsqueda avanzada

as_dt
Descripción

Opcional: El parámetro as_dt controla si se deben incluir o excluir resultados del sitio que se menciona en el parámetro as_sitesearch. Los valores i y e denotan inclusión y exclusión, respectivamente.

Ejemplos as_dt=i,as_dt=e

as_epq
Descripción

Opcional: El parámetro as_epq identifica una frase que deben contener todos los documentos de los resultados de la búsqueda. También puedes usar el término de consulta de la búsqueda de frase para buscar una frase.

Ejemplos as_epq=abraham+lincoln

as_eq
Descripción

Opcional: El parámetro as_eq identifica una palabra o frase que no debería aparecer en ningún documento de los resultados de la búsqueda. También puedes usar el término de búsqueda excluir para asegurarte de que una palabra o frase específica no aparezca en los documentos de un conjunto de resultados de la búsqueda.

Ejemplos

q=bass&as_eq=music.


as_lq
Descripción

Opcional: El parámetro as_lq especifica que todos los resultados de la búsqueda deben contener un vínculo a una URL en particular. También puedes usar el término link: para este tipo de consulta.

Ejemplos

as_lq=www.google.com


as_nlo
Descripción

Opcional: El parámetro as_nlo especifica el valor de inicio para un rango de búsqueda. Usa as_nlo y as_nhi para agregar un rango de búsqueda inclusivo de as_nlo...as_nhi a la consulta.

Ejemplos

El siguiente comando establece un rango de búsqueda de 5 a 10, inclusive:

as_nlo=5&as_nhi=10

as_nhi
Descripción

Opcional: El parámetro as_nhi especifica el valor final para un rango de búsqueda. Usa as_nlo y as_nhi para agregar un rango de búsqueda inclusivo de as_nlo...as_nhi a la consulta.

Ejemplos

El siguiente comando establece un rango de búsqueda de 5 a 10, inclusive:

as_nlo=5&as_nhi=10

as_oq
Descripción

Opcional: El parámetro as_oq proporciona términos de búsqueda adicionales para buscar en un documento, en el que cada documento de los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda adicionales. También puedes usar el término de consulta booleano O para este tipo de consulta.

Ejemplos

q=vacation&as_oq=London+Paris


as_q
Descripción

Opcional: El parámetro as_q proporciona términos de búsqueda para buscar en un documento. Este parámetro también se usa con frecuencia para permitir que los usuarios especifiquen términos adicionales para buscar en un conjunto de resultados de la búsqueda.

Ejemplos

q=president&as_q=John+Adams


as_qdr
Descripción

Opcional: El parámetro as_qdr solicita resultados de la búsqueda de un período específico (período rápido). Se admiten los siguientes valores:

d[number] solicita resultados de la cantidad especificada de días anteriores.
w[number] solicita resultados de la cantidad especificada de semanas anteriores.
m[number] solicita resultados de la cantidad especificada de meses anteriores.
y[number] solicita resultados de la cantidad especificada de años anteriores.

Ejemplos

En este ejemplo, se solicitan resultados del año pasado:

as_qdr=y

En este ejemplo, se solicitan resultados de los últimos 10 días:

as_qdr=d10

as_sitesearch
Descripción

Opcional: El parámetro as_sitesearch te permite especificar que todos los resultados de la búsqueda deben ser páginas de un sitio determinado. Si configuras el parámetro as_dt, también podrás utilizarlo para excluir páginas de un sitio determinado de tus resultados de búsqueda.

Ejemplos

q=vacation&as_sitesearch=www.google.com


Términos de búsqueda especiales

Google WebSearch permite el uso de varios términos de búsqueda especiales que acceden a funciones adicionales del motor de búsqueda de Google. Estos términos de búsqueda especiales deben incluirse en el valor del parámetro de solicitud q. Al igual que otros términos de búsqueda, los términos de búsqueda especiales deben tener con escape de URL. Un número de los términos de búsqueda especiales contiene dos puntos (:). Este carácter también debe tener escape de URL; su valor de URL de escape es %3A.

Vínculos de retroceso [link:]
Descripción

El término de consulta link: recupera el conjunto de páginas web que vinculan a una URL específica. La búsqueda debe tener el formato link:URL, sin espacios entre el término de búsqueda link: y la URL.

La versión de link: con escape de URL es link%3A.

También puedes usar el parámetro de solicitud as_lq para enviar una solicitud link:.

Nota: No puedes especificar otros términos de consulta cuando usas link:.

Ejemplos

http://www.google.com/search?q=link%3Awww.example.com


Booleano O Búsqueda [ O ]
Descripción

El término de consulta OR recupera documentos que incluyen uno de una serie de términos de consulta (dos o más). Para usar el término de búsqueda OR, debes insertar el término de búsqueda OR, en letras mayúsculas, entre cada término de la serie.

También puedes usar el parámetro de solicitud as_oq para enviar una búsqueda de cualquier término en un conjunto de términos.

Nota: Si una solicitud de búsqueda especifica la consulta "Londres + O+París", los resultados de la búsqueda incluirán documentos que contengan al menos una de esas dos palabras. En algunos casos, los documentos de los resultados de la búsqueda pueden contener ambas palabras.

Ejemplos

Busca Londres o París:

Entrada del usuario:london OR paris Término de búsqueda:q=london+OR+paris

Busca vacaciones y Londres o París:

Término de búsqueda:q=vacation+london+OR+paris

Busca vacaciones y uno de Londres, París o chocolates:

Término de búsqueda:  q=vacation+london+OR+paris+OR+chocolates

Busca vacaciones y chocolates, además de Londres o París, y el peso menor es el de los chocolates:

Término de búsqueda:  q=vacation+london+OR+paris+chocolates

Busca vacaciones, chocolates y flores en documentos que también contengan Londres o París:

Término de búsqueda:  q=vacation+london+OR+paris+chocolates+flowers

Busca vacaciones y uno de Londres o París, y busca uno de chocolates o flores:

Término de búsqueda:  q=vacation+london+OR+paris+chocolates+OR+flowers

Excluir término de consulta [-]
Descripción

El término de consulta de exclusión (-) restringe los resultados de una solicitud de búsqueda específica a los documentos que no contienen una palabra o frase en particular. Para usar el término de búsqueda de exclusión, debes anteponer “-” (un signo menos) a la palabra o frase que se excluirá de los documentos coincidentes.

La versión de - con escape de URL es %2D.

El término de consulta de exclusión es útil cuando un término de búsqueda tiene más de un significado. Por ejemplo, la palabra "bajo" podría mostrar resultados sobre peces o música. Si buscaras documentos sobre los peces, podrías excluir documentos sobre música de los resultados de la búsqueda mediante el uso del término de consulta de exclusión.

También puedes usar el parámetro de solicitud as_eq para excluir de los resultados de la búsqueda los documentos que coincidan con una palabra o frase en particular.

Ejemplos Entrada del usuario: bass -music
Término de búsqueda: q=bass+%2Dmusic

Exclusión de tipo de archivo [ -filetype: ]
Descripción

El término de consulta -filetype: excluye documentos con una extensión de archivo en particular, como ".pdf" o ".doc", de los resultados de la búsqueda. La búsqueda debe tener el formato -filetype:EXTENSION sin espacios entre el término de búsqueda -filetype: y la extensión especificada.

La versión de -filetype: con escape de URL es %2Dfiletype%3A.

Nota: Puedes excluir varios tipos de archivos de los resultados de la búsqueda si agregas más términos -filetype: a tu consulta. Deberías tener un término -filetype: en tu búsqueda por cada extensión de archivo que se deba excluir de los resultados de la búsqueda.

Entre los tipos de archivo que admite Google, se incluyen los siguientes:

  • Formato de documento portátil de Adobe (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (sem. 1, sem. 2, sem. 3, sem. 4, sem. 5, sem., sem., sem.)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (documento)
  • Microsoft Works (sem., wps, wdb)
  • Microsoft Write (escritura)
  • Formato de texto enriquecido (rtf)
  • Flash de ondas de choque (SWF)
  • Texto (ans, txt).

Es posible que se agreguen otros tipos de archivo en el futuro. Puedes encontrar una lista actualizada en las Preguntas frecuentes sobre los tipos de archivos de Google.

Ejemplos

En este ejemplo, se muestran documentos que mencionan “Google”, pero que no son documentos PDF:
q=Google+%2Dfiletype%3Apdf

En este ejemplo, se muestran documentos que mencionan “Google”, pero se excluyen los documentos PDF y de Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


Filtrado del tipo de archivo [ filetype: ]
Descripción

El término de consulta filetype: restringe los resultados de la búsqueda a los documentos con una extensión de archivo específica, como ".pdf" o ".doc". La búsqueda debe tener el formato filetype:EXTENSION sin espacio entre el término de consulta filetype: y la extensión especificada.

La versión de filetype: con escape de URL es filetype%3A.

Puedes restringir los resultados de la búsqueda a los documentos que coincidan con una de varias extensiones de archivo agregando más términos de búsqueda de filetype: a tu consulta. Debes tener un término filetype: en tu consulta por cada extensión de archivo que se incluya en los resultados de la búsqueda. Si hay varios términos de búsqueda filetype:, estos se deben separar con el término de búsqueda OR.

De forma predeterminada, los resultados de la búsqueda incluyen documentos con cualquier extensión de archivo.

Entre los tipos de archivo que admite Google, se incluyen los siguientes:

  • Formato de documento portátil de Adobe (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (sem. 1, sem. 2, sem. 3, sem. 4, sem. 5, sem., sem., sem.)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (documento)
  • Microsoft Works (sem., wps, wdb)
  • Microsoft Write (escritura)
  • Formato de texto enriquecido (rtf)
  • Flash de ondas de choque (SWF)
  • Texto (ans, txt).

Es posible que se agreguen otros tipos de archivo en el futuro. Puedes encontrar una lista actualizada en las Preguntas frecuentes sobre los tipos de archivos de Google.

Ejemplos

En este ejemplo, se muestran documentos PDF que mencionan “Google”:
q=Google+filetype%3Apdf

En este ejemplo, se muestran documentos PDF y de Word que mencionan “Google”:
q=Google+filetype%3Apdf+OR+filetype%3Adoc


Incluir término de consulta [+]
Descripción

El término de búsqueda de inclusión (+) especifica que una palabra o frase debe aparecer en todos los documentos incluidos en los resultados de la búsqueda. Si quieres usar el término de búsqueda "include", debes anteponer la palabra o frase que se debe incluir en todos los resultados de la búsqueda con "+" (un signo más).

La versión de + con escape de URL (un signo más) es %2B.

Antes de identificar los resultados de la búsqueda, debes usar + antes de una palabra común que Google suele descartar.

Ejemplos Entrada del usuario: Star Wars Episode +I
Término de búsqueda: q=Star+Wars+Episode+%2BI

Búsqueda de solo vínculos, todos los términos [ allinlinks: ]
Descripción

El término de búsqueda allinlinks: requiere que los documentos de los resultados de la búsqueda contengan todas las palabras de la búsqueda en los vínculos de URL. La búsqueda debe tener el formato allinlinks: seguido de las palabras incluidas en ella.

Si tu búsqueda incluye el término allinlinks:, Google solo verificará los vínculos de URL de los documentos con las palabras de la búsqueda y ignorará el resto del texto en los documentos, los títulos de los documentos y las URLs de cada documento. Ten en cuenta que la URL del documento es diferente de los vínculos de URL que contiene el documento.

La versión de allinlinks: con escape de URL es allinlinks%3A.

Ejemplos Entrada del usuario:allinlinks: Google search
Término de búsqueda:q=allinlinks%3A+Google+search

Búsqueda de frases
Descripción

El término de consulta de búsqueda de frase (") te permite buscar frases completas encerrando las frases entre comillas o conectándolas con guiones.

La versión de " con escape de URL (una comilla) es %22.

Las búsquedas de frases son particularmente útiles si buscas citas famosas o nombres propios.

También puedes usar el parámetro de solicitud as_epq para enviar una búsqueda de frase.

Ejemplos Entrada del usuario:"Abraham Lincoln"
Término de búsqueda: q=%22Abraham+Lincoln%22

Búsqueda de solo texto, todos los términos [allintext:]
Descripción

El término de consulta allintext: requiere que cada documento de los resultados de la búsqueda contenga todas las palabras de la búsqueda en el cuerpo del documento. La consulta debe tener el formato allintext: seguida de las palabras de tu búsqueda.

Si la búsqueda incluye el término allintext:, Google solo verificará el texto del cuerpo de los documentos con las palabras incluidas en la búsqueda e ignorará los vínculos que aparecen en esos documentos, los títulos de documentos y sus URL.

La versión de allintext: con escape de URL es allintext%3A.

Ejemplos En este ejemplo, se especifica que las palabras “Google” y “búsqueda” deben aparecer en el cuerpo de todos los documentos incluidos en los resultados de la búsqueda:
Entrada del usuario:allintext:Google search
Término de búsqueda:q=allintext%3AGoogle+search

Búsqueda por título, un solo término [intitle:]
Descripción

El término de consulta intitle: restringe los resultados de la búsqueda a los documentos que contienen una palabra específica en el título del documento. La búsqueda debe tener el formato intitle:WORD, sin espacio entre el término de consulta intitle: y la siguiente palabra.

Nota: Puedes especificar más de una palabra que se debe incluir en el título del documento. Para ello, coloca el término de consulta intitle: delante de cada una de esas palabras. También puedes usar el término de consulta allintitle: para especificar que todas las palabras de la búsqueda deben incluirse en los títulos de los documentos que se muestran en los resultados de la búsqueda.

La versión de intitle: con escape de URL es intitle%3A.

Ejemplos

En este ejemplo, se especifica que la palabra "Google" debe aparecer en los títulos de cualquier documento en los resultados de la búsqueda, y la palabra "search" debe aparecer en cualquier lugar de los títulos, las URLs, los vínculos o el texto del cuerpo de esos documentos:
Entrada del usuario:intitle:Google search
Término de la búsqueda:q=intitle%3AGoogle+search


Búsqueda de títulos, todos los términos [allintitle:]
Descripción

El término de consulta allintitle: restringe los resultados de la búsqueda a los documentos que contengan todas las palabras de la consulta en el título del documento. Para utilizar el término de búsqueda allintitle:, incluye "allintitle:" al comienzo de tu búsqueda.

Nota: Escribir allintitle: al principio de una búsqueda equivale a escribir intitle: delante de cada palabra de la búsqueda.

La versión de allintitle: con escape de URL es allintitle%3A.

Ejemplos

En este ejemplo, se especifica que las palabras “Google” y “búsqueda” deben aparecer en los títulos de cualquier documento en los resultados de la búsqueda:
Entrada del usuario: allintitle: Google search
Término de búsqueda: q=allintitle%3A+Google+search


Búsqueda de URL, término único [inurl:]
Descripción

El término de búsqueda inurl: restringe los resultados de la búsqueda a los documentos que contienen una palabra específica en la URL del documento. La búsqueda debe tener el formato inurl:WORD, sin espacio entre el término de consulta inurl: y la siguiente palabra.

El término de consulta inurl: ignora la puntuación y usa solo la primera palabra que sigue al operador inurl:. Puedes especificar más de una palabra que debe incluirse en la URL del documento colocando el término de búsqueda inurl: delante de cada una de esas palabras. También puedes usar el término de consulta allinurl: para especificar que todas las palabras de la búsqueda deben incluirse en las URLs de los documentos que se encuentran en los resultados de la búsqueda.

La versión de inurl: con escape de URL es inurl%3A.

Ejemplos

En este ejemplo, se especifica que la palabra "Google" debe aparecer en las URLs de cualquier documento de los resultados de la búsqueda, y la palabra "search" debe aparecer en cualquier lugar de los títulos, las URLs, los vínculos o el texto del cuerpo de esos documentos:
Entrada del usuario: inurl:Google search
Término de la búsqueda: q=inurl%3AGoogle+search


Búsqueda de URL, todos los términos [allinurl:]
Descripción

El término de consulta allinurl: restringe los resultados de la búsqueda a los documentos que contienen todas las palabras de consulta en la URL del documento. Para usar el término de búsqueda allinurl:, incluye allinurl: al comienzo de tu búsqueda.

El término de consulta allinurl: ignora la puntuación, de modo que solo funciona en palabras, no en componentes de URL. Por ejemplo, allinurl: uk/scotland restringirá los resultados a los documentos que contengan las palabras "uk" y "escocia" en sus URLs, pero no requerirá que esas dos palabras aparezcan en un orden específico ni que estén separadas por una barra diagonal.

La versión de allinurl: con escape de URL es allinurl%3A.

Ejemplos

En este ejemplo, se especifica que las palabras “Google” y “búsqueda” deben aparecer en las URLs de cualquier documento de los resultados de la búsqueda:
Entrada del usuario: allinurl: Google search
Término de la búsqueda: q=allinurl%3A+Google+search



Información del documento web [info:]
Descripción

El término de consulta info: recupera información general sobre una URL, siempre y cuando esta se incluya en el índice de la Búsqueda de Google. La búsqueda debe tener el formato info:URL sin espacio entre el término de consulta info: y la URL.

La versión de info: con escape de URL es info%3A.

Nota: No puedes especificar otros términos de consulta cuando usas info:.

Ejemplos Entrada del usuario: info:www.google.com
Término de búsqueda: q=info%3Awww.google.com

Consultas de imágenes de ejemplo

En los siguientes ejemplos, se muestran un par de solicitudes HTTP de imagen para ilustrar cómo se usan los diferentes parámetros de consulta. Las definiciones de los diferentes parámetros de consulta se proporcionan en las secciones Definiciones de parámetros de consulta de imágenes de este documento.

Esta solicitud solicita los primeros 5 resultados (start=0&num=5) para el término de búsqueda "monkey" (q=monkey), del tipo de archivo .png. Por último, la consulta especifica valores para los parámetros client, output y cx, los tres son obligatorios.

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 búsqueda de imágenes

as_filetype
Descripción

Opcional: Muestra imágenes de un tipo especificado. Los valores permitidos son bmp, gif, png, jpg y svg.

Ejemplos q=google&as_filetype=png

imgsz
Descripción

Opcional: Muestra imágenes de un tamaño especificado, en el que el tamaño puede ser uno de los siguientes:

  • icon (pequeña)
  • small|medium|large|xlarge (mediano)
  • xxlarge (grande)
  • huge (extragrande)

Ejemplos q=google&as_filetype=png&imgsz=icon

imgtype.
Descripción

Opcional: Muestra imágenes de un tipo, que puede ser una de las siguientes opciones:

  • clipart (clipart)
  • face (rostro)
  • lineart (lineal)
  • news (noticias)
  • photo (foto)

Ejemplos q=google&as_filetype=png&imgtype=photo

imgc
Descripción

Opcional: Muestra imágenes en blanco y negro, en escala de grises o en color:

  • mono (blanco y negro)
  • gray (escala de grises)
  • color (color)

Ejemplos q=google&as_filetype=png&imgc=gray

imgcolor
Descripción

Opcional: Muestra imágenes de un color dominante específico:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
Ejemplos q=google&as_filetype=png&imgcolor=yellow

as_rights
Descripción

Opcional: Filtros basados en licencias. Entre los valores admitidos, se incluyen los siguientes:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

Ejemplos q=cats&as_filetype=png&as_rights=cc_attribute

Límites de solicitudes

En el siguiente gráfico, se enumeran las limitaciones para las solicitudes de búsqueda que envías a Google:

Componente Límite Explicación
Longitud de la solicitud de búsqueda 2,048 bytes  
Cantidad de términos de búsqueda 10 Incluye términos en los siguientes parámetros: q, as_epq, as_eq, as_lq, as_oq, as_q.
Cantidad de resultados 20 Si estableces el parámetro num en un número superior a 20, solo se mostrarán 20 resultados. Para obtener más resultados, tendrías que enviar varias solicitudes y aumentar el valor del parámetro start con cada solicitud.

Internacionalización de consultas y presentación de resultados

El servicio Google WebSearch te permite buscar documentos en varios idiomas. Puedes especificar la codificación de caracteres que se debe utilizar para interpretar tu solicitud HTTP y codificar tu respuesta XML (mediante los parámetros de búsqueda ie y oe). También puedes filtrar los resultados para incluir solo los documentos escritos en ciertos idiomas.

En las siguientes secciones, se analizan problemas relacionados con la búsqueda en varios idiomas:

Codificación de caracteres

Los servidores envían datos, como páginas web, a usuarios-agentes, como navegadores, como una secuencia de bytes codificados. Luego, el usuario-agente decodifica los bytes en una secuencia de caracteres. Cuando envías solicitudes al servicio WebSearch, puedes especificar los esquemas de codificación para la búsqueda y la respuesta XML que recibes.

Puedes usar el parámetro de solicitud ie para especificar el mecanismo de codificación de los caracteres en tu solicitud HTTP. También puedes usar el parámetro oe a fin de especificar el esquema de codificación que Google debe usar para codificar tu respuesta XML. Si utilizas un esquema de codificación distinto de ISO-8859-1 (o latin1), asegúrate de especificar los valores correctos para los parámetros ie y oe.

Nota: Si proporcionas la funcionalidad de búsqueda para varios idiomas, te recomendamos que uses el valor de codificación utf8 (UTF-8) para los parámetros ie y oe.

Consulta el apéndice de Esquemas de codificación de caracteres para obtener una lista completa de los valores que puedes utilizar para los parámetros ie y oe.

Para obtener más información general sobre la codificación de caracteres, consulta http://www.w3.org/TR/REC-html40/charset.html.

Idiomas de la interfaz

Puedes usar el parámetro de solicitud hl para identificar el idioma de tu interfaz gráfica. El valor del parámetro hl puede afectar los resultados de la búsqueda con XML, especialmente en las consultas internacionales cuando no se especifica de manera explícita la restricción de idioma (usando el parámetro lr). En esos casos, el parámetro hl puede promover resultados de la búsqueda en el mismo idioma que el idioma de entrada del usuario.

Te sugerimos que configures el parámetro hl de forma explícita en los resultados de la búsqueda para asegurarte de que Google seleccione los resultados de mayor calidad para cada consulta.

Consulta la sección Idiomas de interfaz compatibles a fin de obtener una lista completa de los valores válidos para el parámetro hl.

Búsqueda de documentos escritos en idiomas específicos

Puedes usar el parámetro de solicitud lr para restringir los resultados de la búsqueda a los documentos escritos en un idioma o un conjunto de idiomas en particular.

El parámetro lr admite operadores booleanos para que puedas especificar varios idiomas que se deben incluir (o excluir) de los resultados de la búsqueda.

En los siguientes ejemplos, se muestra cómo puedes usar los operadores booleanos para solicitar documentos en diferentes lenguajes.

Para los documentos escritos en japonés:

lr=lang_jp

Para documentos escritos en italiano o alemán:

lr=lang_it|lang_de

Para los documentos que no están escritos en húngaro ni checo:

lr=(-lang_hu).(-lang_cs)

Consulta la sección Valores de colección de lenguajes para obtener una lista completa de los valores posibles para el parámetro lr y la sección Operadores booleanos para obtener un análisis detallado del uso de estos operadores.

El chino simplificado y el chino tradicional son dos variantes de escritura del idioma chino. El mismo concepto puede escribirse de manera diferente en cada variante. Dada una búsqueda en una de las variantes, el servicio de Google WebSearch puede mostrar resultados que incluyan páginas en ambas variantes.

Para usar esta función, sigue estos pasos:

  1. Establece el parámetro de solicitud c2coff en 0
    y
  2. Realiza una de las siguientes acciones:
    • No establezcas el parámetro de solicitud lr.
      o
    • Establece el parámetro de solicitud lr en lr=lang_zh-TW|lang_zh-CN.

En el siguiente ejemplo, se muestran los parámetros de consulta que incluirías en una solicitud de resultados en chino simplificado y tradicional. (Ten en cuenta que la información adicional requerida, como el cliente, no se incluye en el ejemplo).

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

Filtra los resultados

Google WebSearch ofrece varias formas de filtrar los resultados de la búsqueda:

Filtrado automático de los resultados de la búsqueda

En un esfuerzo por proporcionar los mejores resultados de la búsqueda posible, Google usa dos técnicas para filtrar automáticamente los resultados que, por lo general, se consideran no deseados:

  • Contenido duplicado: Si varios documentos contienen la misma información, solo el documento más relevante de ese conjunto se incluye en los resultados de la búsqueda.

  • Acumulación de hosts: Si hay muchos resultados de la búsqueda del mismo sitio, es posible que Google no muestre todos los resultados de ese sitio o que los muestre en una posición inferior
    en la clasificación que de otra manera.

Te recomendamos que dejes estos filtros activados para las solicitudes de búsqueda típicas, ya que estos mejoran significativamente la calidad de la mayoría de los resultados de la búsqueda. Sin embargo, puedes omitir estos filtros automáticos si configuras el parámetro de consulta filter en 0 en tu solicitud de búsqueda.

Filtros por idioma y país

El servicio Google WebSearch muestra los resultados de un índice principal de todos los documentos web. El índice principal contiene subcolecciones de documentos que se agrupan por atributos específicos, como el idioma y el país de origen.

Puedes usar los parámetros de solicitud lr y cr para restringir los resultados de la búsqueda a subcolecciones de documentos escritos en idiomas específicos o que se originen en países determinados, respectivamente.

Para determinar el idioma de un documento, Google WebSearch analiza lo siguiente:

  • El dominio de nivel superior (TLD) de la URL del documento
  • metaetiquetas de idioma del documento
  • idioma principal utilizado en el cuerpo del texto del documento


Consulta también la definición del parámetro lr, la sección sobre Cómo buscar documentos escritos en idiomas específicos y los Valores de la colección de idiomas que se pueden usar como valores para el parámetro lr a fin de obtener más información sobre cómo restringir los resultados según el idioma.

Para determinar el país de un documento, Google WebSearch analiza lo siguiente:

  • El dominio de nivel superior (TLD) de la URL del documento
  • la ubicación geográfica de la dirección IP del servidor web

Consulta también la definición del parámetro cr y los valores de la colección por país que se pueden usar como valores para el parámetro cr a fin de obtener más información sobre cómo restringir los resultados por país de origen.

Nota: Puedes combinar valores de idioma y valores de país para personalizar tus resultados de la búsqueda. Por ejemplo, puedes solicitar documentos redactados en francés y que provengan de Francia o Canadá, o bien documentos que provengan de Holanda y no estén escritos en inglés. Los parámetros lr y cr admiten operadores booleanos.

Cómo filtrar contenido para adultos con SafeSearch

Muchos clientes de Google no desean mostrar resultados de la búsqueda de sitios con contenido para adultos. Con el filtro SafeSearch, puedes filtrar los resultados de la búsqueda que incluyan contenido para adultos y eliminarlos. Los filtros de Google usan tecnología propia para verificar palabras clave, frases y URL. Si bien ningún filtro es 100 por ciento preciso, SafeSearch quitará la mayor parte del contenido para adultos de los resultados de la búsqueda.

Google se esfuerza por mantener SafeSearch lo más actualizado y completo posible rastreando continuamente la Web e incorporando actualizaciones de las sugerencias de los usuarios.

SafeSearch está disponible en los siguientes idiomas:

Neerlandés
Inglés
Francés
Alemán
Italiano
Portugués (Brasil)
Español
Chino tradicional

Puedes ajustar el grado en el que Google filtra los resultados por el contenido para adultos mediante el parámetro de búsqueda safe. En la siguiente tabla, se explica la configuración de SafeSearch de Google y la manera en la que afectará los resultados de la búsqueda:

Nivel de SafeSearch Descripción
high Habilita una versión más estricta de búsqueda segura.
medium Bloquea las páginas web que contengan pornografía y otro contenido sexual explícito.
desactivado No filtra el contenido para adultos de los resultados de la búsqueda.

* La configuración predeterminada de SafeSearch está desactivada.

Si SafeSearch está activado y encuentras sitios que incluyen contenido ofensivo en los resultados, envía un correo electrónico con la URL del sitio a safesearch@google.com para que lo investiguemos.

Resultados XML

DTD de resultados XML de Google

Google usa el mismo DTD para describir el formato XML para todos los tipos de resultados de la búsqueda. Muchos de los atributos y las etiquetas se aplican a todos los tipos de búsqueda. Sin embargo, algunas etiquetas solo se aplican a determinados tipos de búsqueda. Por lo tanto, las definiciones en la DTD pueden ser menos restrictivas que las que se proporcionan en este documento.

En este documento, se describen los aspectos de la DTD que son relevantes para WebSearch. Cuando observas la DTD, si trabajas en WebSearch, puedes ignorar de forma segura las etiquetas y los atributos que no están documentados aquí. Si la definición difiere entre la DTD y la documentación, se indica ese hecho en este documento.

Google puede mostrar los resultados en formato XML con o sin una referencia al DTD más reciente. La DTD es una guía para ayudar a los administradores de búsqueda y los analizadores de XML a comprender los resultados de XML de Google. Dado que la gramática XML de Google puede cambiar de vez en cuando, no debes configurar el analizador para que use el DTD a fin de validar cada resultado XML.

Además, no debes configurar el analizador de XML para recuperar el DTD cada vez que envíes una solicitud de búsqueda. Google actualiza el DTD con poca frecuencia, y estas solicitudes crean requisitos de retraso y ancho de banda innecesarios.

Google recomienda que uses el formato de salida xml_no_dtd para obtener resultados XML. Si especificas el formato de salida xml en tu solicitud de búsqueda, la única diferencia es la inclusión de la siguiente línea en los resultados XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

Puedes acceder a la versión más reciente de DTD en http://www.google.com/google.dtd.

Ten en cuenta que es posible que no todas las funciones de DTD estén disponibles o sean compatibles en este momento.

Información acerca de la respuesta XML

  • Todos los valores de elementos son HTML válido adecuado para la visualización, a menos que se indique lo contrario en las definiciones de la etiqueta XML.
  • Algunos valores de elementos son URLs que deben estar codificadas en HTML antes de mostrarse.
  • El analizador XML debe ignorar los atributos y las etiquetas no documentados. Esto permite que tu aplicación continúe funcionando sin modificaciones si Google agrega más funciones al resultado XML.
  • Algunos caracteres deben tener escape cuando se incluyen como valores en las etiquetas XML. Tu procesador XML debe volver a convertir estas entidades en los caracteres correspondientes. Si no conviertes entidades correctamente, es posible que el navegador muestre el carácter & como "&amp;", por ejemplo. El XML estándar documenta estos caracteres y se reproducen en la tabla que aparece a continuación:

    “Basado Formas con escape Entidad Código de carácter
    Et y &amp; &#38;
    Comillas simples ' &apos; &#39;
    Comillas dobles " &quot; &#34;
    Mayor que > &gt; &#62;
    Menor que < &lt; &#60;

Resultados XML para búsquedas regulares y avanzadas

Búsqueda regular o avanzada: consulta de muestra y resultado XML

En esta solicitud de WebSearch de ejemplo, se solicitan 10 resultados (num=10) sobre el término de búsqueda "socer" (q=socer), que es la palabra "fútbol" que se escribió mal en este ejemplo).

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

Esta solicitud muestra el siguiente resultado XML. Ten en cuenta que hay varios comentarios en el resultado XML para indicar dónde aparecerían ciertas etiquetas no incluidas en el resultado.

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

Búsqueda estándar/avanzada: etiquetas XML

Tanto las respuestas XML para las solicitudes de búsqueda normales como las de búsqueda avanzada usan el mismo conjunto de etiquetas XML. Estas etiquetas XML se muestran en el ejemplo de XML anterior y se explican en las tablas que aparecen a continuación.

Las etiquetas XML que aparecen a continuación se enumeran alfabéticamente por nombre de etiqueta, y cada definición contiene una descripción de la etiqueta, un ejemplo que muestra cómo aparecería en un resultado XML y el formato de su contenido. Si la etiqueta es una subetiqueta de otra etiqueta XML, o si tiene subetiquetas o atributos propios, esa información también se proporciona en la tabla de definición de la etiqueta.

Es posible que se muestren símbolos al lado de algunas subetiquetas en las definiciones que aparecen a continuación. Estos son los símbolos y sus respectivos significados:

? = subetiqueta opcional
* = cero o más instancias de la subetiqueta
+ = una o más instancias de la subetiqueta
A B C D V G C I I L N P R S T U X

anchor_text
Definición

La etiqueta <anchor_text> especifica el texto que debes mostrar a los usuarios para identificar una etiqueta de perfeccionamiento asociada con un conjunto de resultados de la búsqueda. Debido a que las etiquetas de perfeccionamiento reemplazan los caracteres no alfanuméricos con guiones bajos, no debes mostrar el valor de la etiqueta <label> en la interfaz de usuario. En su lugar, debes mostrar el valor de la etiqueta <anchor_text>.

Ejemplo <anchor_text>campos de golf</anchor_text>
Subetiqueta de FacetItem
Formato del Contenido Texto

BLOQUEAR
Definición

Esta etiqueta encapsula el contenido de un bloque en la línea de cuerpo de un resultado de promoción. Cada bloque tiene las subetiquetas T, U y L. Una etiqueta T no vacía indica que el bloque contiene texto; las etiquetas U y L no vacías indican que el bloque contiene un vínculo (con la URL proporcionada en la subetiqueta U y el texto de anclaje en la subetiqueta L).

Subetiquetas T, U y L
Subetiqueta de BODY_LINE
Formato del Contenido Vacía

BODY_LINE
Definición

Esta etiqueta encapsula el contenido de una línea en el cuerpo del resultado promocionado. Cada línea de cuerpo consta de varias etiquetas BLOQUEAR, que contienen texto o un vínculo con una URL y texto de hipervínculo.

Subetiquetas BLOQUEAR*
Subetiqueta de SL_MAIN
Formato del Contenido Vacía

C
Definición

La etiqueta <C> indica que el servicio WebSearch puede recuperar una versión almacenada en caché de esta URL de resultados de la búsqueda. No puedes recuperar páginas almacenadas en caché a través de la API de XML, pero puedes redireccionar a los usuarios a www.google.com para este contenido.

Attributes
Nombre Formato Descripción
SZ Texto (Número entero + “k”) Proporciona el tamaño de la versión almacenada en caché del resultado de la búsqueda, en kilobytes ("k").
Daño causado por el cliente Texto Identifica un documento en la caché de Google. Para recuperar el documento de la caché, envía un término de búsqueda compilado de la siguiente manera:
cache:CIDtext:escapedURL

La URL con escape está disponible en la etiqueta UE.

Ejemplo <C SZ="6,000" CID="kvOXK_cYSSgJ" />
Subetiqueta de HAS
Formato del Contenido Vacía

C2C
Definición La etiqueta <C2C> indica que el resultado hace referencia a una página en chino tradicional. Esta etiqueta solo aparece cuando la búsqueda en chino simplificado y tradicional está habilitada. Consulta la definición del parámetro de consulta c2coff para obtener más información sobre cómo habilitar o inhabilitar esta función.
Formato del Contenido Texto

Contexto
Definición

La etiqueta <Context> encapsula una lista de etiquetas de perfeccionamiento asociadas con un conjunto de resultados de la búsqueda.

Ejemplo <Context>
Subetiquetas title, Facet+
Formato del Contenido Contenedor

FECHA DE CRAWL
Definición

La etiqueta <CRAWLDATE> identifica la fecha en la que se rastreó por última vez la página. No se muestra CRAWLDATE para todas las páginas de resultados de búsqueda.

Ejemplo <CRAWLDATE>21 de mayo de 2005</CRAWLDATE>
Subetiqueta de R
Formato del Contenido Texto

DI
Definición

La etiqueta <DI> encapsula la información de categoría del Proyecto de directorio abierto (ODP) para un solo resultado de la búsqueda.

Ejemplo <DI>
Subetiquetas ¿DT?, ¿DS?
Subetiqueta de HAS
Formato del Contenido Vacía

DS
Definición

La etiqueta <DS> proporciona el resumen correspondiente a una sola categoría en el directorio de ODP.

Ejemplo <DS>Publica tu currículo de &lt;b&gt;fútbol&lt;/b&gt; directamente en Internet.</DS>
Subetiqueta de DI
Formato del Contenido Texto (puede contener HTML)

DT
Definición

La etiqueta <DT> proporciona el título de una sola categoría que aparece en el directorio de ODP.

Ejemplo <DT>SoccerConnection.net</DT>
Subetiqueta de DI
Formato del Contenido Texto (puede contener HTML)

Faceta
Definición

La etiqueta <Facet> contiene una agrupación lógica de etiquetas <FacetItem>. Puedes crear estas agrupaciones con el formato de especificación XML de Motor de Búsqueda Programable. Si no creas estas agrupaciones, la etiqueta results_xml_tag_Context><Context> contendrá hasta cuatro etiquetas <Facet>. Los elementos dentro de cada etiqueta <Facet> se agruparán con fines de visualización, pero es posible que no tengan una relación lógica.

Ejemplo <Facet>
Subetiquetas FacetItem+, título+
Subetiqueta de Contexto
Formato del Contenido Contenedor

FacetItem
Definición

La etiqueta <FacetItem> contiene información sobre una etiqueta de perfeccionamiento asociada con un conjunto de resultados de la búsqueda.

Ejemplo <FacetItem>
Subetiquetas etiqueta, anchor_text+
Subetiqueta de Faceta
Formato del Contenido FacetItem

FI
Definición La etiqueta <FI> sirve como una marca que indica si se aplicó el filtrado de documentos para la búsqueda. Consulta la sección Filtrado automático de este documento para obtener más información acerca de los filtros de los resultados de la Búsqueda de Google.
Ejemplo <FI />
Subetiqueta de RES
Formato del Contenido Vacía

PPG
Definición

La etiqueta <GSP> encapsula todos los datos que se muestran en los resultados de la búsqueda XML de Google. "GSP" es una abreviatura de "Protocolo de Búsqueda de Google".

Attributes
Nombre Formato Descripción
VER Texto (número entero) El atributo VER especifica la versión de los resultados de la búsqueda. La versión de salida actual es "3.2".
Ejemplo <GSP VER="3.2">
Subetiquetas PARAM+, Q, RES?, TM
Formato del Contenido Vacía

HAS
Definición La etiqueta <HAS> contiene información sobre cualquier parámetro de solicitud de búsqueda especial admitido para una URL en particular.

Nota: La definición de <HAS> para WebSearch es más restrictiva que en la DTD.

Subetiquetas DI?, L?, C?, RT?
Subetiqueta de R

ISURL
Definición Google muestra la etiqueta <ISURL> si la búsqueda asociada es una URL.
Subetiqueta de GSP
Formato del Contenido Vacía

L
Definición La presencia de la etiqueta <L> indica que el servicio WebSearch puede encontrar otros sitios vinculados a esta URL de resultados de la búsqueda. Para encontrar ese tipo de sitios, utiliza el término de búsqueda especial link:.
Subetiqueta de HAS
Formato del Contenido Vacía

etiqueta
Definición

La etiqueta <label> especifica una etiqueta de perfeccionamiento que puedes usar para filtrar los resultados de la búsqueda que recibes. Para usar una etiqueta de perfeccionamiento, agrega la string more:[[label tag value]] al valor del parámetro q en tu solicitud HTTP a Google, como se muestra en el siguiente ejemplo. Ten en cuenta que este valor debe tener escape de URL antes de enviar la consulta a Google.

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

Nota: La etiqueta <label> no es lo mismo que la etiqueta <Label>, la cual identifica una etiqueta de perfeccionamiento asociada con una URL específica en los resultados de la búsqueda.

Ejemplo <label>campos_golf</label>
Subetiqueta de FacetItem
Formato del Contenido Texto

LANG
Definición

La etiqueta <LANG> contiene el criterio más preciso de Google del idioma del resultado de la búsqueda.

Ejemplo <LANG>en</LANG>
Subetiqueta de R
Formato del Contenido Texto

M
Definición

La etiqueta <M> identifica la cantidad total estimada de resultados para la búsqueda.

Nota: Es posible que esta estimación no sea precisa.

Ejemplo <M>16200000</M>
Subetiqueta de RES
Formato del Contenido Texto

Recién nacido
Definición

La etiqueta <NB> contiene información de navegación (vínculos a la página siguiente de los resultados de la búsqueda o a la página anterior de los resultados de la búsqueda) para el conjunto de resultados.

Nota: Esta etiqueta solo está presente si hay más resultados disponibles.

Ejemplo <NB>
Subetiquetas NU?, PU?
Subetiqueta de RES
Formato del Contenido Vacía

NU
Definición

La etiqueta <NU> contiene un vínculo relativo a la siguiente página de resultados de la búsqueda.

Ejemplo <NU>/search?q=flowers&num=10&hl=es-419&ie=UTF-8
&output=xml&client=test&start=10</NU>
Subetiqueta de Nota:
Formato del Contenido Texto (URL relativa)

PARÁMETRO
Definición

La etiqueta <PARAM> identifica un parámetro de entrada enviado en la solicitud HTTP asociada con el resultado en formato XML. La información sobre el parámetro está incluida en los atributos de la etiqueta (name, value, original_value) y habrá una etiqueta PARAM por cada parámetro enviado en la solicitud HTTP.

Attributes
Nombre Formato Descripción
name Texto Es el nombre del parámetro de entrada.
value HTML Es la versión en formato HTML del valor del parámetro de entrada.
original_value Texto Es la versión original con escape de URL del valor del parámetro de entrada.
Ejemplo <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
Subetiqueta de GSP
Formato del Contenido Complejo

PU
Definición

La etiqueta <PU> proporciona un vínculo relativo a la página anterior de los resultados de la búsqueda.

Ejemplo <PU>/search?q=flowers&num=10&hl=es-419&output=xml
&client=test&start=10</PU>
Subetiqueta de Nota:
Formato del Contenido Texto (URL relativa)

P.
Definición

La etiqueta <Q> identifica la búsqueda enviada en la solicitud HTTP asociada con el resultado XML.

Ejemplo

<Q>pizza</Q>

Subetiqueta de GSP
Formato del Contenido Texto

R
Definición

La etiqueta <R> encapsula los detalles de un resultado de la búsqueda individual.

Nota: La definición de la etiqueta <R> para WebSearch es más restrictiva que en la DTD.

Attributes
Nombre Formato Descripción
N Texto (número entero) Indica el índice (basado en 1) de este resultado de la búsqueda.
MIME Texto Indica el tipo de MIME del resultado de la búsqueda.
Subetiquetas U, UE, T?, FECHA.CRAWLDATE, ¿V?, ¿LANG?, HAS
Subetiqueta de RES

RESPONDER
Definición

La etiqueta <RES> encapsula el conjunto de resultados de la búsqueda individuales y detalles acerca de esos resultados.

Attributes
Nombre Formato Descripción
SN Texto (número entero) Indica el índice (basado en 1) del primer resultado de la búsqueda que se muestra en este conjunto de resultados.
ES-419 Texto (número entero) Indica el índice (basado en 1) del último resultado de la búsqueda que se mostró en este conjunto de resultados.
Ejemplo <RES SN="1" EN="10">
Subetiquetas ¿M, FI?, XT?, NB?: R*
Subetiqueta de GSP
Formato del Contenido Vacía

S
Definición

La etiqueta <S> contiene un extracto de un resultado de la búsqueda que muestra los términos de búsqueda resaltados en negrita. Los saltos de línea se incluyen en el extracto para ajustar el texto correctamente.

Ejemplo <S>Washington (CNN): una oferta para poner fin al conflicto para el Senado ante las elecciones judiciales del presidente &lt;b&gt;Bush&lt;/b&gt; permitiría que cinco nominados avanzaran a una votación final y, a la vez, preservara los
Subetiqueta de R
Formato del Contenido Texto (HTML)

SL_MAIN
Definición

Esta etiqueta encapsula el contenido de un resultado de promoción. Se usa para analizar promociones. El texto de anclaje y la URL del vínculo de título se incluyen en las subetiquetas T y U, respectivamente. Las líneas de texto del cuerpo y los vínculos se incluyen en las subetiquetas BODY_LINE.

Subetiquetas BODY_LINE*, T y U
Subetiqueta de SL_RESULTS
Formato del Contenido Vacía

SL_RESULTS
Definición

Etiqueta de contenedor para los resultados promocionados. Una de ellas aparecerá cada vez que tengas una promoción en los resultados de la búsqueda. La subetiqueta SL_MAIN contiene los datos del resultado principal.

Subetiquetas SL_MAIN*
Subetiqueta de R
Formato del Contenido Vacía

Ortografía
Definición

La etiqueta <Spelling> contiene una sugerencia ortográfica alternativa para la consulta enviada. Esta etiqueta solo aparece en la primera página de los resultados de la búsqueda. Las sugerencias ortográficas están disponibles en inglés, chino, japonés y coreano.

Nota: Google solo mostrará sugerencias ortográficas para las consultas en las que el valor del parámetro gl esté en letras minúsculas.

Ejemplo <Spelling>
Subetiquetas Sugerencia
Subetiqueta de GSP
Formato del Contenido Vacía

Sugerencia
Definición La etiqueta <Suggestion> contiene una sugerencia ortográfica alternativa para la consulta enviada. Puedes usar el contenido de la etiqueta para sugerirle una ortografía alternativa a tu usuario de búsqueda. El valor del atributo q es la sugerencia de ortografía con caracteres de escape de URL que puedes usar como término de consulta.
Attributes
Nombre Formato Descripción
q Texto El atributo q especifica la versión con escape de URL de la sugerencia ortográfica.
Ejemplo <suggestion q="soccer">&lt;b&gt;&lt;i&gt;fútbol&lt;/i&gt;&lt;/b&gt;</Suggestion>
Subetiqueta de Ortografía
Formato del Contenido Texto (HTML)

T
Definición La etiqueta <T> contiene el título del resultado.
Ejemplo <T>Amici's East Coast Pizzeria</T>
Subetiqueta de R
Formato del Contenido Texto (HTML)

título
Definición

Como elemento secundario de <Context>, la etiqueta <title> contiene el nombre de tu Motor de Búsqueda Programable.

Como elemento secundario de <Facet>, la etiqueta <title> proporciona un título para un conjunto de facetas.

Ejemplo

Como hijo de <Context>: <title>Mi motor de búsqueda</title>

Como hijo de <Facet>: <title>facet title</title>

Subetiqueta de Contexto, Facet
Formato del Contenido Texto

TM
Definición

La etiqueta <TM> identifica el tiempo total del servidor que se necesita para mostrar los resultados de la búsqueda, medido en segundos.

Ejemplo <TM>0.100445</TM>
Subetiqueta de GSP
Formato del Contenido Texto (número de punto flotante)

TT
Definición La etiqueta <TT> proporciona una sugerencia para la búsqueda.
Ejemplo <TT>&lt;i&gt;Sugerencia: En la mayoría de los navegadores, si presionas la tecla Intro, obtendrás los mismos resultados que si haces clic en el botón Buscar.&lt;/i&gt;</TT>
Subetiqueta de GSP

U
Definición La etiqueta <U> proporciona la URL del resultado de la búsqueda.
Ejemplo <U>http://www.dominos.com/</U>
Subetiqueta de R
Formato del Contenido Texto (URL absoluta)

UD
Definición

La etiqueta <UD> proporciona la URL (nombre de dominio internacional) codificada con IDN para el resultado de la búsqueda. El valor permite que los dominios se muestren en idiomas locales. Por ejemplo, la URL codificada con IDN http://www.%E8%8A%B1%E4%BA%95.com se puede decodificar y mostrar como http://www.花社鮨.com. La etiqueta <UD> solo se incluirá en los resultados de la búsqueda de las solicitudes que incluían el parámetro ud.

Nota: Esta es una función beta.

Ejemplo <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
Subetiqueta de R
Formato del Contenido Texto (URL con codificación de IDN)

UE
Definición La etiqueta <UE> proporciona la URL del resultado de la búsqueda. El valor tiene escape de URL, de modo que sea adecuado para pasarlo como un parámetro de consulta en una URL.
Ejemplo <UE>http://www.dominos.com/</UE>
Subetiqueta de R
Formato del Contenido Texto (URL con escape de URL)

XT
Definición La etiqueta <XT> indica que el número total estimado de resultados, como lo especifica la etiqueta M, en realidad representa la cantidad total exacta de resultados. Consulta la sección Filtrado automático de este documento para obtener más detalles.
Ejemplo <XT
Subetiqueta de RES
Formato del Contenido Vacía


Resultados XML para las búsquedas de imágenes

En esta solicitud de imagen de ejemplo, se solicitan 5 resultados (num=5) sobre el término de búsqueda "mono" (q=mono).

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

Esta solicitud muestra el siguiente resultado 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>

Búsqueda de imágenes: etiquetas XML

En la siguiente tabla, se muestran etiquetas XML adicionales que se usan en las respuestas XML para búsquedas de imágenes.

Es posible que se muestren símbolos al lado de algunas subetiquetas en las definiciones que aparecen a continuación. Estos son los símbolos y sus respectivos significados:

? = subetiqueta opcional
* = cero o más instancias de la subetiqueta
+ = una o más instancias de la subetiqueta

RG
Definición

La etiqueta <RG> incluye los detalles de un resultado individual de la búsqueda de imágenes.

Attributes
Nombre Formato Descripción
N Texto (número entero) Indica el índice (basado en 1) de este resultado de la búsqueda.
MIME Texto Indica el tipo de MIME del resultado de la búsqueda.
Subetiqueta de RES
RU
Definición

La etiqueta <RU tag> incluye los detalles de cada resultado de la búsqueda de imágenes.

Subetiqueta de R