Pesquisa Google

Extraia resultados da Pesquisa Google em tempo real e receba JSON limpo e estruturado — resultados orgânicos, anúncios, pesquisas relacionadas, painel de conhecimento e muito mais.

Ator

scraper.google.search

Parâmetros Comuns

Passados dentro do objeto input. Consulte Parâmetros da API para a lista completa.

Parâmetro	Obrigatório	Descrição
`q`	true	A consulta de pesquisa. Suporta operadores avançados como `inurl:`, `site:`, `intitle:`.
`gl`	false	Código de país de duas letras para a pesquisa (ex.: `us`, `uk`, `fr`).
`hl`	false	Código de idioma de duas letras para a pesquisa (ex.: `en`, `es`, `fr`).
`google_domain`	false	O domínio do Google a ser usado. O padrão é `google.com`.
`location`	false	Local de origem da pesquisa (recomendado no nível de cidade).
`start`	false	Deslocamento de resultados para paginação (`0`, `10`, `20`, …).

Exemplo de Requisição

curl '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",
        "google_domain": "google.com"
    }
}'

import { Scrapeless } from '@scrapeless-ai/sdk';
 
const client = new Scrapeless({
  apiKey: 'YOUR_API_KEY'
});
 
client.deepserp.createTask({
    actor: "scraper.google.search",
    input: {
        q: "coffee",
        gl: "us",
        hl: "en",
        google_domain: "google.com"
    }
}).then((result) => {
    console.log(result);
  })
  .catch((error) => {
    console.error('Error:', error);
  });

import json
import requests
 
def send_request():
    host = "api.scrapeless.com"
    url = f"https://{host}/api/v1/scraper/request"
    token = "your_api_key"
 
    headers = {
        "x-api-token": token,
        "Content-Type": "application/json"
    }
 
    json_payload = json.dumps({
        "actor": "scraper.google.search",
        "input": {
            "q": "coffee",
            "gl": "us",
            "hl": "en",
            "google_domain": "google.com"
        }
    })
 
    response = requests.post(url, headers=headers, data=json_payload)
 
    if response.status_code != 200:
        print("Error:", response.status_code, response.text)
        return
 
    print("body", response.text)
 
if __name__ == "__main__":
    send_request()

Começando