API pour Google SERP et On-Page

Samuel Schmitt 17 Août 2024

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

Vous êtes au bon endroit.

Avec thruuu, vous avez :

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

Vos premiers pas avec l’API SERP de thruuu

Dans ce guide, nous verrons en détail comment accéder aux endpoints de l’API SERP, comment effectuer des appels API et comment manipuler les données renvoyées.

Remarque : Si vous n’avez pas encore de compte ni de clé API, veuillez lire cette page en premier.

Constructeur de Requête

Dans le tableau de bord API, vous trouverez le constructeur de requêtes, un outil utile pour structurer correctement vos demandes API.

Nous vous recommandons de l’utiliser pour bien prendre en main l’API et vous assurer que vos requêtes sont correctement configurées.

Effectuer votre premier appel à l’API SERP

Le endpoint de l’API SERP renvoie un SERP Google complet, comprenant des statistiques et des données on-page pour chaque résultat.

Pour récupérer les données, vous devrez configurer un endpoint webhook dans votre application.

Pour appeler le endpoint, effectuez la requête HTTP suivante :

POST https://api.thruuu.com/api/v2/serps

Request Headers:

{
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_TOKEN"
}

Request Body:

{
    "keywords": ["seo", "seo tool"],
    "parameters": {
        "search_engine": "google.com",
        "location": null,
        "country": "US",
        "language": "en",
        "device": "desktop",
        "search_volume": true,
        "num": 20,
        "analyze_content": false,
        "analyze_headings": false,
        "analyze_top_topics": false
    },
    "reference": null,
    "minified_response": false
}

Explication des principaux paramètres :

Réponse API

Lors de l’initiation réussie d’une demande en masse, vous recevrez la réponse suivante :

{
   "message": "Bulk API initiated successfully",
   "success": true,
   "id": "670a7acabcfc2555366172ea",
   "credits": {
       "free": 5,
       "paid": 0,
       "sub": 500
   }
}

Comme le processus peut prendre plus de 30 secondes, l’API thruuu notifiera votre endpoint webhook avec un objet JSON contenant les résultats.

Configuration d’un endpoint Webhook

Voici un exemple en NodeJS pour configurer un endpoint HTTP POST pour recevoir des données de l’API thruuu.

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(`event type:${req.body.data.eventType}`);
   console.log(`data: ${req.body.data}`);
 }
 // Return a response to acknowledge receipt of the event
 res.json({ received: true });
});
 
app.listen(8000, () => console.log('Running on port 8000'));

Résultats

Lorsque votre webhook reçoit une notification, vous recevrez une réponse avec les données au format suivant :

Éléments Clés :

Focus sur l’objet SERPS

Chaque objet dans serps inclut :

{
  "id": "SERP_RESULT_ID",
  "query": "KEYWORD",
  "search_url": "Google Search URL",
  "device": "desktop",
  "hl": "en",
  "gl": "us",
  "search_engine": "google",
  "number_of_results": 11500000,
  "related_searches": [ /* Related searches */ ],
  "result": [ /* SERP results */ ],
  "keywords_title": [ /* Keywords in title */ ],
  "keywords_description": [ /* Keywords in description */ ],
  "similar_questions": { /* Similar questions */ },
  "similar_headings": [ /* Common headings */ ],
  "search_volume": { /* Search volume info */ }
}

Pour plus de détails, consultez la documentation sur les champs individuels.

Recupérer la liste des SERPs

Endpoint

Description

Cet endpoint retourne une liste de résultats de SERP avec leurs métadonnées de base, y compris la requête de chaque SERP, son identifiant unique et d’autres détails récapitulatifs.

Vous pouvez utiliser les paramètres page et itemsPerPage pour paginer la liste des SERPs, permettant une gestion efficace des ensembles de données volumineux.

Query Parameters

Exemple

GET https://api.thruuu.com/api/v2/serps?page=1&itemsPerPage=50


Recupérer un SERP by ID

Endpoint

Description

Cet endpoint récupère les informations détaillées pour un seul SERP à partir de son identifiant unique.

La réponse inclut toutes les métadonnées associées, les détails de la page, ainsi que toute analyse disponible pour ce résultat de SERP spécifique.

Path Parameter

Exemple

GET https://api.thruuu.com/api/v2/serps/<ID>

Commencez avec l’API SERP de thruuu

Avec thruuu, vous gagnerez beaucoup de temps dans l’analyse des SERPs et obtiendrez de meilleurs résultats SEO en créant le contenu idéal.

Commencez gratuitement