Accueil
POST/api/v1/outils-ia/generer-idees-articles

API Générateur d'idées d'articles

Génère une liste de sujets d'articles de blog, chacun avec un angle et une question à laquelle il répond.

Présentation

À partir d'un thème, d'un public et d'un objectif éditorial, cet endpoint propose des idées d'articles prêtes à être rédigées : un titre, l'angle retenu et la question du lecteur à laquelle l'article répond.

Un modèle de langage hébergé par Websource génère les idées selon l'objectif choisi (trafic, autorité, conversion, fidélisation ou partage), qui oriente le type de sujet proposé. Vous pouvez restreindre les formats (guide, comparatif, étude de cas…) et fournir les titres déjà utilisés pour ne pas les revoir. Les idées sans titre exploitable sont écartées ; si aucune n'est valide, l'API répond 503 et vous pouvez simplement réessayer.

Pour alimenter un calendrier éditorial, préparer un brief de rédaction ou automatiser la recherche de sujets d'une agence ou d'un éditeur de contenu. Seul le sujet est obligatoire, mais préciser le public et l'activité améliore nettement la pertinence.

Utilisation pas à pas

  1. 1Envoyez au minimum le subject (3 à 200 caractères), idéalement avec audience et activity.
  2. 2Ajustez la function, les formats et le nombre d'idées (count : 3, 4 ou 6).
  3. 3Parcourez ideas : chaque idée fournit title, angle et question (plan est toujours une liste vide : le plan détaillé se génère à la demande sur la page de l'outil).

Limites à connaître

  • Sujet de 3 à 200 caractères ; audience et activity jusqu'à 200 ; keywords jusqu'à 300 ; excludedTitles jusqu'à 4 000 caractères au total.
  • Le nombre d'idées demandé peut être légèrement inférieur au nombre renvoyé si le modèle produit des entrées invalides.

Endpoint et authentification

POSThttps://www.websource.fr/api/v1/outils-ia/generer-idees-articles

Chaque requête porte votre jeton dans l'en-tête Authorization, et le corps est envoyé en JSON (Content-Type: application/json). Le jeton est gratuit, sur demande depuis votre compte (formulaire en bas de page).

Authorization: Bearer VOTRE_JETON

Paramètres du corps (JSON)

ParamètreTypeRequisDescription
subjectstringRequisThème général des articles (3 à 200 caractères).
audiencestringOptionnelPublic visé (200 caractères max).
activitystringOptionnelActivité ou secteur de l'auteur (200 caractères max).
functionstringOptionnel'trafic', 'autorite', 'conversion', 'fidelisation' ou 'partage' — défaut 'trafic'.
formatsarray<string>OptionnelParmi 'guide', 'retour_experience', 'comparatif', 'idee_recue', 'etude_de_cas', 'tutoriel', 'prise_de_position', 'enquete'.
keywordsstringOptionnelMots-clés à intégrer (300 caractères max).
excludedTitlesarray<string>OptionnelTitres déjà utilisés, à ne pas reproposer.
countintOptionnel3, 4 ou 6 — défaut 4.

Exemples de code

Le même appel en plusieurs langages. Remplacez VOTRE_JETON par le jeton reçu par e-mail et gardez-le côté serveur (variable d'environnement), jamais dans un dépôt public.

curl -X POST https://www.websource.fr/api/v1/outils-ia/generer-idees-articles \
  -H "Authorization: Bearer VOTRE_JETON" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Sécurité des sites WordPress","audience":"Dirigeants de TPE","activity":"Agence web","function":"trafic","formats":["guide","idee_recue"],"count":6}'

Réponses

Réponse en cas de succès (code 200) :

{
  "success": true,
  "ideas": [
    {
      "title": "…",
      "angle": "…",
      "plan": [],
      "question": "…"
    }
  ]
}
CodeSignificationQue faire
400Paramètre manquant ou invalideLisez le champ error, il précise la limite dépassée.
401Jeton absent, invalide ou révoquéVérifiez l'en-tête Authorization.
429Limite horaire atteinteAttendez l'échéance indiquée dans Retry-After.
503Service momentanément indisponibleRéessayez après quelques instants.

Toute erreur a la forme {"success": false, "error": "…"}. Limite par défaut : 60 requêtes par heure et par jeton (ajustable sur demande).

Demander un accès API

Gratuit. Un jeton vous est envoyé par e-mail une fois la demande approuvée. Il donne accès à tous les outils de cette API.

Pour demander un accès, connectez-vous ou créez un compte gratuit. Vous reviendrez ensuite directement sur ce formulaire.