Se usó la API de Cloud Translation para traducir esta página.

Referencia de la API de XML

Esta página hace referencia a la versión XML de la API de Custom Search JSON, que solo está disponible para Clientes de Google Site Search.

Descripción general
Formato de solicitud de Motor de Búsqueda Programable
Resultados de XML

Descripción general

El servicio Google WebSearch habilita Google Site Search mostrar los resultados de la búsqueda con Google en sus propios sitios web. El El servicio WebSearch usa un protocolo simple basado en HTTP para entregar resultados. Los administradores de búsqueda tienen control total solicitar resultados de búsqueda y la forma en que presentan esos resultados a los usuario final. En este documento, se describen los detalles técnicos de la API de Google formatos de solicitudes de búsqueda y resultados.

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

Formato de solicitud de WebSearch

Solicitar Descripción general
Términos de la búsqueda
Parámetros de la solicitud
Consultas de WebSearch de muestra
Consulta de WebSearch Definiciones de parámetros
Consultas de imágenes de muestra
Búsqueda de imágenes Definiciones de parámetros
Búsqueda avanzada
Búsqueda avanzada Parámetros de consulta
Términos de Consulta Especial
Límites de solicitudes

Descripción general de la solicitud

La solicitud de Búsqueda de Google es un comando HTTP GET estándar. Integra incluye una colección de parámetros relevantes para tu para tus consultas. Estos parámetros se incluyen en la URL de la solicitud como name=value de pares separados por caracteres et (&). Los parámetros incluyen datos, como la búsqueda y un ID único de motor (cx) que identifica la que realiza la solicitud HTTP. El servicio de búsqueda de imágenes o WebSearch 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 consulta pueden especificar varios tipos de información para filtrar y organizar los resultados de búsqueda que muestra Google. Las consultas pueden especificar lo siguiente:

Palabras o frases para incluir o excluir
- Todas las palabras en una búsqueda (predeterminado)
- Una frase exacta en la búsqueda
- Cualquier palabra o frase en una búsqueda
En qué parte de un documento busques términos de búsqueda
- En cualquier parte del documento (configuración predeterminada)
- 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
- Incluir o excluir documentos de tipos de archivos particulares (como archivos PDF o documentos de Word)
Consultas de URL especiales que devuelven información sobre una URL determinada, en lugar de realizar una búsqueda
- Consultas que muestran información general sobre una URL, como la categoría, el fragmento o el lenguaje de Open Directory
- Consultas que muestran el conjunto de páginas web que se vinculan a una URL
- Búsquedas 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 contener URL. Ten en cuenta que reemplazaría el signo más ("+") por cualquier secuencia de espacios en blanco en la búsqueda. Este tema se analiza con más detalle en la sección Escapa de URLs de este documento.

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

q=horses+cows+pigs

De forma predeterminada, el servicio Google WebSearch solo devuelve documentos que incluir todos los términos en la consulta de búsqueda.

Parámetros de la solicitud

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

Se requieren tres parámetros de solicitud:

El parámetro client debe establecerse en google-csbe
El parámetro output especifica la formato de los resultados XML devueltos Los resultados se pueden devolver con (xml). o sin (xml_no_dtd) una referencia al DTD de Google. Recomendaciones estableciendo 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 la clave Es el ID del motor.

Los parámetros de solicitud más usados, además de los que mencionadas 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 de los resultados

Consultas de WebSearch de muestra

Los siguientes ejemplos muestran algunas solicitudes HTTP de WebSearch para ilustraremos cómo se usan los diferentes parámetros de consulta. Definiciones de se proporcionan diferentes parámetros de consulta en la consulta de WebSearch. Definiciones de parámetros y Consulta de búsqueda avanzada Parámetros de este documento.

Esta solicitud solicita los primeros 10 resultados (start=0&num=10) del término de búsqueda “sox rojos” (q=red+sox) La consulta también especifica que los resultados deben provenir de sitios web de Canadá (cr=countryCA) y debe estar escrita en francés (lr=lang_fr). Por último, la consulta especifica valores para los valores de client, output y cx, los tres de los cuales 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 algunas de las consultas de búsqueda avanzada parámetros para personalizar aún más la búsqueda. Esta solicitud usa el argumento as_q parámetro (as_q=red+sox) en lugar del parámetro q. También usa la el parámetro as_eq para excluir los documentos que contengan la palabra "Yankees" de la 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 el parámetro Simplificado y chino tradicional de la Búsqueda.

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

cliente
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 un país determinado. Puedes usar Booleano operadores en la columna `cr` valor. Google WebSearch determina el país de un documento mediante analizando: 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 Parámetro País (cr) Valores para obtener una lista de valores válidos para este parámetro.
Ejemplos	`q=Frodo&cr=countryNZ`

Descripción

Opcional. El parámetro cr restringe los resultados de la búsqueda a los documentos que se originan en un un país determinado. Puedes usar Booleano operadores en la columna cr valor.

Google WebSearch determina el país de un documento mediante analizando:

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 Parámetro País (cr) Valores para obtener una lista de valores válidos para este parámetro.

Ejemplos q=Frodo&cr=countryNZ

cx
Descripción	Obligatorio. El parámetro `cx` especifica un código que identifica un segmento de búsqueda de Google. Debes especificar un Motor de Búsqueda Programable con el parámetro `cx` para recuperar resultados de la búsqueda de ese motor. Para encontrar el valor del parámetro `cx`, ve a Panel de control > Códigos de tu motor y la encontrarás en el área de texto debajo de "Pega este código en la página donde quieras que el cuadro de búsqueda para que aparezca la opción. Los resultados de la búsqueda se mostrarán en una página alojada en Google".
Ejemplos	`q=Frodo&cx=00255077836266642015:u-scht7a-8i`

Descripción

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

Para encontrar el valor del parámetro cx, ve a Panel de control > Códigos de tu motor y la encontrarás en el área de texto debajo de "Pega este código en la página donde quieras que el cuadro de búsqueda para que aparezca la opción. 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 Filtros automáticos para obtener más información sobre los filtros de resultados de búsqueda de Google.

El valor predeterminado para el parámetro filter es 1. lo que indica que la función está habilitada. Valores válidos para este de rendimiento son las siguientes:

Valor	Acción
1	Inhabilitado
0	Habilitada

Nota: De forma predeterminada, Google aplica filtros a todos los resultados de la búsqueda para mejorar la calidad de esos resultados.

Ejemplos q=google&filter=0

gl
Descripción	Opcional. El valor del parámetro `gl` es un el código de país de dos letras. En 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. Consulte la sección Códigos de país para obtener una lista de los valores válidos. Especifica un valor de parámetro `gl` en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto es particularmente relevante para los clientes internacionales y, aún más específicamente, para 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 Resultados de WebSearch: `q=pizza&gl=uk`

Descripción

Opcional. El valor del parámetro gl es un el código de país de dos letras. En 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. Consulte la sección Códigos de país para obtener una lista de los valores válidos.

Especifica un valor de parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto es particularmente relevante para los clientes internacionales y, aún más específicamente, para 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 Resultados de WebSearch:
q=pizza&gl=uk

