Referência da API JSON

Booleano OR Pesquisa [ OR ]
Descrição

O termo de consulta OR recupera documentos que incluem um de uma série de dois ou mais termos de consulta. Para usar o termo de consulta OR, insira o termo de pesquisa OR, em letras maiúsculas, entre cada termo da série.

Você também pode usar o parâmetro de solicitação "as_oq" (como "as_oq=Londres+Paris") para enviar uma pesquisa por qualquer termo em um conjunto de termos.

Observação:se uma solicitação de pesquisa especificar a consulta "Londres+OR+Paris", os resultados da pesquisa vão incluir documentos que contenham pelo menos uma dessas duas palavras. Em alguns casos, os documentos nos resultados da pesquisa podem conter as duas palavras.
Exemplos

Pesquisar Londres ou Paris:

Entrada do usuário:london OR paris Termo de consulta:q=london+OR+paris

Pesquise férias e Londres ou Paris:

Termo de consulta:q=vacation+london+OR+paris

Pesquise férias e outra cidade em Londres, Paris ou chocolates:

Termo de consulta:  q=vacation+london+OR+paris+OR+chocolates

Pesquise férias e chocolates e Londres ou Paris, com o menor peso dado aos chocolates:

Termo de consulta:  q=vacation+london+OR+paris+chocolates

Pesquise férias, chocolates e flores em documentos que também contenham Londres ou Paris:

Termo de consulta:  q=vacation+london+OR+paris+chocolates+flowers

Pesquise férias e um em Londres ou Paris e também pesquise um dos chocolates ou flores:

Termo de consulta:  q=vacation+london+OR+paris+chocolates+OR+flowers

Operadores booleanos

Você pode usar operadores booleanos em valores para os seguintes parâmetros:

  • cr
  • lr

Definições de operadores booleanos

Observação: não é possível incluir espaços nos valores de parâmetro.

Booleano AND [.]
Descrição

O operador AND (.) retorna resultados que estão na interseção das coleções em ambos os lados do operador ".".
Exemplos

Este exemplo remove todos os resultados em francês ou italiano:
lr=(-lang_fr).(-lang_it)

Booleano NOT [-]
Descrição

O operador NOT (-) remove todos os resultados que estão na coleção imediatamente após o operador de menos ("-").
Exemplos

Este exemplo remove todos os resultados em francês:
lr=-lang_fr

Este exemplo remove todos os resultados em francês ou italiano:
lr=(-lang_fr).(-lang_it)

Observação: você pode ter notado que o segundo exemplo acima usa o operador Booleano AND para especificar que os resultados não devem ser escritos em francês ou italiano. Dependendo do posicionamento dos parênteses na consulta, é possível usar o operador Booleano AND ou o operador Booleano OR para expressar a consulta. Isso ocorre porque, se um documento for escrito em francês, ele não será escrito em italiano. Portanto, sua declaração booleana precisa expressar que o documento não está escrito em francês e que o documento não está em italiano.

Booleano OR [|]
Descrição

O operador OR (|) retorna resultados que estão na coleção à esquerda ou na coleção à direita do operador de barra vertical ("|").
Exemplos

Este exemplo retorna todos os resultados escritos em chinês simplificado ou tradicional:
lr=lang_zh-TW|lang_zh-CN

Este exemplo solicita todos os resultados que não estão escritos em francês ou italiano. Observe que ele coloca parênteses em um local diferente do exemplo de consulta para o operador Booleano AND:
lr=-(lang_fr|lang_it)


Parênteses booleanos [()]
Descrição

Com esse operador, você garante que todos os termos no conjunto mais interno de parênteses sejam avaliados antes que os termos fora dos parênteses sejam avaliados. Use parênteses para ajustar a ordem em que os termos são avaliados.
Exemplos

O exemplo do operador NOT [-] mostra a seguinte construção para resultados de solicitações que não estão em francês ou italiano:
lr=(-lang_fr).(-lang_it)

O exemplo do operador OR (|) também mostra uma solicitação de resultados não escritos em francês do italiano. Como o último exemplo usa o operador OR em vez do operador AND, ele também precisa alterar o local dos parênteses:
lr=-(lang_fr|lang_it)

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

