Réputation et études

Des rapports d’analyse multimodèles : le score mensuel de réputation de votre marque face à ses concurrents, et les études IA personnalisées que vous définissez sur les sujets et les dimensions de votre choix. Les scores sont attribués indépendamment par plusieurs modèles d’analyse : comparez les modèles plutôt que d’en faire la moyenne à l’aveugle. Nécessite le suivi de la réputation sur le compte.

GET/reputation/reports

Les rapports de réputation mensuels d’un projet, du plus récent au plus ancien. Les rapports en attente et en échec sont inclus volontairement, car la question posée est souvent de savoir si le rapport du mois a bien été lancé. Chaque ligne indique l’ID du rapport, son statut et les modèles d’analyse qui ont produit des données.

Paramètres :
  • project_idobligatoire
  • page
  • per_page
  • output

GET/reputation/reports/:id

Les scores d’un rapport sous forme de lignes à plat : une ligne par modèle d’analyse, marque, dimension et attribut, avec son score de 0 à 100 et le raisonnement donné par le modèle. Un model inconnu renvoie ERR_INVALID_PARAM plutôt qu’une liste vide, et brand est comparé de façon exacte, et non par sous-chaîne.

Paramètres :
  • project_idobligatoire
  • :idID du rapport
  • model
  • brandnom ou liste séparée par des virgules
  • dimension
  • page
  • per_page
  • output

GET/studies

Les études IA personnalisées définies sur le compte. Les études appartiennent au compte et non à un projet : project_id est donc ici un filtre facultatif, et les études du compte sont renvoyées quel que soit le projet filtré.

Paramètres :
  • project_idfacultatif
  • statusactive|archived
  • page
  • per_page
  • output

GET/studies/:id

Une étude avec son brief, les sujets qu’elle compare, les dimensions sur lesquelles elle les évalue et l’historique de ses rapports. Utilisez les ID de reports avec l’endpoint ci-dessous.

Paramètres :
  • :idID de l’étude

GET/studies/:id/reports/:report_id

Les scores d’un rapport d’étude personnalisée sous forme de lignes à plat, au même format que ceux du rapport de réputation : une ligne par modèle d’analyse, sujet, dimension et attribut.

Paramètres :
  • :idID de l’étude
  • :report_id
  • model
  • subjectnom ou liste séparée par des virgules
  • dimension
  • page
  • per_page
  • output

POST/reputation/reports

Lance le rapport de réputation du mois en cours, comme le bouton Générer de la page Réputation, et répond 201 avec le nouveau rapport. Si le mois compte déjà un rapport qui n’a pas échoué, en cours ou terminé, rien de nouveau n’est lancé et la réponse est 200, avec created à false et ce rapport. Avec recalculate à true, l’endpoint utilise l’unique recalcul manuel du mois pour relancer tous les modèles d’analyse ; dès que le mois compte deux rapports, il renvoie ERR_LIMIT_REACHED. Interrogez GET /reputation/reports jusqu’à ce que le rapport soit terminé. Nécessite une clé read_write.

Corps :
  • project_idobligatoire
  • recalculatebooléen, false par défaut