AI Traffic

​

What is captured

• AI crawler: bots fetching your pages to train models or build a search index. Each crawler carries a Purpose: Model training (collects pages for training corpora), Search index (builds the index an AI answer engine searches), or Cited in answer (fetched while an assistant was answering someone).
• AI referral: a person who clicked through to your site from an AI answer. Detection is based on the referrer host, for example chatgpt.com, perplexity.ai, gemini.google.com, claude.ai, copilot.microsoft.com, you.com, chat.deepseek.com, chat.mistral.ai, grok.com, and chat.qwen.ai.

​

Journeys

• Tagged journey: the agent followed a link carrying an ntr query parameter that your site minted. This is exact.
• Fingerprinted journey: requests were matched by a heuristic: the source, a truncated IP prefix, and a 30 minute time bucket (10 minutes and the full IP for assistant browsing), hashed with a salt that rotates daily. This is an estimate.

​

Set up the tracker

curl https://api.usenotra.com/v1/geo/ingest/setup \
  -H "Authorization: Bearer $NOTRA_API_KEY"

curl -X POST "https://api.usenotra.com/v1/geo/ingest/token?projectId=$PROJECT_ID" \
  -H "Authorization: Bearer $NOTRA_API_KEY"

bun add @usenotra/geo

import { createGeoProxy } from "@usenotra/geo/next";
import { after, NextResponse } from "next/server";

const geo = createGeoProxy({
  token: process.env.NOTRA_GEO_TOKEN!,
  endpoint: "https://app.usenotra.com",
});

export function proxy(request: Request) {
  after(() => geo(request));
  return NextResponse.next();
}

import { createGeoHandler } from "@usenotra/geo/nuxt";

const geo = createGeoHandler({
  token: process.env.NOTRA_GEO_TOKEN!,
  endpoint: "https://app.usenotra.com",
});

export default defineEventHandler(async (event) => {
  await geo(event);
});

import { createMiddleware, createStart } from "@tanstack/react-start";
import { createGeoMiddleware } from "@usenotra/geo/tanstack";

const geo = createMiddleware().server(createGeoMiddleware({
  token: process.env.NOTRA_GEO_TOKEN!,
  endpoint: "https://app.usenotra.com",
}));

export const startInstance = createStart(() => ({
  requestMiddleware: [geo],
}));

import { createGeoMiddleware } from "@usenotra/geo/astro";

export const onRequest = createGeoMiddleware({
  token: import.meta.env.NOTRA_GEO_TOKEN!,
  endpoint: "https://app.usenotra.com",
});

import { env } from "$env/dynamic/private";
import { createGeoHandle } from "@usenotra/geo/sveltekit";

export const handle = createGeoHandle({
  token: env.NOTRA_GEO_TOKEN!,
  endpoint: "https://app.usenotra.com",
});

import { createGeoHandler } from "@usenotra/geo/netlify";
import type { Context } from "@netlify/edge-functions";

const geo = createGeoHandler({
  token: Deno.env.get("NOTRA_GEO_TOKEN")!,
  endpoint: "https://app.usenotra.com",
});

export default (request: Request, context: Context) => {
  geo(request, context);
};

export const config = { path: "/*" };

​

Tracker options

​

Journey tagging

​

Rotating the token

curl -X POST "https://api.usenotra.com/v1/geo/ingest/rotate-token?projectId=$PROJECT_ID" \
  -H "Authorization: Bearer $NOTRA_API_KEY"

​

The Traffic page

• A hero row with Crawlers, Referrals, and Total visit counts, each compared “vs. previous period”, and a daily trend chart.
• Sources: three groups — Crawlers (training and search-index bots), Cited (assistant-browse fetches while an engine answered someone), and Referrals. Columns are Source, Purpose, Visits, Markdown (visits that asked for Markdown; crawlers and cited only), Pages, and Last seen. Sources group by operator, for example OpenAI, Anthropic, Google, Perplexity, Microsoft, Meta, Instagram, Amazon, Apple, ByteDance, and Common Crawl. Instagram is its own source, not folded into Meta.
• Top pages by AI source: Page (host and path), Sources, and Visits. When a project tracks more than one domain, a domain filter narrows the table.
• Recent citations: the live event log with All visitors (AI crawler, AI referral) and All purposes (Model training, Search index, Cited in answer) filters. The domain filter on top pages also narrows this log. Live updates refresh every few seconds and can be paused.

​

Reading traffic from the API

const response = await fetch(
  `https://api.usenotra.com/v1/projects/${projectId}/geo/traffic/log?limit=50&visitorTypes=crawler&categories=assistant-browse`,
  { headers: { Authorization: `Bearer ${process.env.NOTRA_API_KEY}` } }
);
const { log } = await response.json();

​

Limits to keep in mind