Referencia de la API de JSON

Booleano O Búsqueda [ O ]
Descripción

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

También puedes usar el parámetro de solicitud “as_oq” (como “as_oq=Londres+París”) 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+OR+París", los resultados de la búsqueda incluirán documentos que contengan al menos una de esas dos palabras. En algunos casos, los documentos de los resultados de la búsqueda pueden contener ambas palabras.
Ejemplos

Busca Londres o París:

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

Busca vacaciones en Londres o París:

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

Si buscas vacaciones, una de Londres, París o chocolates:

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

En busca de vacaciones y chocolates, o londres o París, donde menos peso se le da a los chocolates:

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

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

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

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

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

Operadores booleanos

Puedes utilizar operadores booleanos en los valores de los siguientes parámetros:

  • cr
  • lr

Definiciones de operadores booleanos

Nota: No puedes incluir espacios en los valores de los parámetros.

Booleano AND [.]
Descripción

El operador AND (.) muestra los resultados que se encuentran en la intersección de las colecciones a ambos lados del operador ".".
Ejemplos

En este ejemplo, se quitan todos los resultados que están en francés o italiano:
lr=(-lang_fr).(-lang_it)

Booleano NOT [-]
Descripción

El operador NOT (-) quita todos los resultados que están en la colección inmediatamente después del operador menos ("-").
Ejemplos

En este ejemplo, se quitan todos los resultados que están en francés:
lr=-lang_fr

En este ejemplo, se quitan todos los resultados que están en francés o italiano:
lr=(-lang_fr).(-lang_it)

Nota: Quizás hayas notado que el segundo ejemplo anterior usa el operador booleano Y para especificar que los resultados no deben escribirse en francés ni italiano. Según la ubicación de los paréntesis en tu consulta, puedes usar el operador Booleano AND o el operador boolean OR para expresar esta consulta. Esto se debe a que, si un documento está escrito en francés, no está escrito en italiano. Por lo tanto, la declaración booleana debe expresar que el documento no está escrito en francés y que no está escrito en italiano.

Booleano OR [|]
Descripción

El operador OR (|) muestra los resultados que se encuentran en la colección a la izquierda o a la derecha del operador de canalización (“|”).
Ejemplos

En este ejemplo, se muestran todos los resultados escritos en chino simplificado o tradicional:
lr=lang_zh-TW|lang_zh-CN

En este ejemplo, se solicitan todos los resultados que no están escritos en francés ni italiano. Observa que coloca paréntesis en una ubicación diferente a la de la consulta de muestra para el operador boolean AND:
lr=-(lang_fr|lang_it)


Paréntesis booleanos [()]
Descripción

Este operador te permite asegurarte de que se evalúen todos los términos del conjunto más interno de paréntesis antes de que se evalúen los que están fuera de los paréntesis. Puedes usar paréntesis para ajustar el orden en el que se evalúan los términos.
Ejemplos

En el ejemplo del operador NOT [-], se muestra la siguiente construcción para los resultados de solicitudes que no están escritos en francés ni italiano:
lr=(-lang_fr).(-lang_it)

En el ejemplo del operador OR (|), también se muestra una solicitud de resultados que no están escritos en francés o italiano. Dado que en el último ejemplo se usa el operador OR en lugar del operador AND, también debe cambiar la ubicación de los paréntesis:
lr=-(lang_fr|lang_it)

Internacionalización de consultas y presentación de resultados

El servicio Google WebSearch te permite buscar documentos en varios idiomas. Puedes especificar la codificación de caracteres que se debe usar para interpretar tu solicitud HTTP y codificar tu respuesta. También puedes filtrar los resultados para incluir solo documentos escritos en ciertos idiomas.

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

Idiomas de 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 la búsqueda, especialmente en las consultas internacionales cuando la restricción de idioma (mediante el parámetro "lr") no se especifica de forma explícita. En esos casos, el parámetro "hl" puede promover resultados de la búsqueda en el mismo idioma que el idioma de entrada del usuario.

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

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

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

Para usar esta función, sigue estos pasos:

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

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

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

Cómo filtrar resultados

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

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

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

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

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

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

Cómo filtrar contenido para adultos con SafeSearch

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

Google se esfuerza por mantener SafeSearch lo más actualizado y completo posible mediante el rastreo continuo de la Web y la incorporación de actualizaciones de las sugerencias de los usuarios.

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

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

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

Valores internacionales

Idiomas de interfaz compatibles

Google admite más de 80 idiomas. El idioma de interfaz predeterminado es inglés. En la siguiente lista, se identifican todos los idiomas de interfaz que Google admite.

