Documentation

Comprehensive documentation for Spyglasses - the AI agent detection and analytics platform for your website.

Spyglasses is an AI-powered platform that helps you identify, analyze, and understand the AI agents visiting your website. By detecting and categorizing AI traffic, Spyglasses provides valuable insights into how AI agents interact with your content, helping you optimize your site for both human and AI audiences.

What is Spyglasses?

Spyglasses is a specialized analytics platform that:

Detects AI Agents: Identifies when AI crawlers, chatbots, or other AI systems visit your website
Categorizes Traffic: Classifies AI agents by type, company, and intent
Provides Analytics: Offers detailed insights about AI traffic patterns and behaviors
Integrates Seamlessly: Works with popular platforms like Next.js and WordPress
Connects to Analytics: Sends data to Google Analytics for unified reporting

How Spyglasses Works

Spyglasses uses advanced detection algorithms to identify AI agents based on their behavior, headers, and other characteristics. Once detected, these agents are categorized and analyzed, providing you with actionable insights about your AI traffic.

The platform operates through a simple integration process:

Add Spyglasses to your site using our platform-specific integrations
Configure your API key to connect your site to your Spyglasses account
Verify your setup to ensure data is being collected correctly
View analytics in your Spyglasses dashboard
Send human-initiated traffic to your main analytics platform (Google Analytics, Posthog, and more)

Getting Started

To begin using Spyglasses, follow these steps:

Create a Spyglasses account if you don't have one already
Add a new property to track your website
Choose your platform and follow the integration instructions for your specific setup
Verify your installation and start collecting data