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.
project_idobligatoirepageper_pageoutput
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.
project_idobligatoire:idID du rapportmodelbrandnom ou liste séparée par des virgulesdimensionpageper_pageoutput
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é.
project_idfacultatifstatusactive|archivedpageper_pageoutput
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.
: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.
:idID de l’étude:report_idmodelsubjectnom ou liste séparée par des virgulesdimensionpageper_pageoutput
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.
project_idobligatoirerecalculatebooléen, false par défaut