Google Search API

A API de Pesquisa Google permite realizar buscas na web e receber resultados estruturados. Ela suporta múltiplos tipos de busca, geo-target, emulação de dispositivos e dois modos de profundidade de resultados.

Endpoint

Bash

POST https://api.scavio.dev/api/v1/google

Headers

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer YOUR_API_KEY`	Sim
`Content-Type`	`application/json`	Sim

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. A consulta de pesquisa (1-500 caracteres).
`search_type`	`string`	`classic`	Um de: `classic`, `news`, `maps`, `images`, `lens`
`country_code`	`string`	--	Código de país ISO 3166-1 alpha-2 (ex.: `us`, `gb`, `de`). Ver lista completa.
`language`	`string`	--	Código de idioma ISO 639-1 (ex.: `en`, `fr`, `es`)
`page`	`number`	`1`	Número da página de resultados (base 1)
`device`	`string`	`desktop`	`desktop` ou `mobile`. A busca de notícias suporta apenas `desktop`.
`nfpr`	`boolean`	`false`	Defina como `true` para desabilitar a autocorreção da consulta
`light_request`	`boolean`	omitido (light)	Omita para modo leve (1 crédito). Defina como `false` para resultados completos (2 créditos) incluindo gráfico de conhecimento, pesquisas relacionadas e mais.

Custo de Créditos

Cenário	Créditos
`light_request` omitido ou não enviado	1
`"light_request": false`	2

Exemplo Mínimo

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "Scavio search API"}'

Exemplo Completo (com todos os parâmetros)

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "AI startups funding",
    "search_type": "news",
    "country_code": "us",
    "language": "en",
    "page": 1,
    "device": "desktop",
    "nfpr": false,
    "light_request": false
  }'

Restrições

Quando search_type é news, apenas desktop é permitido como device. Enviar mobile retornará um erro 400.
Valores inválidos de search_type (ex.: shopping, ai_mode) retornarão um erro de validação 400.
device aceita apenas desktop ou mobile. tablet não é suportado.

Formato da Resposta

Todas as respostas bem-sucedidas retornam um objeto JSON. Alguns campos estão sempre presentes, enquanto outros aparecem apenas quando não vazios (tipicamente no modo completo).

Campos Principais (sempre presentes)

Campo	Tipo	Descrição
`results`	`array`	Matriz de objetos de resultados de pesquisa orgânica
`results[].title`	`string`	Título da página de resultado da pesquisa
`results[].url`	`string`	URL completa do resultado
`results[].content`	`string`	Trecho ou meta descrição da página
`results[].position`	`number`	Posição baseada em 1 nos resultados
`query`	`string`	A consulta que foi executada
`page`	`number`	O número da página retornada
`country_code`	`string`	Código do país usado para a pesquisa
`language`	`string`	Código do idioma usado para a pesquisa
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos (1 ou 2)
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Campos Opcionais (presentes quando não vazios)

Estes são normalmente retornados no modo completo ("light_request": false) mas também podem aparecer no modo leve quando os dados estão disponíveis.

Campo	Tipo	Descrição
`top_stories`	`array`	Itens do carrossel de principais notícias
`news_results`	`array`	Artigos de notícias com `title`, `link`, `source`, `snippet`, `date`, `relative_date`, `domain`, `position`
`knowledge_graph`	`object`	Painel de conhecimento com `title`, `subtitle`, e array `factoids`
`questions`	`array`	"Perguntas frequentes" com `question` e `answer`
`related_searches`	`array`	Pesquisas relacionadas, cada uma com `query`, `link`, `type`, `position`
`total_results`	`number`	Total estimado de resultados para a consulta
`search_url`	`string`	A URL original do mecanismo de busca para esta consulta

Exemplo de Resposta do Modo Leve

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

Exemplo de Resposta do Modo Completo

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 620,
  "total_results": 1250000,
  "search_url": "https://www.google.com/search?q=...",
  "knowledge_graph": {
    "title": "Scavio",
    "subtitle": "Search API Platform",
    "factoids": [
      { "title": "Type", "content": "Developer API" }
    ]
  },
  "related_searches": [
    { "query": "scavio api pricing", "link": null, "type": null, "position": 0 },
    { "query": "scavio search api docs", "link": null, "type": null, "position": 1 }
  ],
  "questions": [
    {
      "question": "What is Scavio?",
      "answer": "Scavio is a multi-platform search API..."
    }
  ],
  "credits_used": 2,
  "credits_remaining": 998
}

Exemplo de Resultados de Notícias

Quando search_type é news, o campo news_results é preenchido:

JSON

{
  "news_results": [
    {
      "title": "AI Startups Raise Record Funding in Q1 2026",
      "link": "https://example.com/ai-funding",
      "source": "TechCrunch",
      "snippet": "AI companies raised over $15B in Q1 2026...",
      "date": "2026-03-31T20:00:00.000Z",
      "relative_date": "2 hours ago",
      "domain": "techcrunch.com",
      "position": 1
    }
  ]
}

Notas

O array results é ordenado por relevância (posição 1 é a mais relevante)
Campos opcionais estão presentes apenas quando não vazios -- sempre verifique sua existência antes de acessar
Modo leve (1 crédito) retorna resultados principais. Modo completo (2 créditos) pode incluir todos os campos opcionais.

Relacionados

YouTube API -- busca e metadados
Amazon API -- busca de produtos e detalhes
Country Codes -- códigos de país suportados
Errors -- códigos de erro e tratamento

Google Search API

Endpoint

Bash

POST https://api.scavio.dev/api/v1/google

Headers

Cabeçalho	Valor	Obrigatório
`Authorization`	`Bearer YOUR_API_KEY`	Sim
`Content-Type`	`application/json`	Sim

Corpo da Requisição

Parâmetro	Tipo	Padrão	Descrição
`query`	`string`	--	Obrigatório. A consulta de pesquisa (1-500 caracteres).
`search_type`	`string`	`classic`	Um de: `classic`, `news`, `maps`, `images`, `lens`
`country_code`	`string`	--	Código de país ISO 3166-1 alpha-2 (ex.: `us`, `gb`, `de`). Ver lista completa.
`language`	`string`	--	Código de idioma ISO 639-1 (ex.: `en`, `fr`, `es`)
`page`	`number`	`1`	Número da página de resultados (base 1)
`device`	`string`	`desktop`	`desktop` ou `mobile`. A busca de notícias suporta apenas `desktop`.
`nfpr`	`boolean`	`false`	Defina como `true` para desabilitar a autocorreção da consulta
`light_request`	`boolean`	omitido (light)	Omita para modo leve (1 crédito). Defina como `false` para resultados completos (2 créditos) incluindo gráfico de conhecimento, pesquisas relacionadas e mais.

Custo de Créditos

Cenário	Créditos
`light_request` omitido ou não enviado	1
`"light_request": false`	2

Exemplo Mínimo

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{"query": "Scavio search API"}'

Exemplo Completo (com todos os parâmetros)

curl -X POST 'https://api.scavio.dev/api/v1/google' \
  -H 'Authorization: Bearer sk_live_your_key' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "AI startups funding",
    "search_type": "news",
    "country_code": "us",
    "language": "en",
    "page": 1,
    "device": "desktop",
    "nfpr": false,
    "light_request": false
  }'

Restrições

Quando search_type é news, apenas desktop é permitido como device. Enviar mobile retornará um erro 400.
Valores inválidos de search_type (ex.: shopping, ai_mode) retornarão um erro de validação 400.
device aceita apenas desktop ou mobile. tablet não é suportado.

Formato da Resposta

Todas as respostas bem-sucedidas retornam um objeto JSON. Alguns campos estão sempre presentes, enquanto outros aparecem apenas quando não vazios (tipicamente no modo completo).

Campos Principais (sempre presentes)

Campo	Tipo	Descrição
`results`	`array`	Matriz de objetos de resultados de pesquisa orgânica
`results[].title`	`string`	Título da página de resultado da pesquisa
`results[].url`	`string`	URL completa do resultado
`results[].content`	`string`	Trecho ou meta descrição da página
`results[].position`	`number`	Posição baseada em 1 nos resultados
`query`	`string`	A consulta que foi executada
`page`	`number`	O número da página retornada
`country_code`	`string`	Código do país usado para a pesquisa
`language`	`string`	Código do idioma usado para a pesquisa
`response_time`	`number`	Tempo de resposta do servidor em milissegundos
`credits_used`	`number`	Número de créditos consumidos (1 ou 2)
`credits_remaining`	`number`	Créditos restantes no seu período de faturamento atual

Campos Opcionais (presentes quando não vazios)

Estes são normalmente retornados no modo completo ("light_request": false) mas também podem aparecer no modo leve quando os dados estão disponíveis.

Campo	Tipo	Descrição
`top_stories`	`array`	Itens do carrossel de principais notícias
`news_results`	`array`	Artigos de notícias com `title`, `link`, `source`, `snippet`, `date`, `relative_date`, `domain`, `position`
`knowledge_graph`	`object`	Painel de conhecimento com `title`, `subtitle`, e array `factoids`
`questions`	`array`	"Perguntas frequentes" com `question` e `answer`
`related_searches`	`array`	Pesquisas relacionadas, cada uma com `query`, `link`, `type`, `position`
`total_results`	`number`	Total estimado de resultados para a consulta
`search_url`	`string`	A URL original do mecanismo de busca para esta consulta

Exemplo de Resposta do Modo Leve

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

Exemplo de Resposta do Modo Completo

JSON

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform. Structured JSON results.",
      "position": 1,
      "displayed_url": "https://scavio.dev",
      "domain": "scavio.dev",
      "date": null,
      "rich_snippet": {},
      "sitelinks": []
    }
  ],
  "query": "Scavio search API",
  "page": 1,
  "country_code": "us",
  "language": "en",
  "response_time": 620,
  "total_results": 1250000,
  "search_url": "https://www.google.com/search?q=...",
  "knowledge_graph": {
    "title": "Scavio",
    "subtitle": "Search API Platform",
    "factoids": [
      { "title": "Type", "content": "Developer API" }
    ]
  },
  "related_searches": [
    { "query": "scavio api pricing", "link": null, "type": null, "position": 0 },
    { "query": "scavio search api docs", "link": null, "type": null, "position": 1 }
  ],
  "questions": [
    {
      "question": "What is Scavio?",
      "answer": "Scavio is a multi-platform search API..."
    }
  ],
  "credits_used": 2,
  "credits_remaining": 998
}

Exemplo de Resultados de Notícias

Quando search_type é news, o campo news_results é preenchido:

JSON

{
  "news_results": [
    {
      "title": "AI Startups Raise Record Funding in Q1 2026",
      "link": "https://example.com/ai-funding",
      "source": "TechCrunch",
      "snippet": "AI companies raised over $15B in Q1 2026...",
      "date": "2026-03-31T20:00:00.000Z",
      "relative_date": "2 hours ago",
      "domain": "techcrunch.com",
      "position": 1
    }
  ]
}

Notas

O array results é ordenado por relevância (posição 1 é a mais relevante)
Campos opcionais estão presentes apenas quando não vazios -- sempre verifique sua existência antes de acessar
Modo leve (1 crédito) retorna resultados principais. Modo completo (2 créditos) pode incluir todos os campos opcionais.

Relacionados

YouTube API -- busca e metadados
Amazon API -- busca de produtos e detalhes
Country Codes -- códigos de país suportados
Errors -- códigos de erro e tratamento