hl
Descripción	Opcional. El parámetro `hl` especifica la el idioma de la interfaz de usuario (idioma del host) de tu interfaz de usuario. Para mejorar el rendimiento y la calidad de los resultados de la búsqueda, se recomienda configurar este parámetro de forma explícita. Consulta la sección Idiomas de la interfaz del documento Internacionalización de consultas. y Presentación de resultados para obtener más información y los idiomas de interfaz compatibles para obtener una lista de los idiomas compatibles.
Ejemplos	Esta solicitud se orienta a anuncios de vino en francés. (El Vin es el término francés para referirse al vino). `q=vin&ip=10.10.10.10&ad=w5&hl=fr`

Descripción

Opcional. El parámetro hl especifica la el idioma de la interfaz de usuario (idioma del host) de tu interfaz de usuario. Para mejorar el rendimiento y la calidad de los resultados de la búsqueda, se recomienda configurar este parámetro de forma explícita.

Consulta la sección Idiomas de la interfaz del documento Internacionalización de consultas. y Presentación de resultados para obtener más información y los idiomas de interfaz compatibles para obtener una lista de los idiomas compatibles.

Ejemplos

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

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

hq
Descripción	Opcional. El parámetro `hq` agrega los términos de consulta 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`

Descripción

Opcional. El parámetro hq agrega los términos de consulta 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 carácter de codificación que debe usarse para interpretar la cadena de consulta. El el valor predeterminado de `ie` es `latin1`. Consulta la sección Codificación de caracteres para ver cuándo es posible que debas usar este parámetro. Consulte el artículo sobre la codificación de caracteres Esquemas para la lista de valores `ie` posibles.
Ejemplos	`q=google&ie=utf8&oe=utf8`

Descripción

Opcional. El parámetro ie establece el carácter de codificación que debe usarse para interpretar la cadena de consulta. El el valor predeterminado de ie es latin1.

Consulta la sección Codificación de caracteres para ver cuándo es posible que debas usar este parámetro.

Consulte el artículo sobre la codificación de caracteres Esquemas para la 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 escritas en un lenguaje en particular. Google WebSearch determina el idioma de un documento mediante analizando: el dominio de nivel superior (TLD) de la URL del documento metaetiquetas de idioma del documento El idioma principal utilizado en el texto del cuerpo del documento idiomas secundarios, si los hay, utilizados en el texto del cuerpo del documento Consulta el idioma (`lr`). Valores de la colección para obtener una lista de los valores válidos parámetro.
Ejemplos	`q=Frodo&lr=lang_en`

Descripción

Opcional. El parámetro lr (restricción de idioma) restringe los resultados de la búsqueda a los documentos escritas en un lenguaje en particular.

Google WebSearch determina el idioma de un documento mediante analizando:

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

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

Ejemplos q=Frodo&lr=lang_en

num

num
Descripción	Opcional. El parámetro `num` identifica la la cantidad de resultados de la búsqueda que se mostrarán. El valor predeterminado de `num` es `10`, y el máximo el valor es `20`. Si solicitas más de 20 resultados, solo 20 de los resultados de búsqueda. Nota: Si la cantidad total de resultados de la búsqueda es menor. que la cantidad solicitada de resultados, todos los resultados de búsqueda disponibles se devuelvan.
Ejemplos	`q=google&num=10`

Descripción

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

El valor predeterminado de num es 10, y el máximo el valor es 20. Si solicitas más de 20 resultados, solo 20 de los resultados de búsqueda.

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

Ejemplos q=google&num=10

oe
Descripción	Opcional. El parámetro `oe` establece el carácter de codificación que se debe usar para decodificar el resultado XML. El el valor predeterminado de `oe` es `latin1`. Consulta la sección Codificación de caracteres para ver cuándo es posible que debas usar este parámetro. Consulte el artículo sobre la codificación de caracteres Esquemas para la lista de valores `oe` posibles.
Ejemplos	`q=google&ie=utf8&oe=utf8`

Descripción

Opcional. El parámetro oe establece el carácter de codificación que se debe usar para decodificar el resultado XML. El el valor predeterminado de oe es latin1.

Consulta la sección Codificación de caracteres para ver cuándo es posible que debas usar este parámetro.

Consulte el artículo sobre la codificación de caracteres Esquemas para la lista de valores oe posibles.

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

output

Descripción

Obligatorio. El parámetro output especifica el formato de los resultados XML. La única ruta válida los valores para este parámetro son xml y xml_no_dtd. El gráfico a continuación, explica cómo difieren estos valores de los parámetros.

Valor	Formato de salida
`xml_no_dtd`	Los resultados XML no incluirán un Sentencia !DOCTYPE. (Recomendado)
`xml`	Los resultados XML contendrán Referencia de DTD. La segunda línea del resultado identificará el documento. tipo de definición (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. consulta ingresada por el usuario. Aunque este parámetro es opcional, puedes se debe especificar un valor para al menos uno de los parámetros de consulta (as_epq, as_lq, as_oq, as_q) para obtener resultados de la búsqueda. También hay una serie de términos de consulta especiales que se pueden se usan como parte del parámetro `q` valor. Consulta los Términos de Consulta Especiales para obtener una lista con las definiciones de estos términos. El panel de control de la Búsqueda de Google incluye un informe las consultas enviadas con el parámetro `q`. Nota: El valor especificado para el parámetro q debe tener formato de escape de URL.
Ejemplos	`q=vacation&as_oq=london+paris`

Descripción

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

También hay una serie de términos de consulta especiales que se pueden se usan como parte del parámetro q valor. Consulta los Términos de Consulta Especiales para obtener una lista con las definiciones de estos términos.

El panel de control de la Búsqueda de Google incluye un informe las consultas enviadas con el parámetro q.

Nota: El valor especificado para el parámetro q debe tener formato de 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 para adultos y contenido pornográfico. El valor predeterminado para el parámetro safe es off. Valores de parámetros válidos son:

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

Consulte el Cómo filtrar contenido para adultos con SafeSearch para obtener más información sobre esta función.

Ejemplos q=adult&safe=high

start

start
Descripción	Opcional. El parámetro `start` indica el primer resultado coincidente que se debe incluir. 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 resultado es 1, y así sucesivamente. El parámetro `start` funciona en con el parámetro num para determinar qué resultados de la búsqueda devolver. Ten en cuenta que no se mostrarán más de 1,000 resultados para una consulta, incluso si hay más de 1,000 documentos que coinciden con la consulta, por lo que establecer el inicio en 1,000 o más no producirá resultados.
Ejemplos	`start=10`

Descripción

Opcional. El parámetro start indica el primer resultado coincidente que se debe incluir. 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 resultado es 1, y así sucesivamente.

El parámetro start funciona en con el parámetro num para determinar qué resultados de la búsqueda devolver. Ten en cuenta que no se mostrarán más de 1,000 resultados para una consulta, incluso si hay más de 1,000 documentos que coinciden con la consulta, por lo que establecer el inicio en 1,000 o más no producirá resultados.

Ejemplos start=10

ordenar
Descripción	Opcional. El parámetro `sort` especifica que los resultados se ordenarán según la expresión especificada. Por ejemplo, ordenar por fecha.
Ejemplos	`sort=date`

ud
Descripción	Opcional. El parámetro `ud` indica si la respuesta XML debe incluir la URL codificada en IDN para el resultado de la búsqueda. La codificación de IDN (nombre de dominio internacional) permite que los dominios se muestren con el formato lenguajes, por ejemplo: http://www.花井鮨.com Los valores válidos para este parámetro son `1` (predeterminado), lo que significa que el resultado XML debería incluyen URLs con codificación IDN y `0`, lo que significa que el resultado XML no debe incluir códigos IDN URLs. Si el parámetro `ud` se establece en `1`, la URL codificada en IDN aparecerá en en la etiqueta UD de los resultados de XML. Si el parámetro `ud` se establece en `0`, la URL del ejemplo anterior sería se muestra como: http://www.xn--elq438j.com. Nota: Esta es una función beta.
Ejemplos	`q=google&ud=1`

Descripción

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

http://www.花井鮨.com

Los valores válidos para este parámetro son 1 (predeterminado), lo que significa que el resultado XML debería incluyen URLs con codificación IDN y 0, lo que significa que el resultado XML no debe incluir códigos IDN URLs. Si el parámetro ud se establece en 1, la URL codificada en IDN aparecerá en en la etiqueta UD de los resultados de XML.

Si el parámetro ud se establece en 0, la URL del ejemplo anterior sería se muestra como:

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

Nota: Esta es una función beta.

Ejemplos q=google&ud=1

Búsqueda avanzada

Los parámetros de consulta adicionales enumerados debajo de la imagen son relevantes para las búsquedas avanzadas. 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 la consulta. términos para esa búsqueda. En la imagen, se muestra la página Búsqueda avanzada de Google. En la imagen, el nombre de cada El parámetro de búsqueda avanzada se escribe en texto rojo dentro o junto a el campo de la página a la que corresponde ese parámetro.

Parámetros de búsqueda avanzados

as_dt
Descripción	Opcional. El parámetro `as_dt` controla si para incluir o excluir resultados del sitio que se menciona en el parámetro `as_sitesearch`. El 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 un frase que deben contener todos los documentos de los resultados de la búsqueda. Puedes también usa el término de consulta de búsqueda de frase para busca 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 la búsqueda resultados. También puedes usar la consulta excluir término para asegurarte de que una palabra o frase en particular no aparezca en el documentos en un conjunto de resultados de búsqueda.
Ejemplos	`q=bass&as_eq=music`.

as_lq
Descripción	Opcional. El parámetro `as_lq` especifica lo siguiente: todos los resultados de búsqueda deben contener un vínculo a una URL específica. También puedes Utiliza el término de búsqueda link: para este tipo de consulta.
Ejemplos	`as_lq=www.google.com`

as_nlo

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 una búsqueda inclusiva de `as_nlo...as_nhi` a la consulta.
Ejemplos	Lo siguiente establece un rango de búsqueda de 5 a 10 inclusive: `as_nlo=5&as_nhi=10`

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 una búsqueda inclusiva de as_nlo...as_nhi a la consulta.

Ejemplos

Lo siguiente establece un rango de búsqueda de 5 a 10 inclusive:

as_nlo=5&as_nhi=10

as_nhi

as_nhi
Descripción	Opcional. El parámetro `as_nhi` especifica la el valor final de un rango de búsqueda. Usa `as_nlo` y `as_nhi` para agregar un inclusivo y rango de búsqueda de `as_nlo...as_nhi` para la consulta.
Ejemplos	Lo siguiente establece un rango de búsqueda de 5 a 10 inclusive: `as_nlo=5&as_nhi=10`

Descripción

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

Ejemplos

Lo siguiente 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, donde cada documento en los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda. También puedes usar el término de consulta booleano OR para este tipo de consulta.
Ejemplos	`q=vacation&as_oq=London+Paris`

as_q
Descripción	Opcional. El parámetro `as_q` proporciona búsquedas términos a verificar 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 los resultados de la búsqueda.
Ejemplos	`q=president&as_q=John+Adams`

as_qdr

as_qdr
Descripción	Opcional. El parámetro `as_qdr` solicita la búsqueda resultados de un período específico (período breve). 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`

