AI Visibility Setup
Send request metadata to Hardal for AI agent, AI search bot, LLM crawler, and classic crawler analysis
AI Visibility analyzes bot, crawler, and AI agent traffic from request metadata sent to Hardal.
Hardal can detects whether the request comes from a bot. If the request is not from a bot, Hardal discards it and does not process it. This keeps AI Visibility fully KVKK and GDPR compliant.
Endpoint
Send events to:
POST https://analytics.usehardal.com/agent-events
Required headers:
| Header | Value |
|---|---|
Content-Type | application/json |
Tenant-Id | Find your Tenant-Id on your dashboard |
Payload fields
Send the following JSON fields with each request:
| Field | Type | Required | Description |
|---|---|---|---|
path | string | Yes | Requested path on the website. |
ip | string | Yes | Visitor IP address. |
userAgent | string | Yes | Raw User-Agent header from the request. |
eventTime | string | Yes | Request time in ISO 8601 format. |
sourceId | string | Yes | Source identifier. Use hardal unless the Hardal team gives you a different value. |
Example payload
{
"path": "/local-test",
"ip": "87.250.224.230",
"userAgent": "Mozilla/5.0 (compatible; YandexNews/4.0; +http://yandex.com/bots)",
"eventTime": "2026-04-29T15:12:17.836Z",
"sourceId": "hardal"
}
Was this page helpful?