Introduction
Ce qui existe aujourd’hui, comment l’utiliser, et ce qui n’existe pas encore. Rien n’est documenté ici avant d’être construit.
Disponible aujourd’hui
L’export CSV de vos propres données dans toutes les offres, le rapport PDF mensuel, et un endpoint MCP qui fournit quatre lectures de la semaine en cours à un assistant.
Pas encore construit
Il n’existe pas d’API REST de lecture. Les pages qui en décriraient une ne figurent pas ici, à dessein : documenter un endpoint qui ne répond pas coûte un après-midi à quelqu’un avant qu’il ne s’en rende compte.
Export CSV
Vos propres données en CSV, depuis la même adresse que celle qu’utilise la plateforme. Disponible dans toutes les offres.
Jeux de données
Un fichier par jeu de données. Les lignes se limitent à la marque sur laquelle vous êtes connecté.
- prompts (dataset): Vos questions : texte, catégorie, étape d’intention, persona, thème, état, et si la question cite votre marque.
- competitors (dataset): Les concurrents de votre compte : nom, domaine, groupe et statut.
- perception (dataset): Présence hebdomadaire et sentiment net par marque, la vôtre comprise.
Authentification
L’export utilise votre session connectée, comme la plateforme elle-même. Ouvrez l’adresse dans un navigateur où vous êtes connecté ; il n’y a pas de clés d’API.
Rapport PDF mensuel
La lecture de la semaine, le plan, et les chiffres avec leurs dénominateurs. Rédigé pour être transmis sans explication préalable.
Ce qu’il contient
Ce qui a changé, qui a été cité et qui a été choisi, d’où venaient les réponses, et les actions hiérarchisées par gravité, effort et horizon.
Qui le reçoit
Toutes les offres. Il est envoyé chaque mois, et les mêmes données sont dans la plateforme le reste du temps.
Endpoint MCP
Quatre lectures de la semaine en cours (synthèse, plan d’action, concurrents, la lecture rédigée) exposées à un assistant compatible MCP, pour que vos propres outils puissent interroger au lieu d’extraire les données d’un tableau de bord.
Authentification
OAuth avec votre compte Periscopy. L’assistant vous invite à vous connecter et à donner votre accord ; le jeton qu’il reçoit indique qui vous êtes, quelle marque et votre rôle, et une requête ne peut pas faire plus que vous.
Lecture seule
Tous les outils lisent. Rien ne peut être écrit par cet endpoint.
Disponibilité
Sur demande. Dites-nous quel assistant vous souhaitez connecter.
API de lecture
Pas encore construite. Il n’existe aujourd’hui aucune API REST sur laquelle développer, et cette page ne va pas en décrire une comme si elle existait.
En attendant
Si vous avez besoin d’alimenter votre BI, votre PIM ou vos propres rapports, dites-le-nous : cela remonte dans la liste, et l’export CSV contient déjà les mêmes lignes aujourd’hui.
À sa sortie
Elle figurera dans le journal des modifications le jour même, avec la date.