Descripción

Opcional. El parámetro as_qdr solicita la búsqueda resultados de un período específico (período breve). 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 puedes usarlo para excluir páginas de un sitio determinado de los resultados de la búsqueda.
Ejemplos	`q=vacation&as_sitesearch=www.google.com`

Términos de consulta especiales

Google WebSearch permite el uso de varios términos de consulta especiales que acceder a funciones adicionales del motor de búsqueda de Google. Estos los términos especiales de consulta se deben incluir en el valor del parámetro de la solicitud q. Al igual que otros términos de consulta, la los términos de búsqueda especiales deben tener URL con escape. R el número de los términos de consulta especiales contienen dos puntos (:). Este personaje también debe tener escape de URL; su valor con escape de URL es %3A.

Vínculos de retroceso [link:]

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 la solicitud as_lq para enviar una solicitud `link:`. Nota: No puedes especificar ningún otro término de búsqueda cuando usando `link:`.
Ejemplos	`http://www.google.com/search?q=link%3Awww.example.com`

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 la solicitud as_lq para enviar una solicitud link:.

Nota: No puedes especificar ningún otro término de búsqueda cuando usando link:.

Ejemplos

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

Búsqueda booleana O [ O ]

Búsqueda booleana O [ O ]
Descripción	El término de consulta `OR` recupera documentos que incluyen uno de una serie de (dos o más) términos de búsqueda. Para usar la consulta `OR` debes insertar el término de búsqueda `OR` en mayúsculas letras entre cada término de la serie. También puedes usar la 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 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, y Londres o París, en el que el menor peso se da a los chocolates: Término de búsqueda: `q=vacation+london+OR+paris+chocolates` Busca vacaciones, chocolates y flores en documentos que también puede contener Londres o París: Término de búsqueda: `q=vacation+london+OR+paris+chocolates+flowers` Busca vacaciones y una de Londres o París, y también busca en el caso de chocolates o flores: Término de búsqueda: `q=vacation+london+OR+paris+chocolates+OR+flowers`

Descripción

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

También puedes usar la 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 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, y Londres o París, en el que el menor peso se da a los chocolates:

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

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

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

Busca vacaciones y una de Londres o París, y también busca en el caso de chocolates o flores:

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

Excluir término de consulta [-]

Excluir término de consulta [-]
Descripción	El término de búsqueda de exclusión (`-`) restringe los resultados para una particular a los documentos que no contengan un palabra o frase particular. Para usar el término de búsqueda de exclusión, anteponer la palabra o frase que se excluirá de los documentos coincidentes con “-” (un signo menos). La versión de `-` con escape de URL es `%2D`. El término de la búsqueda de exclusión es útil cuando un término de búsqueda tiene más más de un significado. Por ejemplo, la palabra "bajo" podría devolver resultados sobre el pescado o la música. Si buscabas documentos sobre pez, puedes excluir documentos sobre música de los resultados de la búsqueda con el término de la consulta de exclusión. También puedes usar la solicitud as_eq parámetro para excluir documentos que coincidan con una palabra o frase en particular en los resultados de la búsqueda.
Ejemplos	Entrada del usuario: `bass -music` Término de búsqueda: `q=bass+%2Dmusic`

Descripción

El término de búsqueda de exclusión (-) restringe los resultados para una particular a los documentos que no contengan un palabra o frase particular. Para usar el término de búsqueda de exclusión, anteponer la palabra o frase que se excluirá de los documentos coincidentes con “-” (un signo menos).

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

