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": "[email protected]",
"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 [email protected] has been permanently deleted"
}