AI SEO In Detail › Module D · Analyse des SERP › Épisode 27
API SERP DataForSEO : obtenez les résultats Google en direct par programmation
Récupérez les résultats Google en direct avec l'API SERP DataForSEO : paramètres clés, coût par requête, lecture de la réponse par type d'élément et stockage de snapshots à comparer.
Vidéo bientôt disponibleCet épisode est scénarisé et en cours de production. La transcription ci-dessous correspond au script initial ; il peut évoluer avant la publication de la vidéo.
1,019 mots · brouillon du script, en cours de relecture.
Introduction
L'épisode dernier, on a analysé dix pages de résultats à la main. Ça a pris une heure, et ça en valait la peine.
Maintenant vous avez quatre cents mots-clés. À la main, c'est une semaine. Et le mois prochain vous voulez recommencer, pour voir ce qui a changé.
On ne peut pas sauvegarder une page de résultats depuis un navigateur utilement. Une capture d'écran ne peut pas être triée, filtrée ou comparée.
Dans cet épisode on va récupérer des résultats Google via l'API DataForSEO : quels paramètres comptent, combien ça coûte, comment lire la réponse par type, et comment stocker chaque page comme instantané à comparer plus tard.
L'endpoint et ses paramètres
On a configuré le compte et fait un premier appel dans l'épisode trois. Maintenant on utilise un endpoint spécifique : SERP, Google, organic, live, advanced. "Live" signifie que vous obtenez la réponse dans la même requête. "Advanced" signifie tous les éléments de la page, pas que les liens bleus.
La requête est une liste de tâches. Chaque tâche décrit une recherche, avec quelques paramètres qui comptent.
Le mot-clé, exactement comme une personne le taperait.
La localisation. En nom ou en code numérique. Le code pour les États-Unis est deux mille huit cent quarante. Les résultats diffèrent beaucoup entre pays, et pour sujets locaux entre villes, donc définissez toujours ça explicitement.
Le code de langue, par exemple "en".
L'appareil : desktop ou mobile. Les résultats peuvent être différents, et on les comparera proprement dans l'épisode trente-quatre.
Et la profondeur : combien de résultats vous voulez. Dix vous donne la page un. Trente vous donne les trois premières pages.
Ce que ça coûte
La profondeur est le principal levier de coût. Dans ma facturation, une requête live à profondeur dix coûte un tiers de centime. À profondeur trente, environ le double.
Donc quatre cents mots-clés à profondeur dix fait environ un dollar vingt. À profondeur trente, environ deux dollars quarante. Pas cher, mais ça s'accumule si vous relancez chaque semaine, ou si vous mettez la profondeur à cent sans réfléchir.
Ma règle est simple. Profondeur dix pour l'analyse. Trente seulement quand vous devez voir les pages deux et trois, comme quand vous suivez des pages à portée de l'épisode dix. Et avant chaque run, le script affiche le nombre de mots-clés fois le prix et attend un oui. C'est le verrou de coût de l'épisode six.
La réponse vous dit aussi ce que chaque tâche a réellement coûté. Loggez ça. C'est le vrai prix, et ça vous dit quand la grille tarifaire a changé.
Lire la réponse
La réponse est imbriquée, mais la partie utile est simple. Dans tasks, puis result, il y a une liste appelée items. Chaque item est un élément sur la page de résultats, dans l'ordre d'apparition.
Chaque item a un type. "Organic" est un lien bleu normal. D'autres sont "featured snippet", "people also ask", "local pack", "video", "images" et "AI overview". L'épisode vingt-huit détaille ce que chacun signifie.
Chaque item a aussi deux positions, et les mélanger est l'erreur la plus courante. Rank group est la position dans son propre type. Le troisième résultat organique a rank group trois. Rank absolute est la position parmi tous les éléments de la page. Si un snippet, une rangée vidéo et une question viennent d'abord, ce même troisième résultat organique peut avoir rank absolute six.
Aucun ne correspond exactement à la position moyenne de Search Console. Search Console fait la moyenne sur plein de recherches, appareils et jours. L'API vous donne un instantané. Utilisez l'API pour voir à quoi ressemble la page, et Search Console pour voir ce qui s'est réellement passé.
Pour les items organiques, vous utiliserez surtout le domaine, l'URL, le titre et la description. Ça suffit pour le clustering, classer qui rank, et la correspondance de titre.
Mon parseur fait d'abord une chose simple : il boucle sur les items et les trie dans des buckets par type. Les items organiques vont dans une liste, le reste dans une liste features, avec la position gardée. Ne supposez jamais que le premier item est le premier résultat organique. Sur beaucoup de pages ce n'est pas le cas, et ça seul casse beaucoup de rank trackers maison.
Le résultat liste aussi quels types d'items apparaissent sur la page, avant même d'ouvrir les items. C'est un moyen rapide de marquer les mots-clés avec carte, rangée vidéo ou résumé IA sans rien parser.
Stocker les snapshots
Stockez chaque réponse deux fois.
D'abord, la réponse brute comme fichier dans votre dossier cache, nommé par mot-clé, localisation, appareil et date. C'est votre reçu. Si plus tard vous voulez un champ non parsé, pas besoin de repayer.
Ensuite, les items parsés comme lignes dans une table SQLite. Une ligne par item, avec mot-clé, localisation, appareil, date, type, les deux positions, domaine, URL et titre. Une page devient un instantané, dix à trente lignes plus les features.
Maintenant les questions de la feuille deviennent de simples requêtes. Qui rank le plus souvent sur mes mots-clés ? Quels mots-clés ont une rangée vidéo ? Où commence le premier résultat organique ? Et comme chaque ligne a une date, le run du mois prochain se compare à celui-ci, mot-clé par mot-clé.
Une autre habitude. Vérifiez le statut de chaque tâche, pas que de la requête. Une requête peut réussir alors qu'une tâche échoue, par exemple à cause d'une localisation mal orthographiée. Écrivez les tâches échouées dans une liste et relancez que celles-là.
Pièges à éviter
Résumé des pièges. Oublier la localisation, donc analyser le mauvais pays. Utiliser une profondeur haute par défaut et payer pour pages que personne ne lit. Mélanger rank group et rank absolute dans le même rapport. Et comparer des instantanés pris avec des paramètres différents.
Aucun ne se montre comme erreur. Ils se montrent comme conclusions légèrement fausses. C'est pourquoi les paramètres sont stockés sur chaque ligne.
Pour conclure
Donc : définir localisation, langue, appareil et profondeur exprès, verrou coût, et stocker chaque page comme instantané daté. Le script Python pour récupérer, parser et stocker est lié dans la description. Épisode suivant : ce que tous ces autres types signifient — snippets, question boxes, local packs et AI Overviews — et ce qu'ils font à vos clics. À bientôt.