O serviço Google WebSearch permite pesquisar documentos em vários idiomas. Especifique a codificação de caracteres que precisa ser usada para interpretar a solicitação HTTP e codificar sua resposta. Também é possível filtrar os resultados para incluir apenas documentos escritos em determinados idiomas.

As seções a seguir discutem problemas relacionados à pesquisa em vários idiomas:

Idiomas da interface

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

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

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

O chinês simplificado e o tradicional são duas variantes do idioma chinês. O mesmo conceito pode ser escrito de maneira diferente em cada variante. Dada uma consulta em uma das variantes, o serviço do Google WebSearch pode retornar resultados que incluem páginas em ambas as variantes.

Para usar este recurso, siga estas etapas:

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

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

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

Como filtrar resultados

O Google WebSearch oferece várias maneiras de filtrar os resultados da pesquisa:

Filtragem automática de resultados da pesquisa

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

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

  • Host Crowding (aglomeração de host): se houver muitos resultados da pesquisa do mesmo site, o Google pode não mostrar todos os resultados dele ou mostrar os resultados com uma
    classificação mais baixa do que teriam em outra situação.

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

Como filtrar conteúdo adulto com o SafeSearch

Muitos clientes do Google não querem exibir resultados da pesquisa para sites com conteúdo adulto. Com o filtro SafeSearch, é possível procurar resultados de pesquisa com conteúdo adulto e eliminá-los. Os filtros do Google usam tecnologia reservada para verificar palavras-chave, frases e URLs. Embora nenhum filtro seja 100% preciso, o SafeSearch vai remover a grande maioria do conteúdo adulto dos resultados da pesquisa.

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

É possível ajustar o grau de filtragem do Google pelos resultados de conteúdo adulto usando o parâmetro de consulta "seguro". A tabela a seguir explica as configurações do SafeSearch do Google e como elas afetam seus resultados da pesquisa:

Nível do SafeSearch Descrição
high Ativa uma versão mais rigorosa da pesquisa segura.
medium Bloqueia páginas da Web que contêm pornografia e outros conteúdos sexuais explícitos.
off Não filtra conteúdo adulto nos resultados da pesquisa.

* A configuração padrão do SafeSearch está desativada.

Valores internacionais

Idiomas de interface compatíveis

O Google oferece suporte a mais de 80 idiomas. O idioma padrão da interface é o inglês. A lista a seguir identifica todos os idiomas de interface compatíveis com o Google.

Idioma de exibição Valor do parâmetro hl
Africâner af
Albanês sq
Amárico sm
Árabe ar
Azerbaijano az
Basco eu
Bielorrusso be
Bengali bn
Bihari bh
Bósnio bs
Búlgaro bg
Catalão ca
Chinês (simplificado) zh-CN
Chinês (tradicional) zh-TW
Croata hr
Tcheco cs
Dinamarquês da
Holandês nl
Inglês en
Esperanto eo
Estoniano et
Faroês fo
Finlandês fi
Francês fr
Frísio fy
Galego gl
Georgiano ka
Alemão de
Grego el
Guzerate gu
Hebraico iw
Hindi hi
Húngaro hu
Islandês is
Indonésio id
Interlíngua ia
Irlandês ga
Italiano it
Japonês ja
Javanês jw
Canará kn
Coreano ko
Latina la
Letão lv
Lituano lt
Macedônio mk
Malaio ms
Malaio ml
Maltês mt
Marati mr
Nepalês ne
Norueguês no
Norueguês (Nynorsk) nn
Occitânico oc
Persa fa
Polonês pl
Português (Brasil) pt-BR
Português (Portugal) pt-PT
Punjabi pa
Romeno ro
Russo ru
Gaélico escocês gd
Sérvio sr
Cingalês si
Eslovaco sk
Esloveno sl
Espanhol es
Sudanês su
Suaíli sw
Sueco sv
Tagalo tl
Tâmil ta
Télugo te
Tailandês th
Tigrínia ti
Turco tr
Ucraniano uk
Urdu ur
Usbeque uz
Vietnamita vi
Galês cy
Xhosa xh
Zulu zu

