Documentation Index
Fetch the complete documentation index at: https://docs.hackgate.io/llms.txt
Use this file to discover all available pages before exploring further.
HackGATE records every request that passes through your proxy and makes this data available through the Analytics API. You can query traffic stats, see which researchers are most active, and discover which paths they’ve been testing — all scoped to your HackGATE URL and a time range.
All analytics queries use the url parameter set to your HackGATEd URL (e.g. example-yourorg.hackgate.net), and gte/lte for the time range in ISO 8601 format.
Total requests
Get the total number of requests that passed through your HackGATE in a given time range:
curl "https://admin.hackgate.io/api/analytics/getTotalRequest?url=example-yourorg.hackgate.net>e=2024-01-01T00:00:00Z<e=2024-01-31T23:59:59Z" \
-H "Authorization: Bearer <your-token>"
Returns the total hit count across the time range.
Most active researchers
Get the top researchers ranked by request count:
curl "https://admin.hackgate.io/api/analytics/getMostActiveUsers?url=example-yourorg.hackgate.net>e=2024-01-01T00:00:00Z<e=2024-01-31T23:59:59Z" \
-H "Authorization: Bearer <your-token>"
Returns the top 10 researchers ranked by request count.
Path discovery
See which URL paths researchers have been testing, ranked by how frequently each was hit:
curl "https://admin.hackgate.io/api/analytics/getPathDiscovery?url=example-yourorg.hackgate.net>e=2024-01-01T00:00:00Z<e=2024-01-31T23:59:59Z" \
-H "Authorization: Bearer <your-token>"
Returns up to 1,000 paths with hit counts.
Traffic timeline
Get an hourly breakdown of requests per researcher:
curl "https://admin.hackgate.io/api/analytics/getTrafficTimeline?url=example-yourorg.hackgate.net>e=2024-01-01T00:00:00Z<e=2024-01-31T23:59:59Z" \
-H "Authorization: Bearer <your-token>"
Activity log
The activity log shows when your HackGATE was deployed, started, and stopped:
curl https://admin.hackgate.io/api/sites/getLog/<site-id> \
-H "Authorization: Bearer <your-token>"
Response:
[
{ "id": "log1", "date": "2024-01-15T10:30:00Z", "action": "Deployed" },
{ "id": "log2", "date": "2024-01-15T10:35:00Z", "action": "Started" },
{ "id": "log3", "date": "2024-01-29T17:00:00Z", "action": "Stopped" }
]
Monthly usage
Get the number of unique days your HackGATE was active in a given month:
curl "https://admin.hackgate.io/api/sites/getUsageByMonth/<site-id>?year=2024&month=1" \
-H "Authorization: Bearer <your-token>"
Response:
{ "year": 2024, "month": 1, "uniqueDays": 15 }