GET /v1/user/interests
List the authenticated user's captured interests (strongest first)
GET
/v1/user/interests
List the authenticated user's captured interests (strongest first)
Query Parameters
limit
integer
optional
query
Number of items (default 20, max 100)
offset
integer
optional
query
Offset for pagination (default 0)
Responses
200
OK
application/jsoncode
integer
data
object
hasMore
boolean
items
object[]
Array of:
kind
string
app | tag | interest (display badge)
lastSeen
string
last reinforced
source
string
conversation, manual, behavior, …
strength
number
0-1 decayed effective score
tagId
string
stable id, used to delete
value
string
the interest itself
limit
integer
offset
integer
message
string
requestId
string
401
Unauthorized
500
Internal Server Error
curl -X GET 'https://api.example.com/v1/user/interests' \ -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://api.example.com/v1/user/interests', { method: 'GET', headers: { "Authorization": "Bearer YOUR_API_TOKEN" }});const data = await response.json();console.log(data);
import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://api.example.com/v1/user/interests', headers=headers)print(response.json())
package mainimport ( "fmt" "io" "net/http")func main() { req, _ := http.NewRequest("GET", "https://api.example.com/v1/user/interests", nil) req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() result, _ := io.ReadAll(resp.Body) fmt.Println(string(result))}
200
Response
{ "code": 200, "data": { "hasMore": true, "items": [ { "kind": "interest", "lastSeen": "<string>", "source": "conversation", "strength": 0.82, "tagId": "interest_ab12cd34ef56", "value": "NVDA" } ], "limit": 123, "offset": 123 }, "message": "success", "requestId": "req_abc123"}
API Playground
Try this endpoint
GET
/v1/user/interests
