API des résultats de recherche Google (GOOGLE_SERP) - querying.ai

GOOGLE_SERP charge une page de résultats google.com et renvoie ses résultats organiques et ses panneaux. Il n’attend pas d’AI Overview : il répond donc plus vite que GOOGLE et coûte moins cher. Utilisez-le pour le suivi de positionnement, ou pour trouver des pages à lire avec WEB_SCRAPE.


`taskType`	`GOOGLE_SERP`
Entrée	`query` (obligatoire) ; `page`, `country`, `location`, `include`
Crédits	1 par tâche
Pays	`US` par défaut. Tout code ISO 3166-1 alpha-2.
Position	Prise en charge. Voir Régions et position.

Requête

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_SERP", "payload": { "query": "best running shoes for flat feet", "country": "US", "page": 2 } }'

La tâche s’exécute de façon asynchrone. Lisez le résultat comme décrit dans Tâches asynchrones.

Paramètres

Champ	Obligatoire	Description
`query`	Oui	La requête de recherche, de 1 à 100 000 caractères. `prompt` est accepté si `query` est absent.
`page`	Non	Page de résultats, un entier de 1 à 10. `1` par défaut. Chaque page contient dix résultats organiques. Les autres valeurs renvoient `422 VALIDATION_ERROR`.
`country`	Non	Le marché Google à interroger. `US` par défaut.
`location`	Non	`{ "latitude", "longitude" }` en degrés décimaux. Google répond comme à un utilisateur situé à ce point, et le résultat le renvoie dans `location`.
`include.rawResponse`	Non	`true` ajoute le HTML de la page de résultats dans `rawContent`. La page est volumineuse, souvent près d’un mégaoctet.

Réponse

Par exemple, la page 2 d’une requête :

{
  "organicResults": [
    { "position": 11, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "page": 2 }
  ],
  "peopleAlsoAsk": [{ "...": "..." }],
  "relatedSearches": [{ "...": "..." }],
  "ads": [{ "...": "..." }],
  "page": 2
}

Champ	Description
`organicResults`	Toujours présent. `position` compte à travers les pages : le premier résultat de la page 2 est donc `11`. Chaque ligne porte la `page` dont elle provient.
`page`	La page chargée.
`peopleAlsoAsk`, `relatedSearches`, `knowledgeGraph`	Les panneaux de Google, quand la page les affiche.
`ads`	Les annonces du haut et du bas, quand la page en affiche.
`map`	Le pack local : des lieux avec `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews` et plus, quand la page en affiche un.
`serp`	Les autres panneaux présents : `topStories`, `videoResults`, `localMap`, `discussionsAndForums`.
`location`	Le point envoyé, si vous en avez envoyé un.
`rawContent`	Le HTML de la page de résultats, avec `include.rawResponse: true`.

Les panneaux absents de la page sont omis, et non renvoyés comme null ou []. Traitez tous les champs sauf organicResults et page comme facultatifs. Il n’y a ni aioverview, ni text, ni sources ; utilisez GOOGLE pour l’AI Overview.

Limites et erreurs

Un organicResults vide dans une tâche terminée signifie que Google lui-même n’a renvoyé aucun résultat pour la requête. C’est confirmé sur un second navigateur avant d’être renvoyé.
Une page hors de 1-10 renvoie 422 VALIDATION_ERROR.
Une location mal formée renvoie 400 VALIDATION_ERROR.
Les autres erreurs de requête sont listées dans Erreurs.

Voir aussi

Google AI Overviews pour la même page avec son AI Overview
Web scrape pour lire la page d’un résultat en Markdown
Régions et position