List research

GET

https://api.caesar.xyz/research

GET

/research

1 from caesar import Caesar
2 
3 client = Caesar(
4     api_key="My API Key",
5 )
6 page = client.research.list()
7 page = page.data[0]
8 print(page.id)

Try it

1 {
2   "data": [
3     {
4       "id": "f2f6e5db-2c7d-4f56-bb0c-5a6b6a7a9b10",
5       "created_at": "2025-09-14T12:00:00Z",
6       "status": "queued",
7       "query": "Is lithium supply a bottleneck for EV adoption?",
8       "results": []
9     },
10     {
11       "id": "11111111-2222-3333-4444-555555555555",
12       "created_at": "2025-09-13T18:21:37Z",
13       "status": "completed",
14       "query": "Summarise key findings from these docs",
15       "results": [
16         {
17           "id": "string",
18           "score": 0.92,
19           "title": "IEA Global EV Outlook 2025",
20           "url": "https://www.iea.org/reports/global-ev-outlook-2025",
21           "citation_index": 1
22         }
23       ],
24       "content": "Final synthesis text…"
25     }
26   ],
27   "pagination": {
28     "limit": 10,
29     "page": 1,
30     "has_next": true
31   }
32 }

Returns a paginated list of research objects.

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

Authentication

Query Parameters

Response

Errors