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 when you need to inspect a specific journey.
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 visitor |
| visitorIds | string | no | Comma-separated related visitor IDs to include in detail lookups |
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 ID belongs to the selected workspace and date range.
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?