Introdução
O que existe hoje, como se usa, e o que ainda não existe. Nada aqui é documentado antes de estar construído.
Disponível hoje
A exportação CSV dos seus dados em todos os planos, o relatório mensal em PDF, e um endpoint MCP que serve a um assistente quatro leituras da semana atual.
Ainda não construído
Não há uma API REST de leitura. As páginas que a descreveriam não estão aqui, de propósito: documentação de um endpoint que não responde custa a alguém uma tarde até o descobrir.
Exportação CSV
Os seus dados em CSV, a partir do mesmo endereço que a plataforma usa. Disponível em todos os planos.
Conjuntos de dados
Um ficheiro por conjunto. As linhas limitam-se à marca com que tem a sessão iniciada.
- prompts (dataset): As suas perguntas: texto, categoria, fase de intenção, persona, tópico, estado, e se a pergunta nomeia a sua marca.
- competitors (dataset): Os concorrentes da sua conta: nome, domínio, classificação e estado.
- perception (dataset): Presença semanal e sentimento líquido por marca, a sua incluída.
Autenticação
A exportação usa a sua sessão iniciada, como a própria plataforma. Abra o endereço num browser onde tenha a sessão iniciada; não há chaves de API.
Relatório mensal em PDF
A leitura da semana, o plano, e os números com os respetivos denominadores. Escrito para ser reencaminhado sem ser preciso explicá-lo primeiro.
O que traz
O que mudou, quem foi nomeado e quem foi escolhido, de onde vieram as respostas, e as ações ordenadas por gravidade, esforço e horizonte.
Quem o recebe
Todos os planos. É enviado todos os meses, e os mesmos dados estão na plataforma no resto do tempo.
Endpoint MCP
Quatro leituras da semana atual (resumo, plano de ação, concorrentes, a leitura escrita) expostas a um assistente que fala MCP, para as suas próprias ferramentas perguntarem em vez de extraírem dados de um dashboard.
Autenticação
OAuth com a sua conta Periscopy. O assistente pede-lhe que inicie sessão e aprove; o token que recebe diz quem é, que marca, e a sua função, e um pedido não pode fazer mais do que você poderia.
Só de leitura
Todas as ferramentas leem. Nada pode ser escrito através deste endpoint.
Disponibilidade
A pedido. Diga-nos que assistente quer ligar.
API de leitura
Ainda não construída. Hoje não há uma API REST contra a qual escrever código, e esta página não vai descrever uma como se houvesse.
Entretanto
Se o que precisa é de alimentar o seu BI, o seu PIM ou os seus próprios relatórios, diga-nos: sobe na lista, e a exportação CSV já traz hoje as mesmas linhas.
Quando existir
Vai estar no registo de alterações no dia em que sair, com a data.