Search

Respuesta a una solicitud de búsqueda personalizada.

Representación JSON 
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
Campos
kind

string

Es el identificador único del tipo de objeto actual. Para esta API, es customsearch#search.
url

object

El elemento de URL de OpenSearch que define la plantilla para esta API.
url.type

string

El tipo de MIME de la plantilla de URL de OpenSearch para la API de Custom Search JSON.
url.template

string

La plantilla de OpenSearch real para esta API.
queries

object

Contiene uno o más conjuntos de metadatos de consulta, con clave por nombre de rol. Entre los nombres de roles posibles, se incluyen request definidos por los roles de consulta de OpenSearch y dos roles personalizados: nextPage y previousPage.
queries.previousPage[]

object

Metadatos que representan la página de resultados anterior, si corresponde
queries.previousPage[].title

string

Es una descripción de la consulta.
queries.previousPage[].totalResults

string (int64 format)

Cantidad estimada del total de resultados de la búsqueda. Es posible que no sea exacto.
queries.previousPage[].searchTerms

string

Son los términos de búsqueda ingresados por el usuario.
queries.previousPage[].count

integer

Cantidad de resultados de la búsqueda que se muestran en este conjunto.
queries.previousPage[].startIndex

integer

Es el índice del conjunto actual de resultados de la búsqueda en el conjunto total de resultados, donde el índice del primer resultado es 1.
queries.previousPage[].startPage

integer

Es el número de página de este conjunto de resultados, en el que la longitud de la página se establece mediante la propiedad count.
queries.previousPage[].language

string

El idioma de los resultados de la búsqueda.
queries.previousPage[].inputEncoding

string

La codificación de caracteres compatible con las solicitudes de búsqueda.
queries.previousPage[].outputEncoding

string

La codificación de caracteres admitida para los resultados de la búsqueda.
queries.previousPage[].safe

string

Especifica el nivel de SafeSearch utilizado para filtrar los resultados para adultos. Esta es una propiedad personalizada que no se definió en la especificación de OpenSearch. Los valores del parámetro válidos son los siguientes:

  • "off": Inhabilitar SafeSearch

  • "active": Habilitar SafeSearch
queries.previousPage[].cx

string

El identificador de un motor creado con el Panel de control del Motor de Búsqueda Programable. Esta es una propiedad personalizada que no se definió en la especificación de OpenSearch. Este parámetro es obligatorio.
queries.previousPage[].sort

string

Especifica que los resultados deben ordenarse de acuerdo con la expresión especificada. Por ejemplo, ordenar por fecha.
queries.previousPage[].filter

string

Activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta Filtros automáticos para obtener más información acerca de los filtros de resultados de la búsqueda de Google. Los valores válidos para este parámetro son los siguientes:

  • 0: Inhabilitada

  • 1: Habilitado (predeterminado)

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

string

Mejora los resultados de la búsqueda cuyo país de origen coincide con el valor del parámetro. Consulta la sección Códigos de país para obtener una lista de valores válidos.

Especificar un valor de parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto es especialmente cierto para los clientes internacionales y, aún más específicamente, para los clientes de países de habla inglesa fuera de los Estados Unidos.
queries.previousPage[].cr

string

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

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

  • Es 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 Valores del parámetro Country (cr) para obtener una lista de valores válidos para este parámetro.
queries.previousPage[].googleHost

string

Especifica el dominio de Google (por ejemplo, google.com, google.de o google.fr) al que se debe limitar la búsqueda.
queries.previousPage[].disableCnTwTranslation

string

Habilita o inhabilita la función Búsqueda en chino tradicional y simplificado.

Los valores admitidos son los que se detallan a continuación:

  • 0: habilitado (predeterminado)

  • 1: Inhabilitada
queries.previousPage[].hq

string

Agrega los términos de consulta especificados, como si se combinaran con un operador lógico AND.
queries.previousPage[].hl

string

Especifica el idioma de la interfaz (idioma del host) de tu interfaz de usuario. La configuración explícita de este parámetro mejora el rendimiento y la calidad de tus resultados de la búsqueda.

Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información, y Idiomas de interfaz admitidos para obtener una lista de idiomas admitidos.
queries.previousPage[].siteSearch

