For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DocumentationAPI ReferenceChangelog
DocumentationAPI ReferenceChangelog
  • API Reference
      • GETGet Research Objects
      • POSTCreate a Research Object
      • POSTCreate a Brainstorm Session
      • GETGet a Research Object
      • GETGet Research Result Content
      • GETGet Research Events
      • GETGet API research integrations
      • GETGet Research Updates
      • POSTCreate a Research Update
API ReferenceResearch

Get Research Objects

GET
https://api.caesar.xyz/research
GET
/research
$curl https://api.caesar.xyz/research \
> -H "Authorization: Bearer <token>"
1{
2 "data": [
3 {
4 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
5 "created_at": "2024-01-15T09:30:00Z",
6 "status": "queued",
7 "query": "Impact of renewable energy adoption on global carbon emissions",
8 "reasoning_loops_consumed": 2,
9 "running_time": 45,
10 "results": [
11 {
12 "id": "1e4d5f7a-8b3c-4d2a-9f7e-123456789abc",
13 "title": "Renewable Energy and Carbon Emissions: A Comprehensive Review",
14 "url": "https://www.sciencedirect.com/science/article/pii/S1364032120301234",
15 "citation_index": 1
16 }
17 ]
18 }
19 ],
20 "pagination": {
21 "limit": 10,
22 "page": 1,
23 "has_next": true,
24 "total": 25
25 }
26}
Returns a paginated list of research objects.
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

pageintegerOptional>=1Defaults to 1

1-based page index.

limitintegerOptional1-200Defaults to 10

Page size (items per page).

Response

A paginated list of research objects.
datalist of objects
List of research objects.
paginationobject

Errors

401
Unauthorized Error
500
Internal Server Error