Set Up Agent Analytics

Overview

Track the activity of AI agents, crawlers, scrapers, and all other bots in the agent list on your website in real time. You can set up client analytics, server analytics, or both.

1. Create a New Project

Sign up for Dark Visitors
Navigate to the Projects page
Click the New Project button
Enter your website details
Click Create

2. Set Up Client Analytics

Client analytics lets you track browser-using AI agent sessions and LLM referrals.

WordPress Javascript Tag

3. Set Up Server Analytics

Server analytics lets you track crawlers, scrapers, and all other bots that don't run JavaScript.

WordPress Node.js API

Call the Visits API to track each incoming pageview request to your website.

The Request

Endpoint
URL	`https://api.darkvisitors.com/visits`
HTTP Method	`POST`
Headers
`Authorization`	A bearer token with your project's access token (e.g. `Bearer 48d7dcbd-fc44-4b30-916b-2a5955c8ee42`).
`Content-Type`	This needs to be set to `application/json`
Body
`request_path`	The URL path of your visitor's request
`request_method`	The HTTP method of your visitor's request (e.g. `GET`, `POST`, etc.)
`request_headers`	The HTTP headers of your visitor's request, as a key-value object. Please make sure to strip out anything sensitive.

Tips

Add this call in middleware to cover all of your pages from one place.
Don't wait for the API response (i.e. make it non-blocking) to avoid adding latency to your page response.
Ensure that errors are handled in a way that does not make your page response fail too.

Example

This cURL example sends a visit. If the visit is from an artificial agent, it will show up in agent analytics.

curl -X POST https://api.darkvisitors.com/visits \
-H "Authorization: Bearer ${ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
    "request_path": "'"${request.path}"'",
    "request_method": "'"${request.method}"'",
    "request_headers": "'"${request.headers}"'"
}'

4. Test Your Integration

Click on your project
Click Settings
Click Send a Test Visit
Click realtime

If your website is correctly connected to your project, you should see visits from the Dark Visitor agent in the realtime timeline.