API de Pesquisa do Google

prod-global

GET

/api/v1/google/search

Status de saúde da API

Saudável Disponível Limitado Quase indisponível Sem dados

Carregando status...

Obtenha dados de pesquisa Google SERP, incluindo resultados orgânicos, anúncios e painéis de conhecimento, para rastreamento de palavras-chave e análise SERP entre mercados.

Tags: Google

Parâmetros

Nome	Obrigatório	Tipo	Padrão	Descrição
query	Sim	string		A consulta de pesquisa para Google Search (ex.: 'cafeterias', 'como fazer um bolo').
page	Não	integer	0	O número da página de resultados. Use 0 para a primeira página, 1 para a segunda e assim por diante.
html	Não	boolean	false	Defina como true para retornar o HTML bruto da página de resultados de pesquisa do Google junto com os dados estruturados.
language	Não	string	en	Defina o idioma dos resultados usando seu código de duas letras (por exemplo, 'en' para inglês, 'fr' para francês). Consulte Google Idioma.
lr	Não	string		Restrinja os resultados a um ou mais idiomas usando o formato 'lang_{language_code}' (por exemplo, 'lang_en'). Consulte Google Idioma LR.
domain	Não	string	google.com	O domínio do Google a ser usado para a pesquisa (por exemplo, 'google.com', 'google.co.uk'). Consulte Google Domínios.
country	Não	string	us	Defina o código do país alvo (por exemplo, 'us', 'uk') para localizar os resultados. Consulte Google Países.
cr	Não	string		Limita os resultados a resultados de pesquisa de países específicos. Formato: 'countryXX'. Consulte Google CR Países.
uule	Não	string		String 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.
location	Não	string		O nome textual da localização (ex.: 'Nova York, NY') para localizar os resultados da pesquisa.
ludocid	Não	string		Google 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.
lsig	Não	string		Parâ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.
kgmid	Não	string		ID 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.
si	Não	string		Parâ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.
ibp	Não	string		Parâ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.
uds	Não	string		Token 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.
tbs	Não	string		Parâ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.
safe	Não	string	OFF	Configuraçã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.
nfpr	Não	string	INCLUDE_CORRECTED_RESULTS	Controla 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.
filter	Não	string		Alternar 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

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/search?query=coffee" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/search?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"
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?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?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...