ResearchAnything API
ResearchAnything's programmatic surface is the Platform API: two query endpoints, authenticated with an ra- key from the API Console. This page sums it up in ResearchAnything's terms and points to the full reference.
01At a glance
| Item | Value |
|---|---|
| Base URL | https://researchanything.ai |
| Endpoints | POST /api/query returns the finished answer as JSON. POST /api/query/stream streams the run as Server-Sent Events. |
| Authentication | Authorization: Bearer ra-… or X-Api-Key: ra-… |
| Getting a key | Any ResearchAnything account can create keys in the API Console at researchanything.ai/console/keys. |
| Request | {"query": "…"}, 1 to 2,000 characters. |
| Model and sources | RA-Lite, with sources chosen automatically from the web and academic databases. |
| Limits | One research run per call, from your plan's monthly allowance. |
02A request
curl https://researchanything.ai/api/query \
-H "Authorization: Bearer $ESSARION_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "What were the main findings of recent trials of GLP-1 drugs for heart failure?"}'The response carries request_id, status, answer (Markdown with [S1]-style source markers), sources, usage and errors. See Queries for every field and Streaming for the event stream.
03How API runs relate to the app
- Same account, same allowance. A call uses one research run from the monthly allowance your runs in the app use: 3 a month on Free, 40 on Pro, 100 on Researcher. See Usage.
- RA-Lite only. The API always runs RA-Lite. RA-1, RA-2, Max and Auto, depth modes, and the Web or Papers source modes are available in the app, not through the API, whatever your plan.
- No projects. An API run is stored against your account but is not attached to a project, and the API cannot read or write projects, documents, the library or Cite.
- Citations included. Each source in the response carries ready-made citations in MLA, APA, Chicago, IEEE, Harvard and BibTeX. The citation generator with its wider range of formats is part of the app only. See Citations.
- Runs in the Console. API calls are listed on the Console's Usage page, where each opens a run timeline.
04What is not part of the API
The ResearchAnything web app talks to its own endpoints under /api/v1/: starting and following research runs, sources, projects, documents, Cite and the library. Those endpoints accept only the browser session, are built for the app's own pages, and change with it. They are not an integration surface and are not documented here. Earlier versions of this page listed some of them.
There are no webhooks, and no API access to Sourcipedia or Essarion Science.
05Full reference
- Overview: base URL, limits and the response envelope.
- Authentication: API keys and the session cookie.
- Quickstart: from a new account to a first answer.
- Queries and Streaming: the two query endpoints.
- Run timelines, API keys and Usage: what the Console shows, and the endpoints behind it.
- Errors: codes and retry guidance.