GEO Writer

Créez et gérez des tâches GEO Writer assistées par l’IA. Les tâches sont traitées de façon asynchrone : créez-en une, puis interrogez-la jusqu’à ce qu’elle soit terminée.

POST/intelligence_tasks

Crée une tâche GEO Writer. Deux modes : à partir d’un prompt (indiquez prompt_id) ou agentique (indiquez custom_topic, user_instructions ou les deux). Le type product_listing prend à la place un objet produit et renvoie un texte de fiche produit prêt à appliquer.

Corps (JSON) :
  • project_idobligatoire
  • task_typeobligatoire : brief, create, update, pr_insights, custom, product_listing
  • prompt_id
  • custom_topic
  • user_instructions
  • output_language_code
  • existing_content
  • existing_content_url

Pour product_listing uniquement : product (obligatoire : title, ainsi que external_id, description_html, seo_title, seo_description, url, product_type et jusqu’à 20 images composées d’un id et d’un alt) et prompt_ids (jusqu’à 20 prompts du projet que le texte doit cibler). Une fois la tâche terminée, son result_data contient summary, description_html, faq, seo_title, seo_description, image_alts et changes.

GET/intelligence_tasks

Liste les tâches GEO Writer d’un projet, avec des filtres facultatifs.

Paramètres :
  • project_idobligatoire
  • task_type
  • statuspending|processing|review|completed|in_progress|blocked|discarded
  • page
  • per_page

Les tâches écartées ne sont jamais listées : status=discarded renvoie donc une page vide.

GET/intelligence_tasks/:id

Renvoie le détail complet d’une tâche, y compris les données du résultat une fois la tâche terminée. Accepte l’ID numérique ou le public_id.

Paramètres :
  • project_idobligatoire
  • :idID ou public_id de la tâche, dans l’URL

PATCH/intelligence_tasks/:id

Modifie les blocs de texte existants d’une tâche terminée sans la régénérer. Chaque clé de l’objet edits est un chemin à points vers une valeur texte de result_data (par exemple sections.0.content), et seul un texte existant peut être modifié. Une valeur identique au texte enregistré est ignorée, et la première modification enregistre un instantané de la version générée par l’IA pour pouvoir la restaurer.

Corps (JSON) :
  • project_idobligatoire
  • :idID ou public_id de la tâche, dans l’URL
  • editsobligatoire, objet associant chaque chemin à points à son nouveau texte

Nécessite une clé API avec droit d’écriture.

result_version (facultatif) : envoyez le result_version renvoyé lors de la lecture de la tâche. Si la tâche a été régénérée entre-temps, la modification est refusée avec ERR_STALE_CONTENT (HTTP 409) et rien n’est écrit : relisez la tâche et renvoyez vos modifications. Sans ce paramètre, les modifications s’appliquent au contenu actuel de la tâche.

POST/intelligence_tasks/:id/revert

Annule toutes les modifications manuelles et restaure la version générée par l’IA, enregistrée lors de la première modification. Renvoie ERR_INVALID_PARAM si la tâche n’a aucune modification manuelle.

Paramètres :
  • project_idobligatoire
  • :idID ou public_id de la tâche, dans l’URL

Nécessite une clé API avec droit d’écriture.

GET/cms/content

Liste les articles ou les pages du site WordPress connecté au projet dans Paramètres du projet, de la modification la plus récente à la plus ancienne. Le site répond en direct et rien n’est stocké. Les titres sont du texte brut issu du site.

Paramètres :
  • project_idobligatoire
  • typepost ou page
  • statuspublish, future, draft, pending, private ou any
  • search
  • page
  • per_page50 au maximum

Renvoie ERR_CMS_NOT_CONNECTED ou ERR_CMS_ACCESS_REVOKED avec meta.connect_url lorsque le site doit être connecté ou reconnecté.

GET/cms/content/:id

Récupère un article ou une page du site WordPress connecté à partir de son identifiant WordPress. Le contenu est assaini pour ne garder que les titres, paragraphes, listes, tableaux, citations, code et liens ; les images, les scripts et les contenus intégrés sont supprimés.

Paramètres :
  • project_idobligatoire
  • :ididentifiant WordPress, dans l’URL
  • typepost ou page

POST/intelligence_tasks/:id/send_to_cms

Envoie un article terminé ou une mise à jour de contenu au site WordPress connecté, sous forme de nouveau brouillon. Rien n’est publié et aucun article existant n’est modifié. Le brouillon est créé en arrière-plan ; le champ cms_drafts de la tâche indique son statut et son lien de modification. Un nouvel envoi de la même version renvoie le brouillon existant.

Paramètres :
  • project_idobligatoire
  • :idID ou public_id de la tâche, dans l’URL

Nécessite une clé API avec droit d’écriture. Non disponible sur les domaines des portails en marque blanche.