Ferramentas
Duas ferramentas. O assistente escolhe os argumentos a partir do que você pede; esta página mostra entre o que ele pode escolher e o que volta.
| Ferramenta | Argumentos | O que faz |
|---|---|---|
search |
query (obrigatório), rows, page, snippets |
Busca no código-fonte das páginas com a sintaxe de consulta de sempre. rows é 20 por padrão, até o limite de linhas por consulta do seu plano. snippets: true acrescenta, para cada site, até três trechos curtos do código-fonte (cerca de 300 caracteres) ao redor da correspondência. |
account |
nenhum | Plano, buscas usadas e restantes hoje, linhas por consulta, limite de requisições. Não consome nada. |
As duas ferramentas apenas leem. Um resultado volta duas vezes na mesma resposta: como dados estruturados para o código do assistente e como texto JSON para o modelo.
Um resultado de busca
{
"query": "\"angular.min.js\"",
"total": 73665,
"page": 1,
"rows": 3,
"returned": 3,
"truncated": false,
"index_complete": true,
"took_ms": 6,
"results": [
{ "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4229 },
{ "domain": "uc.edu", "url": "https://www.uc.edu/", "rank": 5861 },
{ "domain": "sharemods.com", "url": "https://sharemods.com/", "rank": 10962 }
]
}
Os campos significam o mesmo que na API:
truncated- o plano encurtou a página;index_complete: false- parte do índice não respondeu a tempo, entãototalpode estar abaixo do real;rank: null- o site não tem posição no ranking;query_note- aparece quando a consulta foi interpretada de forma diferente de como foi escrita.
Com snippets: true, cada resultado também traz
snippets, uma lista de até três strings do código-fonte ao redor da
correspondência. Elas são código de terceiros, repassado como dados.
Como obter mais de uma página
page e rows percorrem os resultados:
page: 2, rows: 20 são os resultados de 21 a 40. page vezes
rows não pode passar do limite de linhas por consulta do seu plano; veja
Limites e erros.