---
title: Diagnostics API
description: "##### `POST`/diagnostics/bot-detection Test if a user-agent string is detected as a bot. Response ``` { \"detected\": true, \"bot_name\": \"GPTBot\", \"category\": \"AI Crawler\", \"channel\": \"OpenAI\", \"confidence\": \"high\", \"detection_method\": \"user_agent_match\" } ``` ##### `GET`/diagnostics/current-request Inspect how PulseRank categorizes the current request. **Response**…"
url: "https://pulserank.ai/docs/diagnostics-api/"
updated: "2026-01-09"
category: API Documentation
---

# Diagnostics API

##### `POST`/diagnostics/bot-detection

Test if a user-agent string is detected as a bot.

Response

```
{
    "detected": true,
    "bot_name": "GPTBot",
    "category": "AI Crawler",
    "channel": "OpenAI",
    "confidence": "high",
    "detection_method": "user_agent_match"
}
```

##### `GET`/diagnostics/current-request

Inspect how PulseRank categorizes the current request.

**Response**

```
{
    "user_agent": "Mozilla/5.0...",
    "ip_address": "203.0.113.42",
    "headers": { ... },
    "bot_detection": { "is_bot": false, "bot_name": null },
    "referral_detection": { "is_referral": false, "source": null },
    "tracking_decision": { "will_track": false, "reason": "not_ai_traffic" }
}
```

##### `POST`/diagnostics/referral-detection

Test if a URL is detected as an AI referral source.

**Response**

```
{
    "detected": true,
    "source": "ChatGPT",
    "domain": "chatgpt.com",
    "confidence": "high",
    "path_pattern": "/c/"
}
```