API pour Google SERP et On-Page (Automatisez votre SEO)

Vous recherchez une API SEO de la SERP de Google et On-Page fournissant :

• Les 100 premiers résultats de la recherche Google pour n’importe quel mot-clé, pays, localisation ou appareil
• Des statistiques sur le nombre de mots, le nombre d’images, la mise à jour du contenu
• La structure des titres et le contenu du corps pour n’importe quelle page
• Des données sur une page comme les métadonnées, le schéma et les liens
• La densité des mots-clés et les N-grams
• Et bien plus encore…

Vous êtes au bon endroit.

Avec thruuu, vous avez :

• Un analyseur de SERP exceptionnel
• Une API pour accéder à toutes les données de Google Search de manière programmatique
• Une API pour scraper des pages web individuelles et obtenir des données On-Page

Vous pouvez désormais automatiser votre analyse des SERP avec une API performante.

Scrapez les SERP de Google ou des pages web via API

Avec thruuu, vous pouvez accéder aux services suivants via l’API :

• Scraping de la SERP (API SERP) : vous obtenez une vue complète de la page de résultats de recherche Google, chaque résultat est scrappé et les informations clés sont extraites.
• Scraping d’une page web (API Website) : vous obtenez de nombreuses informations On-Page telles que les titres, le nombre de mots, la densité des mots-clés, et plus encore à partir d’une URL unique.

Pour accéder à l’API, vous devez créer un compte et vous abonner.

L’API est réservée aux abonnés.

• L’API SERP (pour scrapper Google) est accessible à tous les abonnés. Chaque appel à l’API coûte 1 crédit.
• L’API WEBSITE (pour scrapper une URL) est uniquement disponible pour les utilisateurs de l’offre Agency. Les appels à cette API sont gratuits et illimités.

Une fois connecté, ouvrez le menu et visitez les sections API et Outils en masse.

Votre première étape avec l’API SERP de thruuu

Pour utiliser l’API, vous avez besoin de deux éléments :

• Une clé API
• Un endpoint webhook

La clé API vous permet d’accéder à l’API de manière programmatique.

Vous pouvez générer une nouvelle clé API en cliquant sur « Générer une clé » dans l’interface. Cette clé devra être présente dans chaque requête faite à l’API.

Le deuxième paramètre est le endpoint webhook.

L’API thruuu utilise des webhooks pour notifier votre application lorsqu’une SERP a été scrappée avec succès.

Le endpoint webhook est une URL configurée sur votre application (ou serveur) qui reçoit des données de l’API thruuu.

Vous devez entrer un endpoint valide et cliquer sur « Mettre à jour le endpoint ».

Nous détaillerons plus tard comment configurer votre serveur pour être notifié par thruuu, ou vous pouvez simplement regarder la vidéo ci-dessous (en anglais).

Comment utiliser l’API de thruuu

Dans les sections suivantes, nous verrons en détail comment accéder à chacun des services fournis par l’API de thruuu avec des exemples en NodeJS.

Dans l’interface, vous trouverez un Request builder pour vous aider à construire vos requêtes.

Endpoint : Scraper la SERP

Cet endpoint retourne une SERP Google complète, des statistiques et des données On-Page pour tout résultat.

Pour recevoir les données de thruuu, vous devrez avoir configuré un endpoint webhook sur votre application.

Pour faire un appel à cet endpoint, vous devez effectuer la requête HTTP suivante :

GET  https://api.thruuu.com/api/v1/scrape-serp

Avec les paramètres suivants :

