Get unique visitors
GET
/
v1
/
analytics
/
/
visitors
Get unique visitors
curl --request GET \
--url https://api.mintlify.com/v1/analytics/{projectId}/visitors \
--header 'Authorization: Bearer <token>'{
"totals": {
"human": 123,
"ai": 123,
"total": 123
},
"visitors": [
{
"path": "<string>",
"human": 123,
"ai": 123,
"total": 123
}
],
"hasMore": true
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}{
"error": "<string>",
"details": [
{
"message": "<string>"
}
]
}Use this endpoint to export unique visitor analytics. Results include both site-wide totals and per-page breakdowns, split by human and AI traffic. The total field is deduplicated across human and AI traffic. Paginate through results using offset-based pagination. Increment offset by limit while hasMore is true.
Filtering
Section titled “Filtering”Filter visitor data by date range using dateFrom and dateTo parameters.
Rate limits
Section titled “Rate limits”This endpoint allows 100 requests per organization per hour. All analytics endpoints share this limit.
Authorizations
Section titled “Authorizations”Authorization
string
header
required
The Authorization header expects a Bearer token. Use an admin API key. This is a server-side secret key. Generate one on the API keys page in your dashboard.
Path Parameters
Section titled “Path Parameters”projectId
string
required
Your project ID. Can be copied from the API keys page in your dashboard.
Query Parameters
Section titled “Query Parameters”dateFrom
string
Date in ISO 8601 or YYYY-MM-DD format
Example:
"2024-01-01"
dateTo
string
Date in ISO 8601 or YYYY-MM-DD format. dateTo is an exclusive upper limit. Results include dates before, but not on, the specified date.
Example:
"2024-01-01"
limit
integer
default:50
Max results per page (1-250, default 50). Increment offset by limit while hasMore is true to paginate.
Required range: 1 <= x <= 250
offset
integer
default:0
Number of rows to skip. Use offset = (page - 1) * limit for page-based access.
Required range: x >= 0
Response
Section titled “Response”Site-wide totals and per-path visitor counts
totals
object
required
Site-wide unique visitor totals for the date range.
Show child attributes
visitors
object[]
required
Per-page visitor counts.
Show child attributes
hasMore
boolean
required
Whether additional results are available beyond this page.
⌘I