. For 100% AI detection accuracy, also configure the managed proxy by pointing your domain's A record to 37.16.7.18."}}]}]}
Documentation

AI Visitor Verification

100% accurate AI detection using RFC 9421 signatures

Why verify AI visitors?

When users copy a link from ChatGPT, Claude, or Perplexity and paste it into their browser, that traffic appears as "direct" in every analytics tool. No referrer, no UTM parameters, nothing.

The basic Loamly tracker uses behavioral signals and timing analysis to detect this traffic with ~75% accuracy. But if you want 100% certainty, you need RFC 9421 signature verification.

This works by routing traffic through Loamly's edge, where we:

  1. Check for cryptographic signatures that AI agents include
  2. Verify signatures using Ed25519 public keys
  3. Forward the request to your origin server
  4. Tag the visit with verified AI attribution

What's RFC 9421?

RFC 9421 is an HTTP standard for message signatures. AI agents like GPTBot and ClaudeBot sign their requests so publishers can verify authenticity. Most sites ignore these signatures. Loamly reads them.

Setup methods

Choose the method that works best for your setup:

MethodBest forMaintenance
DNS (A record)EveryoneZero
Cloudflare workerAlready on CloudflareMinimal
CLIDevelopers who want controlYou manage it

DNS (recommended)

Point your domain to Loamly's edge. We handle SSL, verification, and forwarding. Zero maintenance.

Step 1: Add an A record

In your DNS provider, add:

TypeNameValue
A@37.16.7.18

Cloudflare DNS users

If you use Cloudflare for DNS, turn OFF the proxy (orange cloud → gray). The orange cloud would route traffic through Cloudflare instead of Loamly.

Step 2: Tell Loamly your origin URL

When traffic hits Loamly, we need to know where to forward it. Enter your origin URL in the installation page. This is your hosting provider's domain before you added your custom domain.

Step 3: Verify DNS propagation

Click "Save & Verify" in the installation page. DNS changes typically propagate in 5-30 minutes, but can take up to 48 hours depending on your DNS provider.

Once verified, SSL is automatically provisioned via Let's Encrypt. First request may take a few seconds while the certificate is issued.

Cloudflare worker

If you're already on Cloudflare, deploy our verification worker to your account. This runs on Cloudflare's edge, not Loamly's.

  1. Create a Cloudflare API token with permissions: Workers Scripts: Edit and Workers Routes: Edit
  2. Paste the token in the installation page
  3. Click Deploy

The worker intercepts requests to your domain, checks for AI signatures, sends verification data to Loamly, and forwards the request to your origin.

CLI deployment

For developers who prefer command-line deployment:

git clone https://github.com/loamly/rfc9421-verifier.git
cd rfc9421-verifier

# Set your credentials
npx wrangler secret put LOAMLY_WORKSPACE_ID
npx wrangler secret put LOAMLY_WORKSPACE_API_KEY

# Deploy
npx wrangler deploy

You can find your workspace ID and API key in the installation page.

Finding your origin URL

Your origin URL is the domain your hosting provider gave you before you set up a custom domain. It's where your site actually lives.

Hosting providerOrigin URL format
Vercelyour-project.vercel.app
Netlifyyour-site.netlify.app
Squarespaceyour-site.squarespace.com
Webflowyour-site.webflow.io
Cloudflare Pagesyour-site.pages.dev
Shopifyyour-store.myshopify.com
Wixusername.wixsite.com/site-name
Railwayyour-app.up.railway.app
Renderyour-app.onrender.com
Fly.ioyour-app.fly.dev

Not sure?

Check your hosting provider's dashboard. The original domain is usually shown in the project settings or domain configuration section.

Verifying it works

Check DNS propagation

Use a DNS lookup tool to verify your A record:

dig yourdomain.com A

# Should show:
# yourdomain.com.   300   IN   A   37.16.7.18

Check SSL

Visit your domain in a browser. You should see a valid SSL certificate issued by Let's Encrypt. The first request may take a few seconds while the certificate is provisioned.

Check verification in dashboard

In your Loamly dashboard, AI-verified visits show a shield icon and "RFC 9421 Verified" tag in the attribution details. These are 100% confirmed AI visitors—no probabilistic guessing.

Mixed results are normal

You'll still see some AI visits detected via behavioral analysis (without the shield). This happens when the AI agent didn't include a signature, or when users paste links that the AI recommended but didn't directly generate. Both detection methods work together.