El término de la búsqueda de exclusión es útil cuando un término de búsqueda tiene más más de un significado. Por ejemplo, la palabra "bajo" podría devolver resultados sobre el pescado o la música. Si buscabas documentos sobre pez, puedes excluir documentos sobre música de los resultados de la búsqueda con el término de la consulta de exclusión.

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

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

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

Exclusión de tipo de archivo [ -tipo de archivo: ]
Descripción	El término de búsqueda `-filetype:` excluye los documentos con una una extensión de archivo determinada, como ".pdf" o “.doc” de la búsqueda resultados. La búsqueda debe tener el formato `-filetype:EXTENSION` sin espacios entre el término de búsqueda `-filetype:` y el una extensión especificada. La versión de `-filetype:` con escape de URL es `%2Dfiletype%3A`. Nota: Puedes excluir varias tipos de archivos de los resultados de la búsqueda agregando más `-filetype:` consulta términos a tu consulta. Deberías tener un término de búsqueda de `-filetype:` en tu búsqueda para cada extensión de archivo que se debe excluir de los resultados de la búsqueda. Entre los tipos de archivos 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, wki, sem. y semana libre) Lotus WordPro (LWP) Macwrite (MW) Microsoft Excel (xls) Microsoft PowerPoint (PPT) Microsoft Word (documento) Microsoft Funciona (sem., wps, wdb) Microsoft Write (escritura) Formato de Texto Enriquecido (Rtf) Flash de onda de choque (swf) Texto (ans, txt) Es posible que se agreguen otros tipos de archivo en el futuro. Una versión actualizada puedes encontrar la lista 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 Excluye los documentos PDF y de Word: `q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc`

Descripción

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

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

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

Entre los tipos de archivos 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, wki, sem. y semana libre)
Lotus WordPro (LWP)
Macwrite (MW)
Microsoft Excel (xls)
Microsoft PowerPoint (PPT)
Microsoft Word (documento)
Microsoft Funciona (sem., wps, wdb)
Microsoft Write (escritura)
Formato de Texto Enriquecido (Rtf)
Flash de onda de choque (swf)
Texto (ans, txt)

Es posible que se agreguen otros tipos de archivo en el futuro. Una versión actualizada puedes encontrar la lista 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 Excluye los documentos PDF y de Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

Filtrado de tipos de archivos [ filetype: ]

Filtrado de tipos de archivos [ filetype: ]
Descripción	El término de consulta `filetype:` restringe los resultados de la búsqueda a documentos con una extensión de archivo determinada, como ".pdf" o “.doc”. La búsqueda debe tener el formato filetype:EXTENSION con espacio entre el término de consulta `filetype:` y el valor especificado . La versión de `filetype:` con escape de URL es `filetype%3A`. Puedes restringir la búsqueda resultados a documentos que coincidan con una de varias extensiones de archivo agregando más `filetype:` términos de búsqueda a tu consulta. Debes tener un término de búsqueda `filetype:` en tu búsqueda por cada extensión de archivo que se deba incluir en los resultados de la búsqueda. Si hay varios términos de búsqueda `filetype:`, deben separarse con el término de búsqueda `OR`. De forma predeterminada, incluir documentos con cualquier extensión de archivo. Entre los tipos de archivos 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, wki, sem. y semana libre) Lotus WordPro (LWP) Macwrite (MW) Microsoft Excel (xls) Microsoft PowerPoint (PPT) Microsoft Word (documento) Microsoft Funciona (sem., wps, wdb) Microsoft Write (escritura) Formato de Texto Enriquecido (Rtf) Flash de onda de choque (swf) Texto (ans, txt) Es posible que se agreguen otros tipos de archivo en el futuro. Una versión actualizada puedes encontrar la lista en las Preguntas frecuentes sobre los tipos de archivos de Google.
Ejemplos	En este ejemplo, se devuelven documentos PDF que mencionan "Google": `q=Google+filetype%3Apdf` En este ejemplo se devuelven documentos PDF y de Word que mencionan “Google”: `q=Google+filetype%3Apdf+OR+filetype%3Adoc`

Descripción

El término de consulta filetype: restringe los resultados de la búsqueda a documentos con una extensión de archivo determinada, como ".pdf" o “.doc”. La búsqueda debe tener el formato filetype:EXTENSION con espacio entre el término de consulta filetype: y el valor especificado .

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

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

De forma predeterminada, incluir documentos con cualquier extensión de archivo.

Entre los tipos de archivos 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, wki, sem. y semana libre)
Lotus WordPro (LWP)
Macwrite (MW)
Microsoft Excel (xls)
Microsoft PowerPoint (PPT)
Microsoft Word (documento)
Microsoft Funciona (sem., wps, wdb)
Microsoft Write (escritura)
Formato de Texto Enriquecido (Rtf)
Flash de onda de choque (swf)
Texto (ans, txt)

Es posible que se agreguen otros tipos de archivo en el futuro. Una versión actualizada puedes encontrar la lista en las Preguntas frecuentes sobre los tipos de archivos de Google.

Ejemplos

En este ejemplo, se devuelven documentos PDF que mencionan "Google":
q=Google+filetype%3Apdf

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

Incluir término de la consulta [+]

Incluir término de la consulta [+]
Descripción	El término de consulta de inclusión (+) especifica que una palabra o frase debe aparecer en todos los documentos incluidos en los resultados de la búsqueda. Para usar incluir un término de consulta, debes anteponer la palabra o frase que debe se incluyen en todos los resultados de la búsqueda con "+" (un signo más). La versión con escape de URL de `+` (un signo más) es %2B. Debes usar `+` antes de una palabra común que Google suele descartar antes de identificar los resultados de la búsqueda.
Ejemplos	Entrada del usuario: `Star Wars Episode +I` Término de búsqueda: `q=Star+Wars+Episode+%2BI`

Descripción

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

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

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

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

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

Búsqueda solo de vínculos, todos los términos [ allinlinks: ]
Descripción	El término de búsqueda `allinlinks:` requiere documentos en resultados de la búsqueda que contengan todas las palabras de la búsqueda en URL enlaces. La búsqueda debe tener el formato `allinlinks:` seguida de las palabras que aparecen en ella. Si tu búsqueda incluye la consulta `allinlinks:` Google solo verificará los vínculos de URL en los documentos para buscar las palabras en tu consulta de búsqueda, ignorando otros textos de los documentos, los títulos de los documentos y las URL de cada uno. Ten en cuenta que el documento La URL es diferente de los vínculos de URL que se incluyen en 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`

Descripción

El término de búsqueda allinlinks: requiere documentos en resultados de la búsqueda que contengan todas las palabras de la búsqueda en URL enlaces. La búsqueda debe tener el formato allinlinks: seguida de las palabras que aparecen en ella.

Si tu búsqueda incluye la consulta allinlinks: Google solo verificará los vínculos de URL en los documentos para buscar las palabras en tu consulta de búsqueda, ignorando otros textos de los documentos, los títulos de los documentos y las URL de cada uno. Ten en cuenta que el documento La URL es diferente de los vínculos de URL que se incluyen en 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 frase

Búsqueda de frase
Descripción	El término de consulta de búsqueda de frase (") te permite buscar frases completas encerrando las frases entre comillas o con conectándolas con guiones. La versión con escape de URL de `"` (comillas) es `%22`. Las búsquedas de frases son particularmente útiles si buscas para las citas famosas o los nombres propios. También puedes usar la 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`

