Skip to content
Documentation

REST API reference

Base URL: https://api.perception.to. Send a Perception key as Authorization: Bearer pcp_... where a route requires authentication.

GET /index

Perception Index score, status, 24h/7d change, confidence and decomposed drivers. Updated every 15 minutes.

Open without a key. One REST call uses 0 credit.

GET /transparency-index

Earnings-call directness scores per company, with the verbatim quotes behind each score.

Open without a key. One REST call uses 0 credit.

GET /transparency-index/leaderboard

Companies ranked by directness score.

Bearer authentication required. One REST call uses 1 credit.

GET /transparency-index/:ticker

Full directness detail for one company, including scored quotes.

Bearer authentication required. One REST call uses 1 credit.

GET /feed

Mention search across thousands of sources with full-text search, date, outlet and sentiment filters.

Bearer authentication required. One REST call uses 1 credit.

GET /trends

AI-extracted narrative trends with signal strength and the mentions behind each cluster.

Bearer authentication required. One REST call uses 1 credit.

GET /intelligence

Trend intelligence and category distribution.

Bearer authentication required. One REST call uses 1 credit.

GET /sentiment-metrics

Historical sentiment series, by day and by outlet.

Bearer authentication required. One REST call uses 1 credit.

GET /fear-greed-index

Bitcoin Fear & Greed Index history.

Bearer authentication required. One REST call uses 1 credit.

GET /channel-volume

Mention volume broken down by outlet and channel.

Bearer authentication required. One REST call uses 1 credit.

POST /grouped-data

Entity recognition over a body of coverage: company mentions with counts and sentiment.

Bearer authentication required. One REST call uses 1 credit.

GET /cohorts

Sentiment split by the role of the speaker: execs, devs, analysts, investors, media and more.

Bearer authentication required. One REST call uses 1 credit.

GET /evadometer

Evade-o-Meter directness scoring across tracked companies.

Bearer authentication required. One REST call uses 1 credit.

GET /evadometer/leaderboard

Companies ranked by how directly management answers.

Bearer authentication required. One REST call uses 1 credit.

GET /evadometer/:ticker

Evade-o-Meter detail for one company.

Bearer authentication required. One REST call uses 1 credit.

GET /v1/spaces/:id/rows

Rows from a Space you own, in the same shape as its CSV export. Cursor-paginated, 50 per page by default.

Bearer authentication required. One REST call uses 1 credit.

GET /v1/brains/:id

A Brain you own: the collected post history behind it.

Bearer authentication required. One REST call uses 1 credit.