Forme de la réponse
Une recherche réussie renvoie un 200 avec un objet JSON :
{ "search": "mount everest", "page": 1, "knowledgeGraph": { "title": "Mount Everest", "description": "Earth's highest mountain above sea level…", "attributes": { "Elevation": "8,849 m", "First ascent": "1953" } }, "organic": [ { "position": 1, "title": "Mount Everest - Wikipedia", "link": "https://en.wikipedia.org/wiki/Mount_Everest", "snippet": "Mount Everest is Earth's highest mountain…", "sitelinks": [{ "title": "Height", "link": "https://…" }] } ], "ads": [ { "position": 1, "title": "Everest Treks", "link": "https://…", "block": "top" } ], "peopleAlsoAsk": ["How tall is Mount Everest?"], "relatedSearches": [{ "query": "k2 mountain" }], "stats": { "balance": 9988, "cost": 6, "cached": false }}Champs de premier niveau
Section intitulée « Champs de premier niveau »| Champ | Type | Remarques |
|---|---|---|
search | chaîne | La requête qui a été exécutée. |
page | entier | La page renvoyée (indexée à partir de 1). |
organic | tableau | Résultats organiques classés. |
ads | tableau ? | Résultats sponsorisés, lorsqu’ils sont présents. |
knowledgeGraph | objet ? | Le panneau d’entité Google, lorsqu’il est présent. |
peopleAlsoAsk | string[] ? | Questions « Autres questions posées ». |
relatedSearches | tableau ? | « Autres recherches associées ». |
stats | objet ? | Infos de facturation — voir Tarifs. |
OrganicResult
Section intitulée « OrganicResult »position, title, link, snippet, date optionnel, et sitelinks[] { title, link } optionnel.
position, title, link, displayedLink optionnel, snippet optionnel, block ("top" ou
"bottom"), et sitelinks[] optionnel.
KnowledgeGraph
Section intitulée « KnowledgeGraph »title, imageUrl optionnel, description, descriptionSource, descriptionLink, et une
table attributes de faits clé/valeur.
Pour le schéma exhaustif et toujours à jour (y compris chaque forme d’erreur), voir la référence de l’API, générée à partir du contrat OpenAPI.