Descripción

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

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

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

También puedes usar la 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 solo de texto, todos los términos [allintext:]

Búsqueda solo de texto, todos los términos [allintext:]
Descripción	El término de búsqueda `allintext:` requiere que cada documento del los resultados de la búsqueda contengan todas las palabras de la consulta de búsqueda de en el cuerpo del documento. La consulta debe tener el formato `allintext:` seguida de las palabras de tu búsqueda. Si tu búsqueda incluye la consulta `allintext:` Google solo revisará el texto del cuerpo de los documentos para buscar las palabras en tu consulta de búsqueda, ignorar los vínculos en esos documentos, documentar y las URL de los documentos. La versión de `allintext:` con escape de URL es `allintext%3A`.
Ejemplos	En este ejemplo, se especifica que las palabras “Google” y "buscar" debe 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`

Descripción

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

Si tu búsqueda incluye la consulta allintext: Google solo revisará el texto del cuerpo de los documentos para buscar las palabras en tu consulta de búsqueda, ignorar los vínculos en esos documentos, documentar y las URL de los documentos.

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

Ejemplos En este ejemplo, se especifica que las palabras “Google” y "buscar" debe 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 de título, un solo término [intitle:]

Búsqueda de título, un solo término [intitle:]
Descripción	El término de consulta `intitle:` restringe los resultados de la búsqueda a documentos que contengan una palabra específica en el título del documento. El 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 debe incluirse en el título del documento colocando el término de consulta `intitle:` delante de cada una de esas palabras. Puedes también puedes usar el término de búsqueda allintitle: para especificar que todas las palabras de la consulta deben incluirse en los títulos de que están 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 los documentos en los resultados de la búsqueda y la palabra "buscar" Debe aparecer en cualquier parte de los títulos, las URL, los vínculos o el texto del cuerpo. de esos documentos: Entrada del usuario:`intitle:Google search` Término de búsqueda:`q=intitle%3AGoogle+search`

Descripción

El término de consulta intitle: restringe los resultados de la búsqueda a documentos que contengan una palabra específica en el título del documento. El 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 debe incluirse en el título del documento colocando el término de consulta intitle: delante de cada una de esas palabras. Puedes también puedes usar el término de búsqueda allintitle: para especificar que todas las palabras de la consulta deben incluirse en los títulos de que están 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 los documentos en los resultados de la búsqueda y la palabra "buscar" Debe aparecer en cualquier parte de los títulos, las URL, los vínculos o el texto del cuerpo. de esos documentos:
Entrada del usuario:intitle:Google search
Término de búsqueda:q=intitle%3AGoogle+search

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

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 documentos que contengan todas las palabras de la búsqueda en el título del documento. Para Usa el término de búsqueda `allintitle:`; incluye “allintitle:” a las inicio de la búsqueda. Nota: Poner `allintitle:` al comienzo de una búsqueda equivale a poner intitle: delante de cada palabra en la búsqueda. para cada 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 "buscar" debe aparecer en los títulos de todos los documentos en los resultados de la búsqueda: Entrada del usuario: `allintitle: Google search` Término de consulta: `q=allintitle%3A+Google+search`

Descripción

El término de consulta allintitle: restringe los resultados de la búsqueda a documentos que contengan todas las palabras de la búsqueda en el título del documento. Para Usa el término de búsqueda allintitle:; incluye “allintitle:” a las inicio de la búsqueda.

Nota: Poner allintitle: al comienzo de una búsqueda equivale a poner intitle: delante de cada palabra en la búsqueda. para cada 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 "buscar" debe aparecer en los títulos de todos los documentos en los resultados de la búsqueda:
Entrada del usuario: allintitle: Google search
Término de consulta: q=allintitle%3A+Google+search

Búsqueda de URL, un solo término [inurl:]

Búsqueda de URL, un solo término [inurl:]
Descripción	El término de consulta `inurl:` restringe los resultados de la búsqueda a documentos que contengan una palabra específica en su URL. El la búsqueda debe tener el formato inurl:WORD sin espacio entre el término de consulta `inurl:` y la siguiente palabra. La consulta `inurl:` término ignora la puntuación y usa solo la primera palabra que sigue al operador `inurl:`. Puedes especificar más de una palabra que deba incluirse en la URL del documento colocando el término de búsqueda `inurl:` delante de cada palabra. También puedes utilizar el término de búsqueda allinurl: para especificar que todas las palabras de la búsqueda deben incluirse en las URLs de 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 URL de cualquier documento en los resultados de la búsqueda y la palabra "buscar" debe aparecer en cualquier parte de los títulos, las URL, los vínculos o el texto del cuerpo de estos documentos: Entrada del usuario: `inurl:Google search` Término de búsqueda: `q=inurl%3AGoogle+search`

Descripción

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

La consulta inurl: término ignora la puntuación y usa solo la primera palabra que sigue al operador inurl:. Puedes especificar más de una palabra que deba incluirse en la URL del documento colocando el término de búsqueda inurl: delante de cada palabra. También puedes utilizar el término de búsqueda allinurl: para especificar que todas las palabras de la búsqueda deben incluirse en las URLs de 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 URL de cualquier documento en los resultados de la búsqueda y la palabra "buscar" debe aparecer en cualquier parte de los títulos, las URL, los vínculos o el texto del cuerpo de estos documentos:
Entrada del usuario: inurl:Google search
Término de búsqueda: q=inurl%3AGoogle+search

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

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 documentos que contengan todas las palabras de la búsqueda en la URL del documento. Para usa el término de búsqueda `allinurl:`, incluye `allinurl:` al inicio de tu búsqueda. El término de consulta `allinurl:` ignora la puntuación, de modo que solo funciona en palabras y no en URL. o los componentes de la solución. Por ejemplo, `allinurl: uk/scotland` restringirá los resultados a los documentos que contengan las palabras “uk” y "escocia" en sus URL, pero no requerirá que esas dos palabras aparezcan de forma o que estén separados por una barra. La versión de `allinurl:` con escape de URL es `allinurl%3A`.
Ejemplos	En este ejemplo, se especifica que las palabras "Google" y "buscar" debe aparecer en las URL de cualquier documento en los resultados de la búsqueda: Entrada del usuario: `allinurl: Google search` Término de consulta: `q=allinurl%3A+Google+search`

Descripción

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

El término de consulta allinurl: ignora la puntuación, de modo que solo funciona en palabras y no en URL. o los componentes de la solución. Por ejemplo, allinurl: uk/scotland restringirá los resultados a los documentos que contengan las palabras “uk” y "escocia" en sus URL, pero no requerirá que esas dos palabras aparezcan de forma o que estén separados por una barra.

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

Ejemplos

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

Información del documento web [info:]

Información del documento web [info:]
Descripción	El término de consulta `info:` recupera información general acerca de una URL, siempre que 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 búsqueda `info:` y la URL. La versión con escape de URL de `info:` es info%3A. Nota: No puedes especificar ningún otro término de búsqueda cuando usando `info:`.
Ejemplos	Entrada del usuario: `info:www.google.com` Término de búsqueda: `q=info%3Awww.google.com`

Descripción

El término de consulta info: recupera información general acerca de una URL, siempre que 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 búsqueda info: y la URL.

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

Nota: No puedes especificar ningún otro término de búsqueda cuando usando info:.

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

Consultas de imágenes de muestra

En los siguientes ejemplos, se muestran algunas solicitudes HTTP de imágenes 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) del término de búsqueda "mono" (q=monkey), de 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

imgsz
Descripción	Opcional. Muestra imágenes con un tamaño especificado, donde el tamaño puede ser uno de los siguientes: `icon` (pequeña) `small\|medium\|large\|xlarge` (media) `xxlarge` (grande) `huge` (extragrande)
Ejemplos	`q=google&as_filetype=png&imgsz=icon`

Descripción

Opcional. Muestra imágenes con un tamaño especificado, donde el tamaño puede ser uno de los siguientes:

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

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

tipo de imagen

tipo de imagen
Descripción	Opcional. Muestra imágenes de un tipo, que puede ser uno de los siguientes: `clipart` (imágenes prediseñadas) `face` (rostro) `lineart` (lineal) `news` (noticias) `photo` (foto)
Ejemplos	`q=google&as_filetype=png&imgtype=photo`

Descripción

Opcional. Muestra imágenes de un tipo, que puede ser uno de los siguientes:

clipart (imágenes prediseñadas)
face (rostro)
lineart (lineal)
news (noticias)
photo (foto)

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

imgc

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`

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. Devuelve 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 indican las limitaciones de las solicitudes de búsqueda que enviar a Google:

