Skip to main content

​
Cursor-based pagination

All list endpoints (/comments, /reviews, /dms, /mentions) return up to 100 results per page. To page through more, use the cursor returned in the previous response. 
# First page
GET /v1/accounts/:id/comments?limit=50

# Next page (use cursor from previous response)
GET /v1/accounts/:id/comments?limit=50&cursor=eyJpZCI6IjE3ODQx...
When there are no more results, the response will not include a cursor field.

​
Polling for new items with since

To incrementally poll for new interactions, use the since parameter with an RFC3339 timestamp: 
GET /v1/accounts/:id/comments?since=2026-02-15T00:00:00Z
Recommended polling strategy:
  1. Store the created_at of the newest item from your last response
  2. On the next poll, pass it as since
  3. Process and store the new items
  4. Repeat on a schedule (e.g. every 60 seconds)

​
Parameters

ParameterTypeDefaultDescription
limitinteger50Results per page. Min 1, max 100.
cursorstring—Opaque pagination cursor from previous response.
sincestring—RFC3339 timestamp. Return only items created after this time.