Recommandations

Les mêmes exécutions de recommandations que celles qui alimentent la page Recommandations de l’application, ainsi que l’endpoint qui en lance une nouvelle.

GET/recommendations

Liste les exécutions de recommandations d’un projet, avec des filtres par type et par statut.

Paramètres :
  • project_idobligatoire
  • recommendation_typeai_visibility|social_community|brand_building|sentiment_reputation
  • statuspending|processing|completed|failed
  • page
  • per_page

Une valeur d’énumération non valide renvoie ERR_INVALID_PARAM.

GET/recommendations/:id

Une exécution de recommandations avec ses éléments et les données du rapport : un tableau d’éléments avec titre, priorité, étapes d’action, métadonnées et références de sources, ainsi que le nombre d’éléments par statut active, completed, archived.

Paramètres :
  • project_idobligatoire
  • :iddans l’URL
  • item_statusactive|completed|archived
  • resolve_source_refstrue par défaut

POST/recommendations

Lance une nouvelle génération (le même moteur que la page Recommandations de l’application). Exécution asynchrone (1 à 3 minutes) : interrogez GET /recommendations/:id jusqu’à ce que le statut soit completed. Consomme le budget hebdomadaire d’éléments de recommandation du projet (ERR_LIMIT_REACHED s’il est épuisé, ou si une exécution du même type est déjà en attente). sentiment_reputation nécessite le forfait Scale ou supérieur. Nécessite une clé API avec droit d’écriture.

Corps (JSON) :
  • project_idobligatoire
  • recommendation_typeai_visibility par défaut | social_community | brand_building | sentiment_reputation

PATCH/recommendations/:id/items/:item_id

Marque un élément d’une exécution de recommandations comme terminé (completed), l’archive (archived) ou le remet à l’état active, comme les boutons de la page Recommandations. Lors de l’archivage, un motif facultatif (reason) guide les exécutions suivantes : not_relevant et too_complex écartent les recommandations similaires des prochaines exécutions, et pour un élément « Relations presse et citations » qui cible un domaine, competitor ou not_relevant empêche que ce site soit à nouveau suggéré. Renvoie l’élément sous la forme utilisée par GET /recommendations/:id pour lister les éléments. Nécessite une clé API avec accès en écriture et, pour les membres de l’équipe, l’autorisation de création sur les recommandations. Également disponible via l’outil MCP update_recommendation_item.

Chemin :
  • :idID de l’exécution de recommandations
  • :item_id

Corps (JSON) : project_id (obligatoire), status (obligatoire : completed|archived|active), reason (facultatif, avec archived uniquement : not_relevant|too_complex|competitor ; competitor uniquement pour les éléments qui ont metadata.domain). Renvoie ERR_NOT_FOUND pour une exécution ou un élément hors du projet, et ERR_INVALID_PARAM pour un motif qui ne s’applique pas.