Componente	Límite	Comentario
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 configuras 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 múltiples solicitudes y aumenta el valor del parámetro start con cada solicitud.

Internacionalización de las consultas y la presentación de resultados

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

Las siguientes secciones analizan problemas relacionados con la búsqueda en varios idiomas:

Personaje Codificación
Idiomas de la interfaz
Chino simplificado y tradicional Búsqueda

Codificación de caracteres

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

Puedes usar el parámetro de solicitud ie para especificar el mecanismo de codificación para los caracteres en tu solicitud HTTP. Puedes usa también el parámetro oe para especificar la codificación el esquema que Google debe usar para codificar tu respuesta XML. Si eres Si usas 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 función de búsqueda para varios idiomas, te recomendamos que utilices el valor de codificación utf8 (UTF-8) para los parámetros ie y oe.

Consulta el Carácter apéndice Esquemas de codificación para obtener una lista completa de los valores que que puedes usar 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 lenguaje de tu interfaz gráfica. El valor del parámetro hl puede afectar los resultados de búsqueda XML, especialmente en las consultas internacionales cuando la restricción de idioma (mediante el parámetro lr) no se especifica de forma explícita. De tal forma casos, el parámetro hl puede promocionar resultados de la búsqueda en el mismo idioma que el idioma de entrada del usuario.

Te sugerimos que establezcas explícitamente el parámetro hl en los resultados de la búsqueda para garantizar que Google seleccione la calidad más alta resultados de la búsqueda para cada consulta.

Consulta la interfaz compatible Idiomas para obtener una lista completa de los valores válidos del 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 determinado idioma o conjunto de idiomas.

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

Los siguientes ejemplos muestran cómo podrías usar los operadores booleanos para solicitar documentos en en diferentes idiomas.

Para documentos escritos en japonés:

lr=lang_jp

Para documentos escritos en italiano o alemán:

lr=lang_it|lang_de

En el caso de los documentos que no estén escritos en húngaro o checo, ten en cuenta lo siguiente:

lr=(-lang_hu).(-lang_cs)

Consulta la Colección de idiomas Valores para obtener una lista completa de los valores posibles para el parámetro lr y el valor Booleano Operadores para obtener un análisis completo sobre su uso. operadores.

Búsqueda en chino tradicional y simplificado

El chino simplificado y el chino tradicional son dos variantes de escritura del idioma chino. El mismo concepto puede escribirse de manera diferente en para cada variante. Dada una consulta en una de las variantes, el El servicio WebSearch puede devolver resultados que incluyan páginas tanto en variantes.

Para usar esta función, sigue estos pasos:

Establece el parámetro de solicitud c2coff en 0
. y
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. tanto en chino simplificado como tradicional. (Ten en cuenta que la información adicional requerida, como como cliente, no se incluye en el ejemplo).

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

Filtrar resultados

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

Automático Cómo filtrar los resultados de la búsqueda
Filtros de idioma y país
Filtrado de contenidos para adultos con SafeSearch

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

Con el objetivo de ofrecer los mejores resultados de búsqueda posibles, Google usa dos técnicas para filtrar automáticamente los resultados de la búsqueda que generalmente no se considera deseable:

Contenido duplicado: si varios documentos incluyen el misma información, entonces solo se asigna el documento más relevante de ese conjunto incluida en los resultados de la búsqueda.
Acumulación de hosts: Si hay muchos resultados de búsqueda de la mismo sitio, es posible que Google no muestre todos los resultados de ese sitio o que mostrar los resultados más abajo en
la clasificación que en otras circunstancias.

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

Filtrado por idioma y país

Google WebSearch devuelve resultados de un índice maestro de todos los documentos web. El índice principal contiene subcolecciones de documentos agrupados por atributos específicos, como el idioma y 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 que están redactados en idiomas particulares o que se originan en países específicos, 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
El idioma principal utilizado en el texto del cuerpo del documento

Consulta también la definición del parámetro lr en la sección Cómo buscar Documentos escritos en idiomas específicos y los valores de colección de idiomas que se pueden se usan como valores para el parámetro lr para obtener información sobre cómo restringir los resultados en función del 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 la Colección de países. Valores que se pueden usar como valores para el parámetro cr para obtener más información sobre la restricción de los resultados por país de origen.

Nota: Puedes combinar lenguajes y los de país para personalizar los resultados de la búsqueda. Para ejemplo, podrías solicitar documentos escritos en francés y provienen de Francia o Canadá, o podrías solicitar documentos que lleguen de Holanda y no están escritas 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 que se muestren resultados de búsqueda para sitios que incluyan contenido para adultos. Con nuestro filtro SafeSearch, puedes filtrar para los resultados de la búsqueda que incluyan contenido para adultos y elimínalos. Los filtros de Google utilizan tecnología propia para verificar palabras clave y frases. y las URL. Aunque ningún filtro es 100% exacto, SafeSearch quitar la gran mayoría del contenido para adultos de tu búsqueda resultados.

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

SafeSearch está disponible en los siguientes idiomas:

Holandés
Inglés
Francés
Alemán

Italiano
Portugués (Brasil)
Español
Chino tradicional

Puedes ajustar el grado en el que Google filtra tus resultados 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 cómo se afectará los resultados de tu búsqueda:

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

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

Si tienes SafeSearch activado y encuentras sitios que contienen ofensivo en tus resultados, envía la URL del sitio a safesearch@google.com y te investigará el sitio.

Resultados XML

XML de Google DTD de resultados
Acerca de la respuesta XML
XML Resultados de búsquedas regulares y avanzadas
Búsqueda regular o avanzada: consulta de muestra y Resultado de XML
Búsqueda avanzada/común: etiquetas XML

