SuperAnalyst API
SuperAnalyst is the AlphaSense agent for financial and strategic work. The SuperAnalyst API puts it inside your own applications. You send a question. SuperAnalyst researches it across AlphaSense content and returns a cited answer, along with the reports, dashboards, slides, and spreadsheets it builds. You can ask follow-ups in the same conversation.
It is a JSON REST API. Answers can be streamed with Server-Sent Events.
https://api.research.alpha-sense.com/superanalyst/v1
The SuperAnalyst API is in beta. It is not yet generally available, and it is still evolving: endpoints, fields, and limits may change before general availability. The Changelog lists each change.
Why SuperAnalyst
- Built on AlphaSense content. SuperAnalyst works across more than 500 million premium business and financial documents, including broker research, regulatory filings, earnings call transcripts, expert call transcripts, and trade press. It uses the content your account can access.
- Cited, auditable answers. Answers link to the documents they draw on, so you can check them at the source.
- Deliverables, not just text. A single request can return a finished report, dashboard, slide deck, or spreadsheet that your application can download.
- One request, start to finish. SuperAnalyst runs the whole workflow, from finding the research to analyzing it to writing the output. You don't chain prompts or tools yourself.
- Private by design. Each session runs in its own private environment. AlphaSense never uses your interactions or proprietary materials to train models.
What you can build
Each workflow below is one request. SuperAnalyst returns the deliverable as an artifact your application downloads.
- Independent Estimate Forecasting (dashboard): builds a bottom-up forecast, works out the assumptions behind consensus, and checks each gap against broker research, expert transcripts, and peer earnings calls. Example: "Build a bottom-up forecast of NVIDIA's next-quarter data center revenue and compare it with consensus."
- Fast-tracked Company Ramp (report): summarizes a company's last 12–24 months and the main debates about its outlook, with each view tested against contrary evidence. Example: "Get me up to speed on Snowflake: the last 18 months and the main debates about its outlook."
- Battle-Ready Competitive Set (dashboard): produces a positioning matrix, a scored head-to-head grid, and a profile of each player. Example: "Map the competitive set for CrowdStrike in endpoint security."
- Defensible Debate Map (dashboard): finds the questions investors disagree on and shows where each side stands, and why. Example: "What are the key investor debates on Tesla, and where does each side stand?"
- Outreach-Ready Buyer Universe (spreadsheet): scores strategic acquirers and financial sponsors by fit for an asset. Example: "Build a buyer universe for a mid-market US dental services platform."
- Automated Deal Diligence (slide deck): maps supplier and customer concentration and drafts the questions to ask management. Example: "Prepare diligence slides on Celsius Holdings' supplier and customer concentration, with questions for management."
For a complete example, from the request to the downloaded file, see Mag 7 Coverage Primers. One request builds a cited slide deck of company primers for the Magnificent 7.
How it works
- You start a session with a question. A session is one conversation.
- SuperAnalyst runs a turn: it researches the question and writes an answer.
- You stream the turn's events, or check the session until the turn ends. Stream when someone is waiting on the answer; check the session for background jobs.
- You read the answer and its citations from the session's messages.
- You ask a follow-up, which starts the next turn in the same session.
Some turns also produce artifacts: files such as reports and spreadsheets.
Before you start
- Your AlphaSense account needs SuperAnalyst and SuperAnalyst API access. Your account team can enable both.
- You need a client ID, client secret, and refresh token from the API Keys page. See Authentication.
- Call the API from your backend. It does not accept browser cross-origin requests.
- Every turn uses AlphaSense AI credits.
- The API acts as the user whose credentials you use. Their API sessions appear in their SuperAnalyst history in the AlphaSense web app, and sessions can't be deleted. For a backend integration, use a dedicated AlphaSense user.
Postman and OpenAPI
- Postman collection: send your first request without writing code. Import it, add your credentials, and run Get access token.
- OpenAPI spec: generate a client, or load the API into your own tools.
Both files are generated from the API's OpenAPI spec, with request bodies and parameter types added.
Where to go next
- Authentication: get an access token.
- Quick Start: ask your first question.
- Sessions and Streaming: build a full conversation.
- API Reference: every endpoint and object.
Already using GenSearch? See Migrating from the Agent API.