API pour créer des Briefs SEO de Contenu

Samuel Schmitt 3 Nov 2024

Vous recherchez une API de briefs de contenu ?

Avec l’API de thruuu, vous pouvez :

Si vous souhaitez faire évoluer votre production de contenu, vous êtes au bon endroit.

Avec thruuu, vous disposez de :

Voyons comment démarrer avec l’API de Brief SEO de thruuu.

Commencer avec l’API de Brief SEO de thruuu

Ce guide vous explique comment accéder aux points de terminaison de l’API de Brief, effectuer des appels API et manipuler les données renvoyées.

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

Générateur de Requêtes

Dans le tableau de bord de l’API, vous trouverez le Générateur de Requêtes, un outil pratique pour structurer correctement vos requêtes API.

Nous vous recommandons de l’utiliser pendant que vous vous familiarisez avec l’API pour assurer une configuration correcte.

Effectuer votre premier appel à l’API de Brief

Ce endpoint vous permet de créer des briefs de contenu en masse en fonction des mots-clés et paramètres fournis.

Il analyse les SERP pour les mots-clés donnés et génère des briefs de contenu à l’aide d’un modèle spécifié.

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

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

Request Headers:

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

Request Body:

{
    "keywords": [
        "what is a content brief",
        "seo tools"
    ],
    "parameters": {
        "search_engine": "google.com",
        "location": null,
        "country": "US",
        "language": "en",
        "device": "desktop",
        "search_volume": true,
        "num": 20,
        "analyze_content": true,
        "analyze_headings": true
    },
    "template_id": "<ID>",
    "outline_prompt_id": "<ID>",
    "reference": "<REF>"
}

Explication des Paramètres Clés :

Explication des Paramètres Clés :

Réponse de l’API

Une fois la requête en masse initiée avec succès, vous recevrez la réponse suivante :

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

Étant donné que le processus peut durer plus de 30 secondes, l’API de thruuu notifiera votre endpoint de webhook avec un objet JSON contenant les résultats.

Configurer un Endpoint Webhook

Voici un exemple en NodeJS pour configurer un point de terminaison HTTP POST pour recevoir des données de l’API de 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

Une fois que votre webhook reçoit une notification, vous obtiendrez une réponse au format suivant :

{
  "eventType": "bulk-brief",
  "id": "670a9411a237576baf4a7135",
  "briefs": [
    {
      "id": "670a9426f5a0ccf086712534",
      "label": "brief example",
      "keyword": "brief example",
      "status": "Draft",
      "relatedSERP": "<SERP ID>",
      "contentBlock": [/* Array data here */],
      "creationDate": "2024-10-12T15:22:14.360Z",
      "modificationDate": "2024-10-12T15:22:14.360Z"
    }
  ]
}

Éléments Clés

L’Objet contentBlock

Le contentBlock est un tableau contenant des éléments du modèle de brief (par exemple, directives pour le rédacteur, résumé de l’article, plan). Chaque élément contient des informations détaillées.

Pour en savoir plus sur l’objet contentBlock et ses objets internes, consultez ce document.

Endpoints Additionnels de l’API de Brief de Contenu

Obtenir la Liste des Briefs de Contenu

Exemple de requête :

GET /api/v2/briefs?page=1&itemsPerPage=20

Obtenir un Brief de Contenu Unique par ID

Exemple de requête :

GET /api/v2/briefs/<brief_id>

Obtenir la Liste des Modèles de Brief

Obtenir la Liste des Formats de Plan

Commencez avec l’API de Brief de Contenu de thruuu

Avec thruuu, vous gagnerez beaucoup de temps en analysant le SERP et obtiendrez de meilleurs résultats SEO en créant le contenu idéal.

Commencez gratuitement