Endpoints da Google Search API

Escolha um tipo de busca do Google e envie sua requisição usando a Google Search API. Este guia se baseia no Quickstart e cobre os cinco tipos de busca com entradas dedicadas na referência da API da Scrapeless.

Os cinco usam o mesmo endpoint HTTP e o actor scraper.google.search. O valor de input.tbm seleciona o tipo de busca.

Requisiçã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 da Scrapeless. Envie um único objeto JSON contendo actor e input.

Escolha um tipo de busca

Tipo de busca	`input.tbm`	Entrada da requisição
Google Search	Omitir	Consulta de busca em `q`
Google Images	`isch`	Consulta de busca de imagens em `q`
Google Local	`lcl`	Consulta de busca local em `q`
Google Videos	`vid`	Consulta de busca de vídeos em `q`
Google Shopping	`shop`	Consulta de busca de shopping em `q`

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

Google Search

Omita tbm para uma busca web regular.

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 Quickstart inclui uma resposta de busca web com organic_results, pagination e outras seções que dependem da consulta. Não presuma que toda consulta retorne todas as seções.

Referência do Google Search

Google Images

Defina tbm como isch para solicitar uma busca de imagens. A requisiçã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 uma busca 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 segmentação por cidade, adicione location dentro de input, como "Austin, Texas, United States". Use location ou uule, nunca ambos em uma única requisição.

Para a paginação da busca 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 requisiçã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,
    "num": 10,
    "tbm": "vid"
  }
}'

Referência do Google Videos

Google Shopping

Defina tbm como shop. Este exemplo mantém os campos de requisiçã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,
    "num": 10,
    "tbm": "shop"
  }
}'

Referência do Google Shopping

Controles comuns de busca

Defina estes campos dentro de input:

Parâmetro	Finalidade
`q`	Consulta de busca obrigatória.
`gl`	País da busca, como `us`.
`hl`	Idioma da busca, como `en`.
`google_domain`	Domínio do Google; o padrão é `google.com`.
`location`	Origem da busca, preferencialmente especificada em nível de cidade.
`uule`	Localização do Google codificada; mutuamente exclusiva com `location`.
`start`	Deslocamento dos resultados. A busca web usa `0`, `10`, `20`, e assim por diante.
`num`	Número máximo de resultados solicitado.
`tbs`	Filtros de busca avançada.

A referência de parâmetros avisa que num pode aumentar a latência ou afetar tipos de resultados especializados. Omita-o a menos que seja necessário; uma quantidade solicitada não é garantia de que tantos resultados serão retornados. Os exemplos de Videos e Shopping acima preservam o valor documentado de 10.

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

Ler o resultado

HTTP 200: leia o resultado JSON.
HTTP 201: salve o taskId e recupere a tarefa existente usando o endpoint de resultado.

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 busca e a consulta. As especificações dedicadas da API atualmente declaram um objeto genérico para respostas bem-sucedidas; o exemplo de busca regular do Google Search não é um esquema para Images, Local, Videos ou Shopping.

Documentação relacionada

Início rápido Introdução