Valores de conjuntos de países

É possível usar os seguintes valores para especificar um filtro de país utilizando o parâmetro de consulta "cr":

País Nome da coleção de país
Afeganistão countryAF
Albânia countryAL
Argélia countryDZ
Samoa Americana countryAS
Andorra countryAD
Angola countryAO
Anguilla countryAI
Antártida countryAQ
Antígua e Barbuda countryAG
Argentina countryAR
Armênia countryAM
Aruba countryAW
Austrália countryAU
Áustria countryAT
Azerbaijão countryAZ
Bahamas countryBS
Bahrein countryBH
Bangladesh countryBD
Barbados countryBB
Belarus countryBY
Bélgica countryBE
Belize countryBZ
Benin countryBJ
Bermudas countryBM
Butão countryBT
Bolívia countryBO
Bósnia e Herzegovina countryBA
Botsuana countryBW
Ilha Bouvet countryBV
Brasil countryBR
Território Britânico do Oceano Índico countryIO
Brunei Darussalam countryBN
Bulgária countryBG
Burkina Faso countryBF
Burundi countryBI
Camboja countryKH
Camarões countryCM
Canadá countryCA
Cabo Verde countryCV
Ilhas Cayman countryKY
República Centro-Africana countryCF
Chade countryTD
Chile countryCL
China countryCN
Ilha Christmas countryCX
Ilhas Cocos (Keeling) countryCC
Colômbia countryCO
Ilhas Comores countryKM
Congo countryCG
Congo, República Democrática do countryCD
Ilhas Cook countryCK
Costa Rica countryCR
Costa do Marfim countryCI
Croácia (Hrvatska) countryHR
Cuba countryCU
Chipre countryCY
República Tcheca countryCZ
Dinamarca countryDK
Djibouti countryDJ
Dominica countryDM
República Dominicana countryDO
Timor Leste countryTP
Equador countryEC
Egito countryEG
El Salvador countrySV
Guiné Equatorial countryGQ
Eritreia countryER
Estônia countryEE
Etiópia countryET
União Europeia countryEU
Ilhas Falkland (Malvinas) countryFK
Ilhas Faroé countryFO
Fiji countryFJ
Finlândia countryFI
França countryFR
França (Área metropolitana) countryFX
Guiana Francesa countryGF
Polinésia Francesa countryPF
Territórios Franceses do Sul countryTF
Gabão countryGA
Gâmbia countryGM
Geórgia countryGE
Alemanha countryDE
Gana countryGH
Gibraltar countryGI
Grécia countryGR
Groenlândia countryGL
Granada countryGD
Guadalupe countryGP
Guam countryGU
Guatemala countryGT
Guiné countryGN
Guiné-Bissau countryGW
Guiana countryGY
Haiti countryHT
Ilhas Heard e McDonald countryHM
Santa Sé (Cidade do Vaticano) countryVA
Honduras countryHN
Hong Kong countryHK
Hungria countryHU
Islândia countryIS
Índia countryIN
Indonésia countryID
Irã countryIR
Iraque countryIQ
Irlanda countryIE
Israel countryIL
Itália countryIT
Jamaica countryJM
Japão countryJP
Jordânia countryJO
Cazaquistão countryKZ
Quênia countryKE
Quiribati countryKI
Coreia, República Popular Democrática da countryKP
Coreia, República da countryKR
Kuwait countryKW
Quirguistão countryKG
Laos countryLA
Letônia countryLV
Líbano countryLB
Lesoto countryLS
Libéria countryLR
Líbia countryLY
Liechtenstein countryLI
Lituânia countryLT
Luxemburgo countryLU
Macau countryMO
Macedônia countryMK
Madagascar countryMG
Malawi countryMW
Malásia countryMY
Maldivas countryMV
Mali countryML
Malta countryMT
Ilhas Marshall countryMH
Martinica countryMQ
Mauritânia countryMR
Maurício countryMU
Ilha Mayotte countryYT
México countryMX
Micronésia countryFM
Moldávia countryMD
Mônaco countryMC
Mongólia countryMN
Montserrat countryMS
Marrocos countryMA
Moçambique countryMZ
Mianmar countryMM
Namíbia countryNA
Nauru countryNR
Nepal countryNP
Países Baixos countryNL
Antilhas Holandesas countryAN
Nova Caledônia countryNC
Nova Zelândia countryNZ
Nicarágua countryNI
Níger countryNE
Nigéria countryNG
Niue countryNU
Ilha Norfolk countryNF
Ilhas Marianas do Norte countryMP
Noruega countryNO
Omã countryOM
Paquistão countryPK
Palau countryPW
Território Palestino countryPS
Panamá countryPA
Papua Nova Guiné countryPG
Paraguai countryPY
Peru countryPE
Filipinas countryPH
Pitcairn countryPN
Polônia countryPL
Portugal countryPT
Porto Rico countryPR
Catar countryQA
Ilha Reunião countryRE
Romênia countryRO
Federação Russa countryRU
Ruanda countryRW
Santa Helena countrySH
São Cristóvão e Névis countryKN
Santa Lúcia countryLC
Saint Pierre e Miquelon countryPM
São Vicente e Granadinas countryVC
Samoa countryWS
San Marino countrySM
São Tomé e Príncipe countryST
Arábia Saudita countrySA
Senegal countrySN
Sérvia e Montenegro countryCS
Seichelles countrySC
Serra Leoa countrySL
Singapura countrySG
Eslováquia countrySK
Eslovênia countrySI
Ilhas Salomão countrySB
Somália countrySO
África do Sul countryZA
Ilhas Geórgia do Sul e Sandwich do Sul countryGS
Espanha countryES
Sri Lanka countryLK
Sudão countrySD
Suriname countrySR
Ilhas Svalbard e Jan Mayen countrySJ
Suazilândia countrySZ
Suécia countrySE
Suíça countryCH
Síria countrySY
Taiwan, Província da China countryTW
Tadjiquistão countryTJ
Tanzânia countryTZ
Tailândia countryTH
Togo countryTG
Toquelau countryTK
Tonga countryTO
Trinidad e Tobago countryTT
Tunísia countryTN
Turquia countryTR
Turcomenistão countryTM
Ilhas Turcas e Caicos countryTC
Tuvalu countryTV
Uganda countryUG
Ucrânia countryUA
Emirados Árabes Unidos countryAE
Reino Unido countryUK
Estados Unidos countryUS
Ilhas Menores Distantes dos Estados Unidos countryUM
Uruguai countryUY
Uzbequistão countryUZ
Vanuatu countryVU
Venezuela countryVE
Vietnã countryVN
Ilhas Virgens Britânicas countryVG
Ilhas Virgens (EUA) countryVI
Ilhas Wallis e Futuna countryWF
Saara Ocidental countryEH
Iêmen countryYE
Iugoslávia countryYU
Zâmbia countryZM
Zimbábue countryZW