string

Restringe los resultados a las URLs de un sitio específico.
queries.previousPage[].siteSearchFilter

string

Especifica si se deben incluir o excluir resultados del sitio nombrado en el parámetro sitesearch. Los valores admitidos son los que se detallan a continuación:

  • i: Incluye contenido del sitio.

  • e: Excluye contenido del sitio.
queries.previousPage[].exactTerms

string

Identifica una frase que deben contener todos los documentos de los resultados de la búsqueda.
queries.previousPage[].excludeTerms

string

Identifica una palabra o frase que no debería aparecer en ningún documento en los resultados de la búsqueda.
queries.previousPage[].linkSite

string

Especifica que todos los resultados deben contener un vínculo a una URL específica.
queries.previousPage[].orTerms

string

Proporciona términos de búsqueda adicionales para buscar en un documento, donde cada documento de los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda adicionales. También puedes usar el término de consulta O booleano para este tipo de consulta.
queries.previousPage[].relatedSite

string

Especifica que todos los resultados de la búsqueda deben ser páginas relacionadas con la URL especificada. El valor del parámetro debe ser una URL.
queries.previousPage[].dateRestrict

string

Restringe los resultados a las URLs en función de la fecha. Entre los valores admitidos, se incluyen los siguientes:

  • 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 los resultados de la cantidad especificada de meses anteriores.

  • y[number]: Solicita resultados de la cantidad especificada de años anteriores.
queries.previousPage[].lowRange

string

Especifica el valor inicial para un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.
queries.previousPage[].highRange

string

Especifica el valor final de un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.
queries.previousPage[].fileType

string