Idioma de visualización Valor del parámetro hl
Afrikáans af
Albanés sq
Amárico sm
Árabe ar
Azerí az
Vasco eu
Bielorruso be
Bengalí bn
Bihari bh
Bosnio bs
Búlgaro bg
Catalán ca
Chino (simplificado) zh-CN
Chino (tradicional) zh-TW
Croata hr
Checo cs
Danés da
Holandés nl
Inglés en
Esperanto eo
Estonio et
Feroés fo
Finlandés fi
Francés fr
Frisón fy
Galego gl
Georgiano ka
Alemán de
Griego el
Guyaratí gu
Hebreo iw
Hindi hi
Húngaro hu
Islandés is
Indonesio id
Interlingua ia
Irlandés ga
Italiano it
Japonés ja
Javanés jw
Canarés kn
Coreano ko
Latín la
Letón lv
Lituano lt
Macedonio mk
Malayo ms
Malayam ml
Maltés mt
Maratí mr
Nepalí ne
Noruego no
Noruego (Nynorsk) nn
Occitano oc
Persa fa
Polaco pl
Portugués (Brasil) pt-BR
Portugués (Portugal) pt-PT
Panyabí pa
Rumano ro
Ruso ru
Gaélico escocés gd
Serbio sr
Cingalés si
Eslovaco sk
Esloveno sl
Español es
Sudanés su
Suajili sw
Sueco sv
Tagalo tl
Tamil ta
Télugu te
Tailandés th
Tigrinya ti
Turco tr
Ucraniano uk
Urdu ur
Uzbeko uz
Vietnamita vi
Galés cy
Xhosa xh
Zulú zu

Valores de la recopilación de países

Puedes usar los siguientes valores para especificar un filtro de país mediante el parámetro de consulta "cr":