Códigos de países

A tabela a seguir lista os códigos de país de duas letras que podem ser usados como valores do parâmetro "gl":

País Country Code
Afeganistão af
Albânia al
Argélia dz
Samoa Americana as
Andorra ad
Angola ao
Anguilla ai
Antártida aq
Antígua e Barbuda ag
Argentina ar
Armênia am
Aruba aw
Austrália au
Áustria at
Azerbaijão az
Bahamas bs
Bahrein bh
Bangladesh bd
Barbados bb
Belarus by
Bélgica be
Belize bz
Benin bj
Bermudas bm
Butão bt
Bolívia bo
Bósnia e Herzegovina ba
Botsuana bw
Ilha Bouvet bv
Brasil br
Território Britânico do Oceano Índico io
Brunei Darussalam bn
Bulgária bg
Burkina Faso bf
Burundi bi
Camboja kh
Camarões cm
Canadá ca
Cabo Verde cv
Ilhas Cayman ky
República Centro-Africana cf
Chade td
Chile cl
China cn
Ilha Christmas cx
Ilhas Cocos (Keeling) cc
Colômbia co
Ilhas Comores km
Congo cg
Congo, República Democrática do cd
Ilhas Cook ck
Costa Rica cr
Costa do Marfim ci
Croácia hr
Cuba cu
Chipre cy
República Tcheca cz
Dinamarca dk
Djibouti dj
Dominica dm
República Dominicana do
Equador ec
Egito eg
El Salvador sv
Guiné Equatorial gq
Eritreia er
Estônia ee
Etiópia et
Ilhas Malvinas fk
Ilhas Faroé fo
Fiji fj
Finlândia fi
França fr
Guiana Francesa gf
Polinésia Francesa pf
Territórios Franceses do Sul tf
Gabão ga
Gâmbia gm
Geórgia ge
Alemanha de
Gana gh
Gibraltar gi
Grécia gr
Groenlândia gl
Granada gd
Guadalupe gp
Guam gu
Guatemala gt
Guiné gn
Guiné-Bissau gw
Guiana gy
Haiti ht
Ilhas Heard e McDonald hm
Santa Sé (Cidade do Vaticano) va
Honduras hn
Hong Kong hk
Hungria hu
Islândia is
Índia in
Indonésia id
Irã ir
Iraque iq
Irlanda ie
Israel il
Itália it
Jamaica jm
Japão jp
Jordânia jo
Cazaquistão kz
Quênia ke
Quiribati ki
Coreia, República Popular Democrática da kp
Coreia, República da kr
Kuwait kw
Quirguistão kg
Laos la
Letônia lv
Líbano lb
Lesoto ls
Libéria lr
Líbia ly
Liechtenstein li
Lituânia lt
Luxemburgo lu
Macau mo
Macedônia mk
Madagascar mg
Malawi mw
Malásia my
Maldivas mv
Mali ml
Malta mt
Ilhas Marshall mh
Martinica mq
Mauritânia mr
Maurício mu
Ilha Mayotte yt
México mx
Micronésia fm
Moldávia md
Mônaco mc
Mongólia mn
Montserrat ms
Marrocos ma
Moçambique mz
Mianmar mm
Namíbia na
Nauru nr
Nepal np
Países Baixos nl
Antilhas Holandesas an
Nova Caledônia nc
Nova Zelândia nz
Nicarágua ni
Níger ne
Nigéria ng
Niue nu
Ilha Norfolk nf
Ilhas Marianas do Norte mp
Noruega no
Omã om
Paquistão pk
Palau pw
Território Palestino Ocupado ps
Panamá pa
Papua Nova Guiné pg
Paraguai py
Peru pe
Filipinas ph
Pitcairn pn
Polônia pl
Portugal pt
Porto Rico pr
Catar qa
Ilha Reunião re
Romênia ro
Federação Russa ru
Ruanda rw
Santa Helena sh
São Cristóvão e Névis kn
Santa Lúcia lc
Saint Pierre e Miquelon pm
São Vicente e Granadinas vc
Samoa ws
San Marino sm
São Tomé e Príncipe st
Arábia Saudita sa
Senegal sn
Sérvia e Montenegro cs
Seichelles sc
Serra Leoa sl
Singapura sg
Eslováquia sk
Eslovênia si
Ilhas Salomão sb
Somália so
África do Sul za
Ilhas Geórgia do Sul e Sandwich do Sul gs
Espanha es
Sri Lanka lk
Sudão sd
Suriname sr
Ilhas Svalbard e Jan Mayen sj
Suazilândia sz
Suécia se
Suíça ch
Síria sy
Taiwan, Província da China tw
Tadjiquistão tj
Tanzânia tz
Tailândia th
Timor Leste tl
Togo tg
Toquelau tk
Tonga to
Trinidad e Tobago tt
Tunísia tn
Turquia tr
Turcomenistão tm
Ilhas Turcas e Caicos tc
Tuvalu tv
Uganda ug
Ucrânia ua
Emirados Árabes Unidos ae
Reino Unido uk
Estados Unidos us
Ilhas Menores Distantes dos Estados Unidos um
Uruguai uy
Uzbequistão uz
Vanuatu vu
Venezuela ve
Vietnã vn
Ilhas Virgens Britânicas vg
Ilhas Virgens (EUA) vi
Ilhas Wallis e Futuna wf
Saara Ocidental eh
Iêmen ye
Zâmbia zm
Zimbábue zw