Passer au contenu principal
Google SERP (Search Engine Results Page) est la page de résultats que les utilisateurs voient après avoir saisi une requête dans le moteur de recherche Google. Elle affiche des résultats de recherche organiques, des publicités, des extraits optimisés, des graphes de connaissances ainsi que divers contenus tels que des images et des vidéos, dans le but de fournir aux utilisateurs les informations les plus pertinentes. Cet article présentera en détail l’API Google SERP, qui permet d’obtenir les résultats d’une requête saisie dans le moteur de recherche Google. Le contenu des résultats comprend également de nombreux types, tels que des extraits optimisés, des graphes de connaissances ainsi que des images et d’autres résultats. Ce document présentera les instructions d’intégration de l’API Google SERP.

​
Processus de demande

Pour utiliser l’API Google SERP, obtenez d’abord votre API Token dans la console Ace Data Cloud et conservez-le pour une utilisation ultérieure. Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter. Une fois terminé, vous reviendrez automatiquement à la page actuelle. Un seul API Token permet d’appeler tous les services de la plateforme, sans avoir besoin d’en demander un séparément pour chaque service. La première demande offre un quota gratuit, permettant une expérience gratuite ; lorsque le quota est insuffisant, vous pouvez recharger votre solde universel dans la console.
📘 Documentation complète : Google SERP API →

​
Utilisation de base

Saisissez les mots-clés et le type de ressource de recherche pour obtenir les résultats : utilisez query pour transmettre les mots-clés et type pour choisir les types de recherche tels que les pages web, les images et les actualités ; cette interface ne nécessite pas de transmettre model. Par exemple, pour rechercher des informations sur « apple inc », nous pouvons ensuite renseigner le contenu correspondant dans l’interface, comme illustré ci-dessous :

Nous pouvons voir que nous avons défini ici les Request Headers, notamment :
  • accept : le format de réponse que vous souhaitez recevoir ; renseignez ici application/json, c’est-à-dire le format JSON.
  • authorization : la clé permettant d’appeler l’API, qui peut être directement sélectionnée dans la liste déroulante après la demande.
Les Request Body suivants ont également été définis :
  • type : le type de ressource de recherche ; actuellement, seuls six types sont pris en charge, la valeur par défaut est search.
  • query : les mots-clés de recherche.
  • country : le pays où se situent les résultats de recherche personnalisés ; la valeur par défaut est les États-Unis (US).
  • language : la langue des résultats de recherche personnalisés ; la valeur par défaut est l’anglais (en).
  • range : la plage temporelle des résultats de recherche personnalisés ; par défaut, il n’y a aucune limite.
  • number : la taille de page de la pagination des résultats de recherche personnalisés ; la valeur par défaut est 10.
  • page : le numéro de page de la pagination des résultats de recherche personnalisés ; la valeur par défaut est 1.
Après la sélection, vous pouvez constater que le code correspondant a également été généré à droite, comme illustré ci-dessous :

Cliquez sur le bouton « Try » pour effectuer le test. Comme illustré ci-dessus, nous obtenons ici le résultat suivant :
Le résultat renvoyé comporte plusieurs champs, présentés ci-dessous :
  • knowledge_graph, le graphe de connaissances des résultats de recherche.
  • organic, les informations détaillées des résultats de recherche.
  • people_also_ask, les questions liées aux mots-clés de recherche.
  • related_searches, les recherches associées aux mots-clés de recherche.
On peut voir que, parmi les résultats renvoyés ici, il existe un champ organic, qui contient principalement les résultats des mots-clés de recherche. De plus, si vous souhaitez générer le code d’intégration correspondant, vous pouvez le copier directement pour le générer. Par exemple, le code CURL est le suivant :
Le code d’intégration Python est le suivant :

​
Type de recherche personnalisé

Si vous personnalisez le type de ressources de recherche, nous pouvons modifier le paramètre type, qui comprend respectivement les ressources ordinaires search, les ressources d’images images, les ressources d’actualités news, les ressources de cartes maps, les ressources de lieux places et les ressources vidéo videos. Cet article utilisera les ressources vidéo videos comme exemple. Nous allons maintenant démontrer les opérations spécifiques. Tout d’abord, définissez le paramètre type sur videos, puis transmettez normalement le paramètre query, comme illustré ci-dessous :

Le code correspondant est le suivant :
Vous pouvez obtenir la réponse suivante :
Le résultat renvoyé comporte plusieurs champs, présentés comme suit :
  • news, liste des informations vidéo dans les résultats de recherche.
Vous pouvez voir qu’il y a un champ videos dans les résultats renvoyés ici, qui contient principalement les résultats des mots-clés de recherche.

​
Pays où se trouvent les ressources de recherche personnalisée

Cette interface prend également en charge la restriction du pays où se trouvent les résultats de recherche, nous pouvons ajouter le paramètre country pour limiter le pays, le paramètre saisi est l’abréviation du pays, par exemple cn (Chine), us (États-Unis), cet article prendra la Chine comme exemple ci-dessous, voici les informations spécifiques :

L’effet de sortie est le suivant :
On peut voir que les résultats sont des résultats de recherche dans le pays China, et le contenu spécifique est similaire à celui ci-dessus.

​
Langue personnalisée des résultats de recherche

Nous pouvons également personnaliser la langue des résultats de recherche. Ici, nous ajoutons un champ supplémentaire language, dont le contenu est zh-cn, qui désigne la langue chinoise simplifiée. D’autres langues sont également prises en charge, mais vous devez saisir l’abréviation de la langue, comme en (English), fr (French), zh-cn (Chinese (Simplified)) et d’autres langues, comme illustré ci-dessous :

Le code correspondant est le suivant :
Le résultat de l’exécution est le suivant :
On peut voir que les résultats affichés ici sont tous en chinois simplifié, et que le contenu des résultats est similaire à celui présenté ci-dessus.

​
Personnaliser la plage temporelle des résultats de recherche

Cet article permet également de personnaliser la plage temporelle des résultats de recherche, y compris cinq options : qdr:h (dernière heure), qdr:d (dernier jour), qdr:w (dernière semaine), qdr:m (dernier mois), et aucune limite par défaut. Nous pouvons transmettre la plage temporelle correspondante via range, par exemple, ici elle est définie sur qdr:d, ce qui signifie rechercher les résultats du dernier jour, donc l’entrée est la suivante :

Le code correspondant est le suivant :
Le résultat d’exécution est le suivant :
Comme vous pouvez le voir, nous avons réussi à obtenir les résultats de recherche du dernier jour, dont le contenu est similaire à celui présenté ci-dessus.

​
Personnaliser la pagination des résultats de recherche

Cette API prend également en charge l’affichage paginé personnalisé des résultats de recherche, number et page indiquent respectivement la taille de page et le numéro de page de la pagination. Cet article définira une pagination avec 20 résultats de recherche par page. Les informations spécifiques sont illustrées dans l’image :

Remarque : lorsque le nombre de résultats par page dépasse 10, les crédits déduits seront doublés.
Le code est le suivant :
Le résultat d’exécution est le suivant :
On peut voir qu’ici, les résultats de recherche sont affichés avec une pagination, avec 20 résultats affichés sur une page, et le contenu des résultats est similaire à celui ci-dessus.