q	La requête de recherche (obligatoire)
apikey	La clé API générée par thruuu (obligatoire)
search_engine	Le moteur de recherche Google (optionnel, par défaut : google.com)
location	La géolocalisation (optionnelle)
country	Le code du pays (optionnel, par défaut : US)
language	Le code de la langue (optionnel, par défaut : en)
device	L’appareil – desktop ou mobile (optionnel, par défaut : desktop)
num	Le nombre de résultats de recherche. Les valeurs peuvent être de 1 à 100 (optionnel, par défaut : 10)
headingAnalysis	Si vous souhaitez activer l’outil IA qui analysera les titres les plus fréquents, définissez le paramètre sur true. (optionnel, par défaut : false)
contentAnalysis	Si vous souhaitez activer l’outil IA qui analysera les paragraphes les plus fréquents, définissez le paramètre sur true. (optionnel, par défaut : false)
id	Un identifiant optionnel que vous pouvez transmettre à l’API. S’il est fourni, cet ID sera inclus dans la réponse du webhook. (optionnel, par défaut : null)

Voici un exemple pour appeler l’endpoint depuis un navigateur :

https://api.thruuu.com/api/v1/scrape-serp?apikey=YOUR_API_KEY&q=what is thruuu&search_engine=google.com&location=&country=US&language=en&device=desktop&num=10&id=123&contentAnalysis=true&headingAnalysis=true

Comme le processus peut prendre plus de 30 secondes, thruuu notifiera le webhook endpoint défini sur votre application et retournera un objet JSON contenant le résultat dans un objet data.

Suivez cet exemple en NodeJS pour configurer un endpoint HTTP sur votre serveur afin d’accepter une requête avec la méthode POST :

const express = require('express');
const app = express();
 
// Match the raw body to content type application/json
// If you are using Express v4 - v4.16 you need to use body-parser, not express, to retrieve the request body

app.post('/test-webhook', express.json({ type: 'application/json', limit: '50MB' }), async (req, res) => {
 console.log('request from thruuu is coming');
 if (req.body !== undefined && req.body.data !== undefined) {
   console.log('request from thruuu is valid');
   console.log(`query -> ${req.body.data.query}`);
   console.log(`event type -> ${req.body.data.eventType}`);
   console.log(`id -> ${req.body.data.id}`);
 }
 // Return a response to acknowledge receipt of the event
 res.json({ received: true });
});
 
app.listen(8000, () => console.log('Running on port 8000'));

From there, you can manipulate a JSON object containing the following main (but not only) properties:

query	La requête de recherche
result	La page de résultats du moteur de recherche contenant toutes les pages scrappées
related _searches	Les recherches associées affichées sur Google
similar_questions	Questions similaires trouvées sur la page de résultats
Keywords_*	Fréquence des mots-clés pour différents éléments tels que le titre, la description, etc.
num	Le nombre de résultats de recherche. Les valeurs peuvent être de 1 à 100 (optionnel, par défaut : 10)
id	L’identifiant que vous avez passé lors de l’appel à l’API
eventType	Lors de l’appel à l’API SERP, le type d’événement est « serp-scrape ».

Endpoint : Scraper une page web

Cet endpoint retourne un scraping d’une page web, incluant des informations On-Page et de traitement du langage naturel (NLP). Il n’est pas nécessaire d’avoir configuré un webhook endpoint sur votre application.

Pour faire un appel à cet endpoint, vous devez effectuer la requête HTTP suivante :

GET  https://api.thruuu.com/api/v1/scrape-url

With the following parameters:

url	L’URL de la page à scraper (obligatoire)
apikey	La clé API générée par thruuu (obligatoire)
language	La langue du contenu (optionnelle)

Voici un exemple pour appeler l’endpoint depuis un navigateur :

https://api.thruuu.com/api/v1/scrape-url?apikey=YOUR_API_KEY&url=https://samuelschmitt.com/what-is-a-topic-cluster&language=en

À partir de là, vous pouvez manipuler un objet JSON contenant les principales propriétés suivantes (mais pas seulement) :

title	Le titre de la page
h1, h2, h3	Les titres (headlines) de la page
wordCount	Le nombre de mots sur la page
toc	La table des matières de la page
comment_questions	Toutes les questions trouvées dans la section des commentaires
body	Le corps (contenu principal) de la page
kwBody	Les termes les plus fréquents trouvés dans le corps de la page