Endpoints da API Google Search

Escolha um tipo de pesquisa do Google e envie sua solicitação usando a API Google Search. Este guia se baseia no Início rápido e abrange os cinco tipos de pesquisa com entradas dedicadas na referência da API Scrapeless.

Todos os cinco usam o mesmo endpoint HTTP e o ator scraper.google.search. O valor input.tbm seleciona o tipo de pesquisa.

Solicitação e autenticação

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

Substitua YOUR_API_KEY pela sua chave de API Scrapeless. Envie um único objeto JSON contendo actor e input.

Escolha um tipo de pesquisa

Tipo de pesquisainput.tbmEntrada da solicitação
Google SearchOmitirConsulta de pesquisa em q
Google ImagesischConsulta de pesquisa de imagens em q
Google LocallclConsulta de pesquisa local em q
Google VideosvidConsulta de pesquisa de vídeos em q
Google ShoppingshopConsulta de pesquisa de compras em q
Google WebwebConsulta de pesquisa na web em q
Google JobsjobsConsulta de pesquisa de empregos em q
Google NewsnwsConsulta de pesquisa de notícias em q
Google Short VideossvidConsulta de pesquisa de vídeos curtos em q

Estes são modos de pesquisa de um único endpoint. Mantenha a URL HTTP, o cabeçalho de autenticação e o ator inalterados ao alternar entre os modos.

Omita tbm para pesquisas regulares na web.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "coffee",
    "hl": "en",
    "gl": "us"
  }
}'

O Início rápido inclui uma resposta de pesquisa na web com organic_results, pagination e outras seções dependentes da consulta. Não assuma que toda consulta retornará todas as seções.

Referência do Google Search

Google Images

Defina tbm como isch para solicitar pesquisa de imagens. A solicitação abaixo usa o domínio padrão do Google.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "Apple Iphone16",
    "hl": "en",
    "gl": "us",
    "tbm": "isch"
  }
}'

Referência do Google Images

Google Local

Defina tbm como lcl para solicitar pesquisa local.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "q": "coffee shops",
    "hl": "en",
    "gl": "us",
    "tbm": "lcl"
  }
}'

Para direcionamento em nível de cidade, adicione location dentro de input, como "Austin, Texas, United States". Use location ou uule, nunca ambos na mesma solicitação.

Para paginação na pesquisa Local, start deve ser um múltiplo de 20: 0, 20, 40 e assim por diante.

Referência do Google Local

Google Videos

Defina tbm como vid. Este exemplo mantém os campos de solicitação mostrados na referência dedicada da API.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "tbm": "vid"
  }
}'

Referência do Google Videos

Google Shopping

Defina tbm como shop. Este exemplo mantém os campos de solicitação mostrados na referência dedicada da API.

curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
  --header 'x-api-token: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "actor": "scraper.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "tbm": "shop"
  }
}'

Referência do Google Shopping

Controles comuns de pesquisa

Defina estes campos dentro de input:

ParâmetroFinalidade
qConsulta de pesquisa obrigatória.
glPaís da pesquisa, como us.
hlIdioma da pesquisa, como en.
google_domainDomínio do Google; padrão é google.com.
locationOrigem da pesquisa, preferencialmente especificada em nível de cidade.
uuleLocalização do Google codificada; mutuamente exclusiva com location.
startDeslocamento dos resultados. A pesquisa na web usa 0, 10, 20 e assim por diante.
tbsFiltros avançados de pesquisa.

Consulte Parâmetros do Google Search para as descrições completas dos parâmetros. O suporte atual de dispositivos listado lá é para desktop.

Leia o resultado

  • HTTP 200: leia o resultado JSON.
  • HTTP 201: salve o taskId e recupere a tarefa existente usando o endpoint de resultados.
curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
  --header 'x-api-token: YOUR_API_KEY'

Substitua YOUR_TASK_ID pelo ID retornado. Consulte Resultados e Polling para o fluxo de trabalho completo.

As seções da resposta variam conforme o tipo de pesquisa e a consulta. As especificações dedicadas da API atualmente declaram um objeto genérico para respostas bem-sucedidas; o exemplo regular do Google Search não é um esquema para Images, Local, Videos ou Shopping.

Documentação relacionada