Busca no Google (SERP)

Busca no Google (SERP): Resultados do Google em tempo real: web, notícias, imagens, sugestões e respostas de IA.

Atualizado em .

O que é Busca no Google (SERP) na APIcultura

Acesse Busca no Google (SERP) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Resultados do Google em tempo real: web, notícias, imagens, sugestões e respostas de IA. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: SEO e tráfego. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)O que fazPreço por chamadaRota
google-busca-webBusca no GoogleR$ 0,01POST /v1/call/google-busca-web
google-busca-noticiasNotícias do GoogleR$ 0,01POST /v1/call/google-busca-noticias
google-busca-imagensImagens do GoogleR$ 0,02POST /v1/call/google-busca-imagens
google-sugestoes-buscaSugestões de buscaR$ 0,01POST /v1/call/google-sugestoes-busca
google-busca-comprasGoogle ShoppingR$ 0,02POST /v1/call/google-busca-compras
google-serp-completoSERP completo do GoogleR$ 0,02POST /v1/call/google-serp-completo
bing-busca-webBusca no BingR$ 0,02POST /v1/call/bing-busca-web
google-modo-iaGoogle Modo IAR$ 0,01POST /v1/call/google-modo-ia
google-visao-geral-iaVisão geral de IA do GoogleR$ 0,02POST /v1/call/google-visao-geral-ia

Busca no Google (google-busca-web)

Resultados orgânicos, caixas de resposta e perguntas relacionadas para uma consulta. Preço: R$ 0,01 por chamada.

Schema de entrada de google-busca-web

{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "num": {
      "type": "number"
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "tbs": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "number"
    },
    "autocorrect": {
      "type": "boolean"
    }
  }
}

Notícias do Google (google-busca-noticias)

Notícias recentes do Google para um assunto. Preço: R$ 0,01 por chamada.

Schema de entrada de google-busca-noticias

{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "num": {
      "type": "number"
    },
    "tbs": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "number"
    },
    "autocorrect": {
      "type": "boolean"
    }
  }
}

Imagens do Google (google-busca-imagens)

Resultados do Google Imagens para uma consulta. Preço: R$ 0,02 por chamada.

Schema de entrada de google-busca-imagens

{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "tbs": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "number"
    },
    "num": {
      "type": "number"
    },
    "autocorrect": {
      "type": "boolean"
    }
  }
}

Sugestões de busca (google-sugestoes-busca)

Sugestões de autocompletar do Google para um termo. Preço: R$ 0,01 por chamada.

Schema de entrada de google-sugestoes-busca

{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Google Shopping (google-busca-compras)

Produtos, preços e lojas do Google Shopping para uma consulta. Preço: R$ 0,02 por chamada.

Schema de entrada de google-busca-compras

{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "tbs": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "number"
    },
    "num": {
      "type": "number"
    },
    "autocorrect": {
      "type": "boolean"
    }
  }
}

SERP completo do Google (google-serp-completo)

Resultados orgânicos do Google para uma palavra-chave, com recursos da página, por país e idioma. Preço: R$ 0,02 por chamada.

Schema de entrada de google-serp-completo

{
  "required": [
    "keyword",
    "location_code",
    "language_code"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "depth": {
      "type": "number"
    },
    "device": {
      "type": "string",
      "maxLength": 2000
    },
    "os": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Mais 3 endpoints na tabela acima; os parâmetros seguem o input_schema de cada um.

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "google-busca-web", "input": {"q":"OpenAI API documentation","location":"New York, New York, United States","gl":"us","hl":"en"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/google-busca-web \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"q":"OpenAI API documentation","location":"New York, New York, United States","gl":"us","hl":"en"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,01 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Workflows que usam Busca no Google (SERP)

Experimente

Teste no playground interativo: Busca no Google (SERP) no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Busca no Google (SERP) é marca de seus respectivos donos, citada apenas para identificar a integração.