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/jsonSubstitua 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 pesquisa | input.tbm | Entrada da solicitação |
|---|---|---|
| Google Search | Omitir | Consulta de pesquisa em q |
| Google Images | isch | Consulta de pesquisa de imagens em q |
| Google Local | lcl | Consulta de pesquisa local em q |
| Google Videos | vid | Consulta de pesquisa de vídeos em q |
| Google Shopping | shop | Consulta de pesquisa de compras em q |
| Google Web | web | Consulta de pesquisa na web em q |
| Google Jobs | jobs | Consulta de pesquisa de empregos em q |
| Google News | nws | Consulta de pesquisa de notícias em q |
| Google Short Videos | svid | Consulta 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.
Google Search
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.
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"
}
}'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.
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"
}
}'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"
}
}'Controles comuns de pesquisa
Defina estes campos dentro de input:
| Parâmetro | Finalidade |
|---|---|
q | Consulta de pesquisa obrigatória. |
gl | País da pesquisa, como us. |
hl | Idioma da pesquisa, como en. |
google_domain | Domínio do Google; padrão é google.com. |
location | Origem da pesquisa, preferencialmente especificada em nível de cidade. |
uule | Localização do Google codificada; mutuamente exclusiva com location. |
start | Deslocamento dos resultados. A pesquisa na web usa 0, 10, 20 e assim por diante. |
tbs | Filtros 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 otaskIde 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.