Loamly Documentation
Open-source AI traffic detection for websites.
The problem
When someone copies a URL from ChatGPT, Claude, or Perplexity and pastes it into their browser:
- No referrer header (browser security blocks it)
- No UTM parameters (AI doesn't add them)
- Google Analytics shows "Direct Traffic"
This traffic is invisible. For many sites, it's 15-30% of visitors.
How it works
Loamly detects AI-referred traffic using multiple signals. Combined accuracy is approximately 90%.
- Navigation Timing API — Paste vs click detection (65-78% accuracy)
- Sec-Fetch Headers — Browser header analysis (62-74%)
- Behavioral ML — Mouse/scroll patterns (75-90%)
- Focus/Blur Analysis — Tab switching patterns (55-65%)
- Temporal Matching — Bot crawl correlation (70-85%)
- Referrer Detection — When AI platforms send referrers (95%+)
Quick start
Getting started
Add the tracker to your website:
<script defer data-domain="your-site.com" src="https://app.loamly.ai/t.js"></script>That's it. Visit your dashboard to see traffic data within minutes.
Core features
Analytics
Real-time visitor tracking with traffic source detection and engagement scoring. Learn more →
Intelligence
Monitor what AI platforms say about your brand. Track competitive positioning. Learn more →
Attribution
Connect traffic sources to revenue. See visitor timelines and form submissions. Learn more →
Integrations
API
Questions? Email support@loamly.ai