Skip to content

Google Documentação da API Google Search e Diretório de Endpoints Pesquisa Light API

prod-global
GET
/api/v1/google/search/light
Status de saúde da API
Saudável Disponível Limitado Quase indisponível Sem dados
Carregando status...

Obtenha dados SERP da pesquisa light do Google, incluindo dados essenciais de resultados, para monitoramento de alto volume e verificações rápidas de ranking.

Tags: Google

Parâmetros

NomeObrigatórioTipoPadrãoDescrição
querySimstringA consulta de pesquisa para o Google Search (ex.: 'cafeterias', 'como fazer um bolo').
pageNãointeger0O número da página de resultados. Use 0 para a primeira página, 1 para a segunda e assim por diante.
htmlNãobooleanfalseDefina como true para retornar o HTML bruto da página de resultados de pesquisa do Google junto com os dados estruturados.
languageNãostringenDefina o idioma dos resultados usando seu código de duas letras (ex.: 'en' para inglês, 'fr' para francês). Veja Idioma do Google.
lrNãostringRestrinja os resultados a um ou mais idiomas usando o formato 'lang_{código_do_idioma}' (ex.: 'lang_en'). Consulte Google LR Language.
domainNãostringgoogle.comO domínio do Google a ser usado para a pesquisa (ex.: 'google.com', 'google.co.uk'). Veja Domínios do Google.
countryNãostringusDefina o código do país de destino (ex.: 'us', 'uk') para localizar os resultados. Veja Países do Google.
crNãostringLimita os resultados a resultados de pesquisa de países específicos. Formato: 'countryXX'. Veja Países CR do Google.
uuleNãostringString de localização codificada (UULE) usada para localizar precisamente os resultados da pesquisa do Google. Este é um parâmetro avançado/técnico — se você não estiver familiarizado com ele, pode deixá-lo vazio e omiti-lo.
locationNãostringO nome textual da localização (ex.: 'Nova York, NY') para localizar os resultados da pesquisa.
ludocidNãostringCID de negócio local do Google (identificador de local). Usado para segmentar um perfil/listagem específica do Google Meu Negócio. Parâmetro avançado — se você não o conhece, pode omiti-lo.
lsigNãostringParâmetro de assinatura (lsig) às vezes necessário para certos recursos do Knowledge Graph / visualização de mapa local. Este é um parâmetro técnico avançado — se você não estiver familiarizado com ele, pode deixá-lo vazio.
kgmidNãostringID de entidade/listagem do Knowledge Graph (KGMID) usado para recuperar detalhes de uma entidade específica. Este é um parâmetro técnico avançado — se você não estiver familiarizado com ele, pode deixá-lo vazio.
siNãostringParâmetro de contexto de pesquisa em cache (si) usado para reproduzir visualizações/contextos específicos de resultados de pesquisa do Google (ex.: algumas abas do Knowledge Graph). Este é um parâmetro técnico avançado — se você não estiver familiarizado com ele, pode deixá-lo vazio.
ibpNãostringParâmetro (ibp) usado para controlar certas expansões ou modos de renderização da interface do Google (comum em visualizações de resultados locais/de negócios). Este é um parâmetro técnico avançado — se você não estiver familiarizado, pode deixá-lo vazio.
udsNãostringToken de filtro avançado (uds) usado para subfiltros específicos de pesquisa do Google. Este é um parâmetro técnico avançado, geralmente fornecido pelo Google em opções/resultados de filtro — se você não estiver familiarizado, pode deixá-lo vazio.
tbsNãostringParâmetro de filtro de pesquisa avançada (tbs) usado para aplicar filtros de resultados do Google (ex.: intervalo de tempo). Este é um parâmetro avançado — se você não estiver familiarizado com ele, pode deixá-lo vazio.
safeNãostringOFFConfiguração do filtro SafeSearch.

Valores disponíveis:
- ACTIVE: Filtrar conteúdo adulto. O valor legado active também é aceito.
- OFF: Desabilitar a filtragem do SafeSearch. O valor legado off também é aceito.
nfprNãostringINCLUDE_CORRECTED_RESULTSControla a autocorreção do Google.

Valores disponíveis:
- INCLUDE_CORRECTED_RESULTS: Incluir resultados corrigidos. O valor legado 0 também é aceito.
- EXCLUDE_CORRECTED_RESULTS: Excluir resultados corrigidos. O valor legado 1 também é aceito.
filterNãostringAlternar filtragem de resultados semelhantes e omitidos.

Valores disponíveis:
- DISABLED: Desabilitar filtragem de resultados semelhantes e omitidos. O valor legado 0 também é aceito.
- ENABLED: Habilitar filtragem de resultados semelhantes e omitidos. O valor legado 1 também é aceito.

Copiar requisição

bash
curl -X GET "https://api.justserpapi.com/api/v1/google/search/light?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"
js
const res = await fetch("https://api.justserpapi.com/api/v1/google/search/light?query=coffee", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);
python
import requests

url = "https://api.justserpapi.com/api/v1/google/search/light"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
php
<?php
$url = "https://api.justserpapi.com/api/v1/google/search/light?query=coffee";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/search/light?query=coffee", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Resposta

Carregando o exemplo de resposta mais recente...