País Nombre de la colección del país
Afganistán countryAF
Albania countryAL
Argelia countryDZ
Samoa Americana countryAS
Andorra countryAD
Angola countryAO
Anguila countryAI
Antártida countryAQ
Antigua y Barbuda countryAG
Argentina countryAR
Armenia countryAM
Aruba countryAW
Australia countryAU
Austria countryAT
Azerbaiyán countryAZ
Bahamas countryBS
Baréin countryBH
Bangladés countryBD
Barbados countryBB
Bielorrusia countryBY
Bélgica countryBE
Belice countryBZ
Benín countryBJ
Bermudas countryBM
Bután countryBT
Bolivia countryBO
Bosnia y Herzegovina countryBA
Botsuana countryBW
Isla Bouvet countryBV
Brasil countryBR
Territorio Británico del Océano Índico countryIO
Brunéi Darussalam countryBN
Bulgaria countryBG
Burkina Faso countryBF
Burundi countryBI
Camboya countryKH
Camerún countryCM
Canadá countryCA
Cabo Verde countryCV
Islas Caimán countryKY
República Centroafricana countryCF
Chad countryTD
Chile countryCL
China countryCN
Isla de Navidad countryCX
Islas Cocos countryCC
Colombia countryCO
Comoras countryKM
Congo countryCG
República Democrática del Congo countryCD
Islas Cook countryCK
Costa Rica countryCR
Costa de Marfil countryCI
Croacia (Hrvatska) countryHR
Cuba countryCU
Chipre countryCY
República Checa countryCZ
Dinamarca countryDK
Yibuti countryDJ
Dominica countryDM
República Dominicana countryDO
Timor Oriental countryTP
Ecuador countryEC
Egipto countryEG
El Salvador countrySV
Guinea Ecuatorial countryGQ
Eritrea countryER
Estonia countryEE
Etiopía countryET
Unión Europea countryEU
Islas Malvinas countryFK
Islas Feroe countryFO
Fiyi countryFJ
Finlandia countryFI
Francia countryFR
Francia, metrópolis countryFX
Guayana Francesa countryGF
Polinesia Francesa countryPF
Territorios Australes Franceses countryTF
Gabón countryGA
Gambia countryGM
Georgia countryGE
Alemania countryDE
Ghana countryGH
Gibraltar countryGI
Grecia countryGR
Groenlandia countryGL
Granada countryGD
Guadalupe countryGP
Guam countryGU
Guatemala countryGT
Guinea countryGN
Guinea-Bisáu countryGW
Guyana countryGY
Haití countryHT
Islas Heard y McDonald countryHM
Santa Sede (Estado de la Ciudad del Vaticano) countryVA
Honduras countryHN
Hong Kong countryHK
Hungría countryHU
Islandia countryIS
India countryIN
Indonesia countryID
Irán, República Islámica de countryIR
Irak countryIQ
Irlanda countryIE
Israel countryIL
Italia countryIT
Jamaica countryJM
Japón countryJP
Jordania countryJO
Kazajistán countryKZ
Kenia countryKE
Kiribati countryKI
Corea, República Democrática Popular de countryKP
República de Corea countryKR
Kuwait countryKW
Kirguistán countryKG
República Democrática Popular Lao countryLA
Letonia countryLV
Líbano countryLB
Lesoto countryLS
Liberia countryLR
Yamahiriya Árabe Libia countryLY
Liechtenstein countryLI
Lituania countryLT
Luxemburgo countryLU
Macao countryMO
Macedonia, Antigua República Yugosalva de countryMK
Madagascar countryMG
Malaui countryMW
Malasia countryMY
Maldivas countryMV
Malí countryML
Malta countryMT
Islas Marshall countryMH
Martinica countryMQ
Mauritania countryMR
Mauricio countryMU
Mayotte countryYT
México countryMX
Estados Federados de Micronesia countryFM
República de Moldavia countryMD
Mónaco countryMC
Mongolia countryMN
Montserrat countryMS
Marruecos countryMA
Mozambique countryMZ
Birmania countryMM
Namibia countryNA
Nauru countryNR
Nepal countryNP
Países Bajos countryNL
Antillas Neerlandesas countryAN
Nueva Caledonia countryNC
Nueva Zelanda countryNZ
Nicaragua countryNI
Níger countryNE
Nigeria countryNG
Niue countryNU
Isla Norfolk countryNF
Islas Marianas del Norte countryMP
Noruega countryNO
Omán countryOM
Pakistán countryPK
Palau countryPW
Territorio Palestino countryPS
Panamá countryPA
Papúa Nueva Guinea countryPG
Paraguay countryPY
Perú countryPE
Filipinas countryPH
Islas Pitcairn countryPN
Polonia countryPL
Portugal countryPT
Puerto Rico countryPR
Catar countryQA
Reunión countryRE
Rumania countryRO
Federación Rusa countryRU
Ruanda countryRW
Santa Elena countrySH
San Cristóbal y Nieves countryKN
Santa Lucía countryLC
San Pedro y Miquelón countryPM
San Vicente y las Granadinas countryVC
Samoa countryWS
San Marino countrySM
Santo Tomé y Príncipe countryST
Arabia Saudita countrySA
Senegal countrySN
Serbia y Montenegro countryCS
Seychelles countrySC
Sierra Leona countrySL
Singapur countrySG
Eslovaquia countrySK
Eslovenia countrySI
Islas Salomón countrySB
Somalia countrySO
Sudáfrica countryZA
Islas Georgia y Sándwich del Sur countryGS
España countryES
Sri Lanka countryLK
Sudán countrySD
Surinam countrySR
Svalbard y Jan Mayen countrySJ
Suazilandia countrySZ
Suecia countrySE
Suiza countryCH
República Árabe Siria countrySY
Taiwán, provincia de China countryTW
Tayikistán countryTJ
República Unida de Tanzania countryTZ
Tailandia countryTH
Togo countryTG
Tokelau countryTK
Tonga countryTO
Trinidad y Tobago countryTT
Túnez countryTN
Turquía countryTR
Turkmenistán countryTM
Islas Turcas y Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ucrania countryUA
Emiratos Árabes Unidos countryAE
Reino Unido countryUK
Estados Unidos countryUS
Islas menores alejadas de los Estados Unidos countryUM
Uruguay countryUY
Uzbekistán countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnam countryVN
Islas Vírgenes Británicas countryVG
Islas Vírgenes, EE.UU. countryVI
Wallis y Futuna countryWF
Sahara Occidental countryEH
Yemen countryYE
Yugoslavia countryYU
Zambia countryZM
Zimbabue countryZW

Códigos de país

En la siguiente tabla, se indican los códigos de país de dos letras que se pueden usar como valores del parámetro "gl":

