Outils

Deux outils. L’assistant choisit les arguments en fonction de votre demande ; cette page présente ce parmi quoi il peut choisir et ce qu’il reçoit en retour.

Outil	Arguments	Rôle
`search`	`query` (obligatoire), `rows`, `page`, `snippets`	Recherche dans le code source des pages avec la syntaxe de requête habituelle. `rows` vaut 20 par défaut, jusqu’au nombre de lignes par requête de votre forfait. `snippets: true` ajoute, pour chaque site, jusqu’à trois courts extraits du code source (environ 300 caractères) autour de la correspondance.
`account`	aucun	Forfait, recherches utilisées et restantes aujourd’hui, lignes par requête, limite de débit. Ne consomme rien.

Les deux outils sont en lecture seule. Un résultat figure deux fois dans la même réponse : sous forme de données structurées pour le code de l’assistant et sous forme de texte JSON pour le modèle.

Un résultat de recherche

{
  "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 }
  ]
}

Les champs ont la même signification que dans l’API :

truncated - le forfait a raccourci la page ;
index_complete: false - une partie de l’index n’a pas répondu à temps, total peut donc être sous-estimé ;
rank: null - le site n’a pas de rang ;
query_note - apparaît lorsque la requête a été interprétée différemment de la façon dont elle était écrite.

Avec snippets: true, chaque résultat comporte aussi snippets, une liste de trois chaînes au plus tirées du code source autour de la correspondance. Il s’agit du code d’autres personnes, transmis en tant que données.

Obtenir plus d’une page

page et rows permettent de parcourir les résultats : page: 2, rows: 20 correspond aux résultats 21 à 40. Le produit de page par rows ne peut pas dépasser le nombre de lignes par requête de votre forfait - voir Limites et erreurs.

Suivant Limites et erreurs