Ir para o conteúdo

API de pesquisa leve do Google

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 de pesquisa leve Google SERP, incluindo dados essenciais de resultados, para monitoramento de alto volume e verificações rápidas de classificação.

Tags: Google

Parâmetros

NomeObrigatórioTipoPadrãoDescrição
querySimstringA consulta de pesquisa para 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 (por exemplo, 'en' para inglês, 'fr' para francês). Consulte Google Idioma.
lrNãostringRestrinja os resultados a um ou mais idiomas usando o formato 'lang_{language_code}' (por exemplo, 'lang_en'). Consulte Google Idioma LR.
domainNãostringgoogle.comO domínio do Google a ser usado para a pesquisa (por exemplo, 'google.com', 'google.co.uk'). Consulte Google Domínios.
countryNãostringusDefina o código do país alvo (por exemplo, 'us', 'uk') para localizar os resultados. Consulte Google Países.
crNãostringLimita os resultados a resultados de pesquisa de países específicos. Formato: 'countryXX'. Consulte Google CR Países.
uuleNãostringString de localização codificada (UULE) usada para localizar precisamente os resultados de 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ãostringGoogle CID de empresa local (identificador de local). Usado para segmentar um Google Perfil Comercial / listagem local específico. 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 (por exemplo, algumas guias 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 de UI ou modos de renderização 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 com ele, pode deixá-lo vazio.
udsNãostringToken de filtro avançado (uds) usado para subfiltros de pesquisa específicos 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 com ele, pode deixá-lo vazio.
tbsNãostringParâmetro de filtro de pesquisa avançada (tbs) usado para aplicar filtros de resultados do Google (por exemplo, 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 SafeSearch. O valor legado off também é aceito.
nfprNãostringINCLUDE_CORRECTED_RESULTSControla a correção automática 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...