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"
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 |
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?