Skip to main content
GET
Get unique visitors

Uso

Usa este endpoint para exportar el análisis de visitantes únicos. Los resultados incluyen totales del sitio completo y desgloses por página, divididos entre tráfico humano y de IA. El campo total se deduplica entre el tráfico humano y el de IA. Pagina los resultados usando paginación basada en desplazamiento. Incrementa offset en limit mientras hasMore sea true.

Filtrado

Filtra los datos de visitantes por rango de fechas usando los parámetros dateFrom y dateTo.

Límites de uso

Este endpoint permite 100 solicitudes por organización por hora. Todos los endpoints de analytics comparten este límite.

Autorizaciones

Authorization
string
header
requerido

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.

Parámetros de ruta

projectId
string
requerido

Your project ID. Can be copied from the API keys page in your dashboard.

Parámetros de consulta

dateFrom
string

Date in ISO 8601 or YYYY-MM-DD format

Ejemplo:

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

Ejemplo:

"2024-01-01"

limit
integer
predeterminado:50

Max results per page (1-250, default 50). Increment offset by limit while hasMore is true to paginate.

Rango requerido: 1 <= x <= 250
offset
integer
predeterminado:0

Number of rows to skip. Use offset = (page - 1) * limit for page-based access.

Rango requerido: x >= 0

Respuesta

Site-wide totals and per-path visitor counts

totals
object
requerido

Site-wide unique visitor totals for the date range.

visitors
object[]
requerido

Per-page visitor counts.

hasMore
boolean
requerido

Whether additional results are available beyond this page.