Restringe los resultados a los archivos de una extensión especificada. 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 (wk1, wk2, wk3, wk4, wk5, wki, wks y wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato de texto enriquecido (rtf)

  • Flash de ondas de choque (swf)

  • Texto (ans, txt).

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

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.previousPage[].searchType

string

Los valores permitidos son web o image. Si no se especifica, los resultados se limitan a páginas web.
queries.previousPage[].imgSize

string

Restringe los resultados a imágenes de un tamaño específico. Los valores admitidos son los que se detallan a continuación:

  • icon (pequeña)

  • small | medium | large | xlarge (media)

  • xxlarge (grande)

  • huge (extragrande)
queries.previousPage[].imgType

string

Restringe los resultados a imágenes de un tipo específico. Los valores admitidos son los que se detallan a continuación:

  • clipart (imágenes prediseñadas)

  • face (rostro)

  • lineart (Dibujo de líneas)

  • photo (foto)

  • animated (animado)

  • stock (stock)
queries.previousPage[].imgColorType

string

Restringe los resultados a imágenes de un tipo de color específico. Los valores admitidos son los siguientes:

  • mono (blanco y negro)

  • gray (escala de grises)

  • color (color)
queries.previousPage[].imgDominantColor

string

Restringe los resultados a las imágenes con un color dominante específico. Los valores admitidos son los que se detallan a continuación:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.request[]

object

Metadatos que representan la solicitud actual
queries.request[].title

string

Es una descripción de la consulta.
queries.request[].totalResults

string (int64 format)

Cantidad estimada del total de resultados de la búsqueda. Es posible que no sea exacto.
queries.request[].searchTerms

string

Son los términos de búsqueda ingresados por el usuario.
queries.request[].count

integer

Cantidad de resultados de la búsqueda que se muestran en este conjunto.
queries.request[].startIndex

integer

Es el índice del conjunto actual de resultados de la búsqueda en el conjunto total de resultados, donde el índice del primer resultado es 1.
queries.request[].startPage

integer

Es el número de página de este conjunto de resultados, en el que la longitud de la página se establece mediante la propiedad count.
queries.request[].language

string

El idioma de los resultados de la búsqueda.
queries.request[].inputEncoding

string

La codificación de caracteres compatible con las solicitudes de búsqueda.
queries.request[].outputEncoding

string

La codificación de caracteres admitida para los resultados de la búsqueda.
queries.request[].safe

string

Especifica el nivel de SafeSearch utilizado para filtrar los resultados para adultos. Esta es una propiedad personalizada que no se definió en la especificación de OpenSearch. Los valores del parámetro válidos son los siguientes:

  • "off": Inhabilitar SafeSearch

  • "active": Habilitar SafeSearch
queries.request[].cx

string

El identificador de un motor creado con el Panel de control del Motor de Búsqueda Programable. Esta es una propiedad personalizada que no se definió en la especificación de OpenSearch. Este parámetro es obligatorio.
queries.request[].sort

string

Especifica que los resultados deben ordenarse de acuerdo con la expresión especificada. Por ejemplo, ordenar por fecha.
queries.request[].filter

string

Activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta Filtros automáticos para obtener más información acerca de los filtros de resultados de la búsqueda de Google. Los valores válidos para este parámetro son los siguientes:

  • 0: Inhabilitada

  • 1: Habilitado (predeterminado)

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

string

Mejora los resultados de la búsqueda cuyo país de origen coincide con el valor del parámetro. Consulta la sección Códigos de país para obtener una lista de valores válidos.

Especificar un valor de parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto es especialmente cierto para los clientes internacionales y, aún más específicamente, para los clientes de países de habla inglesa fuera de los Estados Unidos.
queries.request[].cr

string

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

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

  • Es 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 Valores del parámetro Country (cr) para obtener una lista de valores válidos para este parámetro.
queries.request[].googleHost

string

Especifica el dominio de Google (por ejemplo, google.com, google.de o google.fr) al que se debe limitar la búsqueda.
queries.request[].disableCnTwTranslation

string

Habilita o inhabilita la función Búsqueda en chino tradicional y simplificado.

Los valores admitidos son los que se detallan a continuación:

  • 0: habilitado (predeterminado)

  • 1: Inhabilitada
queries.request[].hq

string

Agrega los términos de consulta especificados, como si se combinaran con un operador lógico AND.
queries.request[].hl

string

Especifica el idioma de la interfaz (idioma del host) de tu interfaz de usuario. La configuración explícita de este parámetro mejora el rendimiento y la calidad de tus resultados de la búsqueda.

Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información, y Idiomas de interfaz admitidos para obtener una lista de idiomas admitidos.
queries.request[].siteSearch

string

Restringe los resultados a las URLs de un sitio específico.
queries.request[].siteSearchFilter

string

Especifica si se deben incluir o excluir resultados del sitio nombrado en el parámetro sitesearch. Los valores admitidos son los que se detallan a continuación:

  • i: Incluye contenido del sitio.

  • e: Excluye contenido del sitio.
queries.request[].exactTerms

string

Identifica una frase que deben contener todos los documentos de los resultados de la búsqueda.
queries.request[].excludeTerms

string

Identifica una palabra o frase que no debería aparecer en ningún documento en los resultados de la búsqueda.
queries.request[].linkSite

string

Especifica que todos los resultados deben contener un vínculo a una URL específica.
queries.request[].orTerms

string

Proporciona términos de búsqueda adicionales para buscar en un documento, donde cada documento de los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda adicionales. También puedes usar el término de consulta O booleano para este tipo de consulta.
queries.request[].relatedSite

string

Especifica que todos los resultados de la búsqueda deben ser páginas relacionadas con la URL especificada. El valor del parámetro debe ser una URL.
queries.request[].dateRestrict

string

Restringe los resultados a las URLs en función de la fecha. Entre los valores admitidos, se incluyen los siguientes:

  • 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 los resultados de la cantidad especificada de meses anteriores.

  • y[number]: Solicita resultados de la cantidad especificada de años anteriores.
queries.request[].lowRange

string

Especifica el valor inicial para un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.
queries.request[].highRange

string

Especifica el valor final de un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.
queries.request[].fileType

string

Restringe los resultados a los archivos de una extensión especificada. 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 (wk1, wk2, wk3, wk4, wk5, wki, wks y wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato de texto enriquecido (rtf)

  • Flash de ondas de choque (swf)

  • Texto (ans, txt).

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

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.request[].searchType

string

Los valores permitidos son web o image. Si no se especifica, los resultados se limitan a páginas web.
queries.request[].imgSize

string

Restringe los resultados a imágenes de un tamaño específico. Los valores admitidos son los que se detallan a continuación:

  • icon (pequeña)

  • small | medium | large | xlarge (media)

  • xxlarge (grande)

  • huge (extragrande)
queries.request[].imgType

string

Restringe los resultados a imágenes de un tipo específico. Los valores admitidos son los que se detallan a continuación:

  • clipart (imágenes prediseñadas)

  • face (rostro)

  • lineart (Dibujo de líneas)

  • photo (foto)

  • animated (animado)

  • stock (stock)
queries.request[].imgColorType

string

Restringe los resultados a imágenes de un tipo de color específico. Los valores admitidos son los siguientes:

  • mono (blanco y negro)

  • gray (escala de grises)

  • color (color)
queries.request[].imgDominantColor

string

Restringe los resultados a las imágenes con un color dominante específico. Los valores admitidos son los que se detallan a continuación:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.nextPage[]

object

Metadatos que representan la siguiente página de resultados, si corresponde
queries.nextPage[].title

string

Es una descripción de la consulta.
queries.nextPage[].totalResults

string (int64 format)

Cantidad estimada del total de resultados de la búsqueda. Es posible que no sea exacto.
queries.nextPage[].searchTerms

string

Son los términos de búsqueda ingresados por el usuario.
queries.nextPage[].count

integer

Cantidad de resultados de la búsqueda que se muestran en este conjunto.
queries.nextPage[].startIndex

integer

Es el índice del conjunto actual de resultados de la búsqueda en el conjunto total de resultados, donde el índice del primer resultado es 1.
queries.nextPage[].startPage

integer

Es el número de página de este conjunto de resultados, en el que la longitud de la página se establece mediante la propiedad count.
queries.nextPage[].language

string

El idioma de los resultados de la búsqueda.
queries.nextPage[].inputEncoding

string

La codificación de caracteres compatible con las solicitudes de búsqueda.
queries.nextPage[].outputEncoding

string

La codificación de caracteres admitida para los resultados de la búsqueda.
queries.nextPage[].safe

string

Especifica el nivel de SafeSearch utilizado para filtrar los resultados para adultos. Esta es una propiedad personalizada que no se definió en la especificación de OpenSearch. Los valores del parámetro válidos son los siguientes:

  • "off": Inhabilitar SafeSearch

  • "active": Habilitar SafeSearch
queries.nextPage[].cx

string

El identificador de un motor creado con el Panel de control del Motor de Búsqueda Programable. Esta es una propiedad personalizada que no se definió en la especificación de OpenSearch. Este parámetro es obligatorio.
queries.nextPage[].sort

string

Especifica que los resultados deben ordenarse de acuerdo con la expresión especificada. Por ejemplo, ordenar por fecha.
queries.nextPage[].filter

string

Activa o desactiva el filtrado automático de los resultados de la Búsqueda de Google. Consulta Filtrado automático para obtener más información acerca de los filtros de los resultados de la búsqueda de Google. Los valores válidos para este parámetro son los siguientes:

  • 0: Inhabilitada

  • 1: Habilitado (predeterminado)

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

string

Mejora los resultados de la búsqueda cuyo país de origen coincide con el valor del parámetro. Consulta la sección Códigos de país para obtener una lista de valores válidos.

Especificar un valor de parámetro gl en las solicitudes de WebSearch debería mejorar la relevancia de los resultados. Esto es especialmente cierto para los clientes internacionales y, aún más específicamente, para los clientes de países de habla inglesa fuera de los Estados Unidos.
queries.nextPage[].cr

string

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

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

  • Es 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 Valores del parámetro Country (cr) para obtener una lista de valores válidos para este parámetro.
queries.nextPage[].googleHost

string

Especifica el dominio de Google (por ejemplo, google.com, google.de o google.fr) al que se debe limitar la búsqueda.
queries.nextPage[].disableCnTwTranslation

string

Habilita o inhabilita la función Búsqueda en chino tradicional y simplificado.

Los valores admitidos son los que se detallan a continuación:

  • 0: habilitado (predeterminado)

  • 1: Inhabilitada
queries.nextPage[].hq

string

Agrega los términos de consulta especificados, como si se combinaran con un operador lógico AND.
queries.nextPage[].hl

string

Especifica el idioma de la interfaz (idioma del host) de tu interfaz de usuario. La configuración explícita de este parámetro mejora el rendimiento y la calidad de tus resultados de la búsqueda.

Consulta la sección Idiomas de interfaz de Internacionalización de consultas y presentación de resultados para obtener más información, y Idiomas de interfaz admitidos para obtener una lista de idiomas admitidos.
queries.nextPage[].siteSearch

string

Restringe los resultados a las URLs de un sitio específico.
queries.nextPage[].siteSearchFilter

string

Especifica si se deben incluir o excluir resultados del sitio nombrado en el parámetro sitesearch. Los valores admitidos son los que se detallan a continuación:

  • i: Incluye contenido del sitio.

  • e: Excluye contenido del sitio.
queries.nextPage[].exactTerms

string

Identifica una frase que deben contener todos los documentos de los resultados de la búsqueda.
queries.nextPage[].excludeTerms

string

Identifica una palabra o frase que no debería aparecer en ningún documento en los resultados de la búsqueda.
queries.nextPage[].linkSite

string

Especifica que todos los resultados deben contener un vínculo a una URL específica.
queries.nextPage[].orTerms

string

Proporciona términos de búsqueda adicionales para buscar en un documento, donde cada documento de los resultados de la búsqueda debe contener al menos uno de los términos de búsqueda adicionales. También puedes usar el término de consulta O booleano para este tipo de consulta.
queries.nextPage[].relatedSite

string

Especifica que todos los resultados de la búsqueda deben ser páginas relacionadas con la URL especificada. El valor del parámetro debe ser una URL.
queries.nextPage[].dateRestrict

string

Restringe los resultados a las URLs en función de la fecha. Entre los valores admitidos, se incluyen los siguientes:

  • 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 los resultados de la cantidad especificada de meses anteriores.

  • y[number]: Solicita resultados de la cantidad especificada de años anteriores.
queries.nextPage[].lowRange

string

Especifica el valor inicial para un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.
queries.nextPage[].highRange

string

Especifica el valor final de un rango de búsqueda. Usa cse:lowRange y cse:highrange para agregar un rango de búsqueda inclusivo de lowRange...highRange a la consulta.
queries.nextPage[].fileType

string

Restringe los resultados a los archivos de una extensión especificada. 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 (wk1, wk2, wk3, wk4, wk5, wki, wks y wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft Write (wri)

  • Formato de texto enriquecido (rtf)

  • Flash de ondas de choque (swf)

  • Texto (ans, txt).

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

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.nextPage[].searchType

string

Los valores permitidos son web o image. Si no se especifica, los resultados se limitan a páginas web.
queries.nextPage[].imgSize

string

Restringe los resultados a imágenes de un tamaño específico. Los valores admitidos son los que se detallan a continuación:

  • icon (pequeña)

  • small | medium | large | xlarge (media)

  • xxlarge (grande)

  • huge (extragrande)
queries.nextPage[].imgType

string

Restringe los resultados a imágenes de un tipo específico. Los valores admitidos son los que se detallan a continuación:

  • clipart (imágenes prediseñadas)

  • face (rostro)

  • lineart (Dibujo de líneas)

  • photo (foto)

  • animated (animado)

  • stock (stock)
queries.nextPage[].imgColorType

string

Restringe los resultados a imágenes de un tipo de color específico. Los valores admitidos son los siguientes:

  • mono (blanco y negro)

  • gray (escala de grises)

  • color (color)
queries.nextPage[].imgDominantColor

string

Restringe los resultados a las imágenes con un color dominante específico. Los valores admitidos son los que se detallan a continuación:

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
promotions[]

object (Promotion)

Es el conjunto de promociones. Solo está presente si los archivos de configuración del motor de búsqueda personalizado definen promociones para la búsqueda determinada.
context

object (Struct format)

Metadatos y mejoras asociados con un motor de búsqueda determinado, incluidos:

  • El nombre del motor de búsqueda que se usó para la consulta.

  • Un conjunto de objetos de facetas (perfeccionamientos) que puedes usar para definir mejor una búsqueda.
searchInformation

object

Metadatos sobre esta búsqueda, incluidos el tiempo de búsqueda y el total de resultados.
searchInformation.searchTime

number

El tiempo que tarda el servidor en mostrar los resultados de la búsqueda.
searchInformation.formattedSearchTime

string

El tiempo que tarda el servidor en mostrar los resultados de la búsqueda, con un formato acorde al estilo de la configuración regional.
searchInformation.totalResults

string

La cantidad total de resultados de la búsqueda que muestra la consulta.
searchInformation.formattedTotalResults

string

Es la cantidad total de resultados de la búsqueda, con el formato según el estilo de la configuración regional.
spelling

object

Encapsula una consulta corregida.
spelling.correctedQuery

string

La consulta corregida.
spelling.htmlCorrectedQuery

string

La consulta corregida, con formato HTML.
items[]

object (Result)

Es el conjunto actual de resultados de la búsqueda personalizados.

Promoción

Resultado de la promoción.

Representación JSON 
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
Campos
title

string

Es el título de la promoción.
htmlTitle

string

Es el título de la promoción en HTML.
bodyLines[]

object

Un array de objetos de bloque para esta promoción.
bodyLines[].title

string

El texto del objeto de bloque, si tiene texto.
bodyLines[].htmlTitle

string

El texto del objeto de bloque en HTML, si tiene texto
bodyLines[].url

string

La URL del vínculo del objeto de bloqueo, si tiene uno.
bodyLines[].link

string

El texto de anclaje del vínculo del objeto de bloque, si este tiene un vínculo.
image

object

Imagen asociada con esta promoción, si la hay.
image.source

string

URL de la imagen de este vínculo de promoción.
image.width

integer

Ancho de la imagen en píxeles.
image.height

integer

Es la altura de la imagen en píxeles.

Resultado

Un resultado de la búsqueda personalizado.

Representación JSON 
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
Campos
kind

string

Un identificador único para el tipo de objeto actual. Para esta API, es customsearch#result.
title

string

El título del resultado de la búsqueda, en texto sin formato.
htmlTitle

string

Es el título del resultado de la búsqueda, en HTML.
snippet

string

El fragmento del resultado de la búsqueda, en texto sin formato.
htmlSnippet

string

Es el fragmento del resultado de la búsqueda, en HTML.
cacheId

string

Indica el ID de la versión almacenada en caché de Google del resultado de la búsqueda.
formattedUrl

string

Es la URL que se muestra después del fragmento para cada resultado de la búsqueda.
htmlFormattedUrl

string

Es la URL con formato HTML que se muestra después del fragmento para cada resultado de la búsqueda.
pagemap

object (Struct format)

Contiene información de PageMap para este resultado de búsqueda.
mime

string

Es el tipo de MIME del resultado de la búsqueda.
fileFormat

string

Es el formato de archivo del resultado de la búsqueda.
image

object

Encapsula toda la información sobre una imagen que se muestra en los resultados de la búsqueda.
image.contextLink

string

Es una URL que dirige a la página web que aloja la imagen.
image.height

integer

Es la altura de la imagen en píxeles.
image.width

integer

Es el ancho de la imagen en píxeles.
image.byteSize

integer

El tamaño de la imagen en bytes.
image.thumbnailLink

string

Una URL a la imagen en miniatura.
image.thumbnailHeight

integer

La altura de la imagen en miniatura en píxeles.
image.thumbnailWidth

integer

El ancho de la imagen en miniatura en píxeles.
labels[]

object

Encapsula toda la información sobre las etiquetas de perfeccionamiento.
labels[].name

string

Es el nombre de una etiqueta de mejora, que puedes usar para definir mejor las búsquedas. No la muestres en tu interfaz de usuario. en su lugar, usa displayName.
labels[].displayName

string

El nombre visible de una etiqueta de mejora. Este es el nombre que debes mostrar en tu interfaz de usuario.
labels[].label_with_op

string

Etiqueta de perfeccionamiento y la operación de perfeccionamiento asociada.