País Código de país
Afganistán af
Albania al
Argelia dz
Samoa Americana as
Andorra ad
Angola ao
Anguila ai
Antártida aq
Antigua y Barbuda ag
Argentina ar
Armenia am
Aruba aw
Australia au
Austria at
Azerbaiyán az
Bahamas bs
Baréin bh
Bangladés bd
Barbados bb
Bielorrusia by
Bélgica be
Belice bz
Benín bj
Bermudas bm
Bután bt
Bolivia bo
Bosnia y Herzegovina ba
Botsuana bw
Isla Bouvet bv
Brasil br
Territorio Británico del Océano Índico io
Brunéi Darussalam bn
Bulgaria bg
Burkina Faso bf
Burundi bi
Camboya kh
Camerún cm
Canadá ca
Cabo Verde cv
Islas Caimán ky
República Centroafricana cf
Chad td
Chile cl
China cn
Isla de Navidad cx
Islas Cocos cc
Colombia co
Comoras km
Congo cg
República Democrática del Congo cd
Islas Cook ck
Costa Rica cr
Costa de Marfil ci
Croacia hr
Cuba cu
Chipre cy
República Checa cz
Dinamarca dk
Yibuti dj
Dominica dm
República Dominicana do
Ecuador ec
Egipto eg
El Salvador sv
Guinea Ecuatorial gq
Eritrea er
Estonia ee
Etiopía et
Islas Malvinas fk
Islas Feroe fo
Fiyi fj
Finlandia fi
Francia fr
Guayana Francesa gf
Polinesia Francesa pf
Territorios Australes Franceses tf
Gabón ga
Gambia gm
Georgia ge
Alemania de
Ghana gh
Gibraltar gi
Grecia gr
Groenlandia gl
Granada gd
Guadalupe gp
Guam gu
Guatemala gt
Guinea gn
Guinea-Bisáu gw
Guyana gy
Haití ht
Islas Heard y McDonald hm
Santa Sede (Estado de la Ciudad del Vaticano) va
Honduras hn
Hong Kong hk
Hungría hu
Islandia is
India in
Indonesia id
Irán, República Islámica de ir
Irak iq
Irlanda ie
Israel il
Italia it
Jamaica jm
Japón jp
Jordania jo
Kazajistán kz
Kenia ke
Kiribati ki
Corea, República Democrática Popular de kp
República de Corea kr
Kuwait kw
Kirguistán kg
República Democrática Popular Lao la
Letonia lv
Líbano lb
Lesoto ls
Liberia lr
Yamahiriya Árabe Libia ly
Liechtenstein li
Lituania lt
Luxemburgo lu
Macao mo
Macedonia, Antigua República Yugosalva de mk
Madagascar mg
Malaui mw
Malasia my
Maldivas mv
Malí ml
Malta mt
Islas Marshall mh
Martinica mq
Mauritania mr
Mauricio mu
Mayotte yt
México mx
Estados Federados de Micronesia fm
República de Moldavia md
Mónaco mc
Mongolia mn
Montserrat ms
Marruecos ma
Mozambique mz
Birmania mm
Namibia na
Nauru nr
Nepal np
Países Bajos nl
Antillas Neerlandesas an
Nueva Caledonia nc
Nueva Zelanda nz
Nicaragua ni
Níger ne
Nigeria ng
Niue nu
Isla Norfolk nf
Islas Marianas del Norte mp
Noruega no
Omán om
Pakistán pk
Palaos pw
Territorios Palestinos Ocupados ps
Panamá pa
Papúa Nueva Guinea pg
Paraguay py
Perú pe
Filipinas ph
Islas Pitcairn pn
Polonia pl
Portugal pt
Puerto Rico pr
Catar qa
Reunión re
Rumania ro
Federación Rusa ru
Ruanda rw
Santa Elena sh
San Cristóbal y Nieves kn
Santa Lucía lc
San Pedro y Miquelón pm
San Vicente y las Granadinas vc
Samoa ws
San Marino sm
Santo Tomé y Príncipe st
Arabia Saudita sa
Senegal sn
Serbia y Montenegro cs
Seychelles sc
Sierra Leona sl
Singapur sg
Eslovaquia sk
Eslovenia si
Islas Salomón sb
Somalia so
Sudáfrica za
Islas Georgia y Sándwich del Sur gs
España es
Sri Lanka lk
Sudán sd
Surinam sr
Svalbard y Jan Mayen sj
Suazilandia sz
Suecia se
Suiza ch
República Árabe Siria sy
Taiwán, provincia de China tw
Tayikistán tj
República Unida de Tanzania tz
Tailandia th
Timor Oriental tl
Togo tg
Tokelau tk
Tonga to
Trinidad y Tobago tt
Túnez tn
Turquía tr
Turkmenistán tm
Islas Turcas y Caicos tc
Tuvalu tv
Uganda ug
Ucrania ua
Emiratos Árabes Unidos ae
Reino Unido uk
Estados Unidos us
Islas menores alejadas de los Estados Unidos um
Uruguay uy
Uzbekistán uz
Vanuatu vu
Venezuela ve
Vietnam vn
Islas Vírgenes Británicas vg
Islas Vírgenes, EE.UU. vi
Wallis y Futuna wf
Sahara Occidental eh
Yemen ye
Zambia zm
Zimbabue zw