DTD de resultados XML de Google

Google usa el mismo DTD para describir el formato XML para todos los tipos de en los resultados de la búsqueda. Muchas de las etiquetas y los atributos se pueden aplicar a todos tipos de búsqueda. Sin embargo, algunas etiquetas se pueden aplicar tipos de búsqueda. Por lo tanto, es posible que las definiciones de la DTD sean menos restrictivas que las definiciones proporcionadas en este documento.

En este documento, se describen los aspectos de la DTD relevantes para WebSearch. Cuando observas el DTD, si trabajas en WebSearch, puede ignorar sin riesgo las etiquetas y los atributos que no están que se documenta aquí. Si la definición difiere entre el DTD y el documentación, dicho hecho se menciona en este documento.

Google puede devolver resultados XML con o sin una referencia a el DTD más reciente. La DTD es una guía para ayudar a los administradores de búsqueda y los analizadores de XML comprender los resultados XML de Google. Como el archivo XML de Google la gramática de la palabra puede cambiar de vez en cuando, no debes configurar tu para usar el DTD y validar cada resultado XML.

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

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

Accede a la última versión de DTD en http://www.google.com/google.dtd.

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

Acerca de la respuesta XML

Todos los valores de los elementos tienen formato HTML válido y apto para mostrarse, a menos que de lo contrario, se indicará en las definiciones de etiquetas XML.
Algunos valores de los elementos son URLs que deben estar codificadas en HTML antes a medida que se muestren.
El analizador de XML debe ignorar los atributos y las etiquetas sin documentar. Esto permite que tu aplicación siga funcionando sin modificaciones si Google agrega más funciones a la salida XML.

Ciertos caracteres deben tener escape cuando se incluyen como valores en Etiquetas XML. Tu procesador XML debería volver a convertir estas entidades al caracteres adecuados. Si no conviertes entidades correctamente, navegador puede mostrar, por ejemplo, el & carácter "&". El formato XML Standard documenta estos caracteres. estos caracteres son en la tabla a continuación:

Carácter	Formularios con escape	Entidad	Código de caracteres
Et	&	&	&
Comillas simples	'	'	'
Comillas dobles	"	"	"
Mayor que	>	>	>
Menor que	<	<	<

Resultados XML para consultas de búsqueda regulares y avanzadas

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

Esta solicitud de WebSearch de muestra solicita 10 resultados (num=10) sobre el término de búsqueda "socer" (q=socer), que es la palabra "fútbol" se escribió mal intencionalmente para 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 genera el siguiente resultado XML. Ten en cuenta que hay varios comentarios en el resultado XML para indicar dónde 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 regular/avanzada: etiquetas XML

Respuestas XML para las solicitudes de búsqueda normal y la búsqueda avanzada usan el mismo conjunto de etiquetas XML. Estas etiquetas XML se muestran en el ejemplo de XML anterior y que se explica en las tablas a continuación.

Las siguientes etiquetas XML aparecen ordenadas alfabéticamente por nombre de etiqueta y cada etiqueta contiene una descripción de la etiqueta; se muestra un ejemplo cómo aparecería la etiqueta en un resultado XML y el formato 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.

Ciertos símbolos pueden aparecer al lado de algunas subetiquetas en la definiciones. 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

anchor_text
Definición	La etiqueta <anchor_text> especifica el texto que debes mostrar a los usuarios para identificar un perfeccionamiento etiqueta asociada a un conjunto de resultados de la búsqueda. Desde etiquetas de perfeccionamiento reemplaza los caracteres que no son alfanuméricos por guiones bajos, mostrar el valor de la etiqueta <label> en tu interfaz de usuario. En cambio, debes mostrar el valor de la etiqueta <anchor_text>.
Ejemplo	<Ancho_text>golf cursos</Ancho_text>
Subetiqueta de	FacetItem
Formato del contenido	Texto

BLOQUEAR
Definición	Esta etiqueta encapsula el contenido de un bloque en la línea del cuerpo de un resultado de promoción. Cada bloque tiene las subetiquetas T, U y L. Una etiqueta T que no está 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 indicada en la subetiqueta U y el texto de hipervínculo en la subetiqueta L).
Subetiquetas	T, U y L
Subetiqueta de	BODY_LINE
Formato del contenido	Vacío

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 BLOCK, que pueden incluir texto o un vínculo con URL y texto de anclaje.
Subetiquetas	BLOQUEAR*
Subetiqueta de	SL_MAIN
Formato del contenido	Vacío

Definición

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

Atributos

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").
CID	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 como sigue: cache:CIDtext:escapedURL La URL con escape está disponible en la etiqueta UE.

Ejemplo

Subetiqueta de

TIENE

Formato del contenido

Vacío

C2C
Definición	La etiqueta <C2C> indica que el resultado se refiere a una página en chino tradicional. Esta etiqueta solo aparece cuando las estrategias Simplificada y Tradicional La búsqueda china está habilitada. Revisa la definición del parámetro de consulta c2coff para obtener más información sobre cómo habilitar y desactivando esta función.
Formato del contenido	Texto

Contexto
Definición	La etiqueta <Context> encapsula una lista de etiquetas de perfeccionamiento asociadas a un conjunto de resultados de la búsqueda.
Ejemplo	<Context>
Subetiquetas	title, Facet+
Formato del contenido	Contenedor

