The traffic analytics endpoints give you detailed visibility into researcher activity on your HackGATE-protected sites. You can count total requests, identify the most active researchers, see which paths they have discovered, and pull timeline charts — all scoped to a time window you define. For multi-site rollups, use the summary endpoints that accept an array of URLs.
All traffic endpoints require a valid Bearer token in the Authorization header.
Common query parameters
Most single-site endpoints share these query parameters:
The hackgatedName of the HackGATE site to query. This is the subdomain identifier assigned when the site was created.
Start of the time range, as an ISO 8601 date-time string (for example, 2025-07-01T00:00:00Z).
End of the time range, as an ISO 8601 date-time string (for example, 2025-07-14T23:59:59Z).
Single-site endpoints
Total requests
Most active users
Path discovery
Traffic timeline
Traffic table
GET /api/analytics/getTotalRequest
GET https://api-admin.hackgate.io/api/analytics/getTotalRequest
curl "https://api-admin.hackgate.io/api/analytics/getTotalRequest?url=my-site>e=2025-07-01T00:00:00Z<e=2025-07-14T23:59:59Z" \
-H "Authorization: Bearer <token>"
GET /api/analytics/getMostActiveUsers
GET https://api-admin.hackgate.io/api/analytics/getMostActiveUsers
curl "https://api-admin.hackgate.io/api/analytics/getMostActiveUsers?url=my-site>e=2025-07-01T00:00:00Z<e=2025-07-14T23:59:59Z" \
-H "Authorization: Bearer <token>"
GET /api/analytics/getPathDiscovery
GET https://api-admin.hackgate.io/api/analytics/getPathDiscovery
curl "https://api-admin.hackgate.io/api/analytics/getPathDiscovery?url=my-site>e=2025-07-01T00:00:00Z<e=2025-07-14T23:59:59Z" \
-H "Authorization: Bearer <token>"
GET /api/analytics/getTrafficTimeline
GET https://api-admin.hackgate.io/api/analytics/getTrafficTimeline
curl "https://api-admin.hackgate.io/api/analytics/getTrafficTimeline?url=my-site>e=2025-07-01T00:00:00Z<e=2025-07-14T23:59:59Z" \
-H "Authorization: Bearer <token>"
GET /api/analytics/getTrafficTable
GET https://api-admin.hackgate.io/api/analytics/getTrafficTable
curl "https://api-admin.hackgate.io/api/analytics/getTrafficTable?url=my-site>e=2025-07-01T00:00:00Z<e=2025-07-14T23:59:59Z" \
-H "Authorization: Bearer <token>"
Multi-site summary endpoints
Use these endpoints when you need aggregated traffic data across multiple HackGATE sites in a single request. Both accept a JSON body instead of query parameters.
Summary traffic table
Summary timeline
POST /api/analytics/getSummaryTrafficTable
POST https://api-admin.hackgate.io/api/analytics/getSummaryTrafficTable
Body parameters
Array of hackgatedName values identifying the sites to include in the summary.
Start of the time range as an ISO 8601 date-time string.
End of the time range as an ISO 8601 date-time string.
Example
curl -X POST https://api-admin.hackgate.io/api/analytics/getSummaryTrafficTable \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"urls": ["site-alpha", "site-beta"],
"gte": "2025-07-01T00:00:00Z",
"lte": "2025-07-14T23:59:59Z"
}'
POST /api/analytics/getSummaryTimeline
POST https://api-admin.hackgate.io/api/analytics/getSummaryTimeline
Body parameters
Array of hackgatedName values identifying the sites to include.
Start of the time range as an ISO 8601 date-time string.
End of the time range as an ISO 8601 date-time string.
Example
curl -X POST https://api-admin.hackgate.io/api/analytics/getSummaryTimeline \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"urls": ["site-alpha", "site-beta"],
"gte": "2025-07-01T00:00:00Z",
"lte": "2025-07-14T23:59:59Z"
}'
