Visitors API
Read visitor summaries and individual visitor detail.
Last updated June 3, 2026
The visitors endpoint returns recent visitor summaries. Pass visitorId to read one visitor detail record by its Grometrics visitor ID or a linked application user ID.
GET /api/analytics/visitors
1curl "https://usegrometrics.com/api/analytics/visitors?range=7d&limit=25" \2-H "Authorization: Bearer YOUR_API_KEY"
GET one visitor
1curl "https://usegrometrics.com/api/analytics/visitors?visitorId=vis_8kF3mNx92pL" \2-H "Authorization: Bearer YOUR_API_KEY"
A visitor profile returns the newest 50 activity groups and an opaque nextTimelineCursor when older activity exists. Pass that value as timelineCursor to load the next 50 groups. Use export=web, export=mobile, or export=both only when you need the complete event history CSV.
GET more visitor activity
1curl "https://usegrometrics.com/api/analytics/visitors/vis_8kF3mNx92pL?timelineCursor=OPAQUE_CURSOR" \2-H "Authorization: Bearer YOUR_API_KEY"
Export one visitor
1curl "https://usegrometrics.com/api/analytics/visitors/vis_8kF3mNx92pL?export=both" \2-H "Authorization: Bearer YOUR_API_KEY"
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | no | Maximum visitor rows to return |
| visitorId | string | no | Return detail for one Grometrics visitor ID or linked application user ID |
| timelineCursor | string | no | Opaque cursor for the next 50 groups on an individual visitor profile |
| export | string | no | Complete event CSV for one visitor: web, mobile, or both |
What happens next
Use visitor detail data to connect source, session, and revenue context in internal support or growth workflows.
Troubleshooting
Visitor is not found
Check that the visitor or application user ID belongs to the selected workspace and date range, and that identify has linked the application account.
Visitor has no identity
Anonymous visitors only show the journey data Grometrics has tracked before an identify call links them to a user.
Was this page helpful?