Introduction
What exists today, how to use it, and what does not exist yet. Nothing here is documented before it is built.
Available today
CSV export of your own data on every plan, the monthly PDF report, and an MCP endpoint that serves four reads of the current week to an assistant.
Not built yet
There is no REST read API. The pages that would describe one are not here, on purpose: documentation for an endpoint that does not answer costs someone an afternoon before they find out.
CSV export
Your own data as CSV, from the same address the platform uses. Available on every plan.
Datasets
One file per dataset. Rows are limited to the brand you are signed in to.
- prompts (dataset): Your questions: text, category, intent stage, persona, topic, state, and whether the question names your brand.
- competitors (dataset): The competitors on your account: name, domain, bucket and status.
- perception (dataset): Weekly presence and net sentiment per brand, yours included.
Authentication
The export uses your signed-in session, like the platform itself. Open the address in a browser where you are signed in; there are no API keys.
Monthly PDF report
The week's reading, the plan, and the numbers with their denominators. Written to be forwarded without explaining it first.
What it carries
What changed, who was named and who was chosen, where the answers came from, and the actions ranked by severity, effort and horizon.
Who gets it
Every plan. It is sent monthly, and the same data is in the platform the rest of the time.
MCP endpoint
Four reads of the current week (summary, action plan, competitors, the written reading) exposed to an assistant that speaks MCP, so your own tools can ask instead of scraping a dashboard.
Authentication
OAuth with your Periscopy account. The assistant sends you to sign in and approve; the token it receives carries who you are, which brand, and your role, and a request cannot do more than you could.
Read only
Every tool reads. Nothing can be written through this endpoint.
Availability
On request. Tell us which assistant you want to connect.
Read API
Not built yet. There is no REST API to write against today, and this page is not going to describe one as if there were.
In the meantime
If feeding your BI, your PIM or your own reports is what you need, say so: it moves up the list, and the CSV export carries the same rows today.
When it ships
It will be in the changelog the day it does, with the date.