---
title: Reports API
description: "##### `GET`/reports/overview Overview metrics with period comparison. **Parameters** `days`(integer)— Number of days to analyze (1-365). Default: 30 **Response** ``` { \"total_visits\": 1523, \"prev_total_visits\": 1204, \"referrals\": 342, \"prev_referrals\": 289, \"ai_impact_score\": 78, \"prev_ai_impact\": 65, \"avg_crawl_depth\": 3.2, \"top_channels\": [...], \"top_referrers\": [...], \"top_conversions\": [...] }…"
url: "https://pulserank.ai/docs/reports-api/"
updated: "2026-01-09"
category: API Documentation
---

# Reports API

##### `GET`/reports/overview

Overview metrics with period comparison.

**Parameters**

`days`(integer)— Number of days to analyze (1-365). Default: 30

**Response**

```
{
    "total_visits": 1523,
    "prev_total_visits": 1204,
    "referrals": 342,
    "prev_referrals": 289,
    "ai_impact_score": 78,
    "prev_ai_impact": 65,
    "avg_crawl_depth": 3.2,
    "top_channels": [...],
    "top_referrers": [...],
    "top_conversions": [...]
}
```

##### `GET`/reports/live

Real-time activity for the last 30 minutes.

**Response**

```
{
    "bots": 12,
    "referrals": 3,
    "avg_crawl_depth": 2.5,
    "pages_crawled": 45,
    "recent_activity": [
        {
            "timestamp": "2026-01-08 14:32:15",
            "bot_name": "GPTBot",
            "channel": "AI Crawler",
            "url": "https://yoursite.com/blog/post-title",
            "is_referral": false
        }
    ]
}
```

##### `GET`/reports/traffic

Daily traffic trends for selected period.

**Parameters**

`days`(integer)— Number of days (1-365). Default: 30

**Response**

```
{
    "daily_data": [
        { "date": "2026-01-08", "bots": 124, "referrals": 34, "total": 158 }
    ],
    "summary": {
        "total_bots": 3542,
        "total_referrals": 892,
        "avg_daily_bots": 118,
        "avg_daily_referrals": 30
    }
}
```

##### `GET`/reports/channels

Traffic breakdown by channel (simplified).

**Parameters**

`days`(integer)— Number of days. Default: 30

**Response**

```
{
    "channels": [
        { "channel": "AI Crawler", "visits": 2340, "percentage": 62.1 },
        { "channel": "AI Referral", "visits": 892, "percentage": 23.7 }
    ],
    "total_visits": 3767
}
```

##### `GET`/reports/channels-detail

Detailed channel breakdown with sub-categories.

**Parameters**

`days`(integer)— Number of days. Default: 30

**Response**

```
{
    "channels": {
        "AI Crawler": {
            "total": 2340,
            "bots": [
                { "name": "GPTBot", "visits": 892, "percentage": 38.1 }
            ]
        }
    }
}
```

##### `GET`/reports/conversions

WooCommerce conversion tracking data (if WooCommerce active).

**Parameters**

`days`(integer)— Number of days. Default: 30

**Response**

```
{
    "funnel": [
        { "step": "product_view", "total": 892, "ai_attributed": 234 },
        { "step": "purchase", "total": 189, "ai_attributed": 52 }
    ],
    "conversion_rate": { "overall": 21.2, "ai_traffic": 22.2 },
    "revenue": { "total": 15678.50, "ai_attributed": 4234.75 }
}
```

##### `GET`/reports/raw

Export raw visitor data (paginated).

**Parameters**

`days`(integer)— Number of days. Default: 30

`limit`(integer)— Results per page (max 1000). Default: 100

`offset`(integer)— Pagination offset. Default: 0

**Response**

```
{
    "total_records": 5432,
    "returned": 100,
    "offset": 0,
    "data": [...]
}
```

##### `DELETE`/reports/raw

Delete visitor data within date range.

**Parameters**

`start_date`(string)required— Start date (YYYY-MM-DD)

`end_date`(string)required— End date (YYYY-MM-DD)

**Response**

```
{
    "deleted_records": 1234,
    "message": "Successfully deleted 1234 records"
}
```

##### `GET`/reports/referrals

AI referral traffic analysis.

**Parameters**

`days`(integer)— Number of days. Default: 30

**Response**

```
{
    "total_referrals": 892,
    "referral_sources": [
        {
            "source": "ChatGPT",
            "domain": "chatgpt.com",
            "visits": 342,
            "percentage": 38.3,
            "top_pages": [...]
        }
    ],
    "growth": { "current_period": 892, "previous_period": 623, "growth_rate": 43.2 }
}
```

##### `GET`/reports/bots

Comprehensive bot activity report.

**Parameters**

`days`(integer)— Number of days. Default: 30

**Response**

```
{
    "total_crawls": 3542,
    "ai_bot_crawls": 2340,
    "seo_bot_crawls": 1202,
    "bots": [...],
    "daily_trend": [...],
    "hourly": [...],
    "top_pages": [...],
    "status_codes": [...]
}
```

##### `GET`/privacy/export

GDPR-compliant data export for user.

**Parameters**

`email`(string)required— User email address

**Response**

```
{
    "user_email": "user@example.com",
    "records_found": 45,
    "data": [...]
}
```

##### `DELETE`/privacy/delete

GDPR-compliant data deletion for user.

**Parameters**

`email`(string)required— User email address

**Response**

```
{
    "deleted_records": 45,
    "message": "All data for user@example.com has been permanently deleted"
}
```