FECHA.MES (CRAWLDATE)
Definición	La etiqueta <CRAWLDATE> identifica la fecha en la que se rastreó por última vez la página. No se devuelve `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 el proyecto de Open Directory (ODP) de la categoría de un solo resultado de la búsqueda.
Ejemplo	<DI>
Subetiquetas	DT?, ¿DS?
Subetiqueta de	TIENE
Formato del contenido	Vacío

DS
Definición	La etiqueta <DS> proporciona el resumen enumerado para una en el directorio de ODP.
Ejemplo	<DS>Publica tu <b>fútbol</b> tu currículum directamente en la por 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 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 Motor de Búsqueda Programable Formato de especificación XML del motor de búsqueda. Si no creas estas de objetos, el método results_xml_tag_Context><Context> la etiqueta contener a 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 lógica relación.
Ejemplo	<Faceta>
Subetiquetas	FacetItem+, título+
Subetiqueta de	Contexto
Formato del contenido	Contenedor

FacetItem
Definición	La etiqueta <FacetItem> contiene información sobre una etiqueta de mejora asociada a un conjunto de resultados de la búsqueda.
Ejemplo	<FacetItem>
Subetiquetas	label, anchor_text+
Subetiqueta de	Faceta
Formato del contenido	FacetItem

FI
Definición	La etiqueta <FI> funciona como un indicador que indica si se aplicó un filtro de documentos para la búsqueda. Consulta la sección Filtros automáticos. en este documento para obtener más información sobre los resultados de la búsqueda de Google. filtros.
Ejemplo	<FI />
Subetiqueta de	RES.
Formato del contenido	Vacío

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 del "Protocolo de la Búsqueda de Google".

Atributos

Nombre	Formato	Descripción
VER	Texto (número entero)	El atributo VER especifica la versión del resultado de la búsqueda. El de salida actual es “3.2”.

Ejemplo

Subetiquetas

PARÁMETRO+, Q, RES?, TM

Formato del contenido

Vacío

TIENE
Definición	La etiqueta <HAS> encapsula los datos información sobre cualquier búsqueda especial los parámetros de solicitud admitidos para una URL específica. Nota: La definición de <HAS> para WebSearch es más restrictivo que en 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ío

L
Definición	La presencia de la etiqueta <L> indica que el servicio WebSearch puede encontrar otros sitios que se vinculen a esta URL del resultado de la búsqueda. Para encontrar este tipo de sitios, debes usar el término de búsqueda especial link:.
Subetiqueta de	TIENE
Formato del contenido	Vacío

etiqueta
Definición	La etiqueta <label> especifica una etiqueta de mejora. que puedes usar para filtrar los resultados de la búsqueda que recibes. Para usar una etiqueta de mejora, agrega la cadena more:[[label tag value]] a el 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 ser URL con caracteres de escape 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>, que identifica una etiqueta de mejora. asociados con una URL específica en tus resultados de la búsqueda.
Ejemplo	<label>golf_courses</label>
Subetiqueta de	FacetItem
Formato del contenido	Texto

LANG
Definición	La etiqueta <LANG> contiene la mejor estimación de Google de el idioma del resultado de la búsqueda.
Ejemplo	<LANG>es-419</LANG>
Subetiqueta de	R
Formato del contenido	Texto

M
Definición	La etiqueta <M> identifica el total estimado la cantidad de resultados de 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 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ío

NU
Definición	La etiqueta <NU> contiene un vínculo relativo al la siguiente página de los 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 XML. La información sobre el parámetro se incluye en los atributos de la etiqueta (nombre, valor, valor_original) y habrá una etiqueta PARÁMETRO para cada parámetro enviado en la solicitud HTTP.

Atributos

Nombre	Formato	Descripción
name	Texto	Nombre del parámetro de entrada.
value	HTML	Versión con formato HTML de la entrada valor del parámetro.
original_value	Texto	Versión original con escape de URL del valor del parámetro de entrada.

Ejemplo

<PARÁMETRO name="cr" value="countryNZ" original_value="paísNZ" />

Subetiqueta de

GSP

Formato del contenido

Complejo

PU
Definición	La etiqueta <PU> proporciona un vínculo relativo al 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 consulta de búsqueda enviados en la solicitud HTTP asociada con el resultado XML.
Ejemplo	<Q>pizza</Q>
Subetiqueta de	GSP
Formato del contenido	Texto

Definición

La etiqueta <R> contiene los detalles de una resultado de la búsqueda individual.

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

Atributos

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

Subetiquetas

¿U, UE, T?, CRAWLDATE, S?, ¿LANG?, TIENE

Subetiqueta de

RES.

Resp.

Definición

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

Atributos

Nombre	Formato	Descripción
SN	Texto (número entero)	Indica el índice (basado en 1) de la primer resultado de la búsqueda devuelto en este conjunto de resultados.
ES-419	Texto (número entero)	Indica el índice (basado en 1) de los últimos resultado de la búsqueda devuelto en este conjunto de resultados.

Ejemplo

Subetiquetas

¿M, FI?, ¿XT?, Nota: P*

Subetiqueta de

GSP

Formato del contenido

Vacío

S
Definición	La etiqueta <S> contiene un extracto de una búsqueda resultado que muestra los términos de la búsqueda destacados en negrita. Los saltos de línea son incluido en el extracto para un ajuste de texto adecuado.
Ejemplo	<S>Washington (CNN): una oferta para poner fin a la Diferencia en el senado con respecto al presidente <b>Bush's</b> selecciones judiciales dejar que cinco nominados avancen a la votación final y, al mismo tiempo, preservar el <b>...<b>...</b><S>
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 las promociones. El texto de hipervínculo y la URL del vínculo de título se encuentran en las subetiquetas T y U, respectivamente. Las líneas de texto del cuerpo y los vínculos se encuentran en las subetiquetas BODY_LINE.
Subetiquetas	BODY_LINE*, T y U
Subetiqueta de	SL_RESULTS
Formato del contenido	Vacío

SL_RESULTS
Definición	Etiqueta de contenedor para los resultados promocionados. Uno de estos aparecerá cada vez que tenga 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ío

Ortografía
Definición	La etiqueta <Spelling> encapsula una etiqueta alternativa sugerencia ortográfica 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 consultas en las que el valor del parámetro gl se encuentra en letras minúsculas.
Ejemplo	<Ortografía>
Subetiquetas	Sugerencia
Subetiqueta de	GSP
Formato del contenido	Vacío

Sugerencia

Definición

La etiqueta <Suggestion> contiene una sugerencia ortográfica alternativa para la consulta enviada. Puedes usar la el contenido de la etiqueta para sugerir la ortografía alternativa al usuario de la búsqueda. El valor del atributo q es el Sugerencia ortográfica con escape de URL que puedes usar como término de consulta.

Atributos

Nombre	Formato	Descripción
q	Texto	El atributo q especifica la Es la versión con escapada de URL de la sugerencia ortográfica.

Ejemplo

<Sugerencia q="soccer">&lt;b&gt;&lt;i&gt;soccer&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>La costa este de Amici Pizzería</T>
Subetiqueta de	R
Formato del contenido	Texto (HTML)

título
Definición	Como elemento secundario de <Context>, la etiqueta <Context> 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 elemento secundario de <Context>: <title>My Search Engine</title> Como hijo de <Facet>: <title>facet título</title>
Subetiqueta de	Contexto, Faceta
Formato del contenido	Texto

TM
Definición	La etiqueta <TM> identifica el tiempo total del servidor. necesario para devolver resultados de la búsqueda, medidos 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 búsqueda sugerencia.
Ejemplo	<TT><i>Sugerencia: Para la mayoría navegadores, presionar la tecla Intro produce los mismos resultados que hacer clic el botón Buscar.</i></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 el IDN (Nombre de dominio internacional) para el resultado de la búsqueda. El valor permite dominios que se mostrarán en los idiomas locales. Por ejemplo, el Se podría decodificar la URL con codificación IDN http://www.%E8%8A%B1%E4%BA%95.com y mostrarla como http://www.花テ鮨.com. Esta etiqueta <UD> solo se incluirá en los resultados de la búsqueda de 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 IDN)

UE
Definición	La etiqueta <UE> proporciona la URL del resultado de la búsqueda. El valor tiene escape de URL para que sea adecuado para pasar como parámetro de consulta a 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 la cantidad total estimada de resultados, especificada por la etiqueta M, en realidad representa la cantidad exacta la cantidad total de resultados. Consulta la Especificación Filtrado de este documento para obtener más detalles.
Ejemplo	<XT />
Subetiqueta de	RES.
Formato del contenido	Vacío

Resultados XML para consultas de búsqueda de imágenes

Esta solicitud de imagen de ejemplo solicita 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 genera 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 las búsquedas de imágenes.

Ciertos símbolos pueden aparecer al lado de algunas subetiquetas en la definiciones. 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

Definición

La etiqueta <RG> encierra los detalles del resultado de la búsqueda de una imagen individual.

Atributos

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

Subetiqueta de

RES.

RU
Definición	La etiqueta <RU tag> incluye detalles de cada resultado de la búsqueda de imágenes.
Subetiqueta de	R