> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usequotable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Analytics FAQ

> Short answers about what Agent Analytics collects, how it affects your site, how verification and quotas work, and how it relates to citations and AI Referrals.

> [accordion] Do I need to add a script to my website?
>
> No. Agent Analytics reads the request logs your CDN, host or server already produces. There's no JavaScript tag, and AI crawlers rarely run JavaScript, so a tag would miss them anyway.

> [accordion] Can Agent Analytics slow down or break my site?
>
> Log-based connectors (Logpush, Vercel, CloudFront, Google Cloud CDN, Fastly, Akamai, Netlify) run entirely outside your request path. The Cloudflare Worker runs on your route but is fail-open: it reports after the response is sent, never reads the response body, and stops reporting during an outage instead of waiting.

> [accordion] Do you store my visitors' IP addresses?
>
> No. The client IP is used in memory to verify the agent and then discarded. User agents, query strings, cookies, headers and full referrer URLs aren't stored either. Only AI agent requests are kept; human traffic is dropped on arrival. See [Privacy by design](https://docs.usequotable.com/agent-analytics/overview.md#privacy-by-design).

> [accordion] Why send all my logs if only AI agents are kept?
>
> You don't have to. Filtering to AI agents at the source saves bandwidth, and some connectors (Google Cloud CDN, the Cloudflare Worker) do it for you. Sending everything is also fine: human traffic doesn't count toward your quota.

> [accordion] Which AI agents do you recognize?
>
> 49 agents from 22 providers: OpenAI (GPTBot, OAI-SearchBot, ChatGPT-User, OAI-AdsBot), Anthropic (ClaudeBot, Claude-SearchBot, Claude-User, Claude-Agent), Perplexity (PerplexityBot, Perplexity-User), Google (Googlebot, Googlebot-Image, Googlebot-Video, Storebot-Google, GoogleOther, Google-CloudVertexBot, Google-GeminiNotebook, Google-Agent), Microsoft (Bingbot, AdIdxBot, MicrosoftPreview), Apple (Applebot, Applebot-Extended), Amazon (Amazonbot, Amzn-SearchBot, Amzn-User), Meta (meta-externalagent, Meta-ExternalFetcher, Meta-WebIndexer), Mistral (MistralAI-User, MistralAI-Index, MistralAI-Training), DuckDuckGo (DuckAssistBot, DuckDuckBot), You.com (YouBot), Kagi (Kagibot), Exa (ExaSearchBot, ExaUser), Diffbot (Diffbot, Diffbot-User), Common Crawl (CCBot), Allen Institute for AI (AI2Bot), Yahoo (Slurp), Yandex (YandexBot, YandexAdditional), Baidu (Baiduspider), Huawei (PetalBot), ByteDance (Bytespider) and Cohere (cohere-ai). Each one rests on its operator's own documentation. See the [full table](https://docs.usequotable.com/agent-analytics/overview.md#recognized-ai-agents).

> [accordion] What's the difference between unverified and spoofed?
>
> Unverified means there wasn't decisive evidence: no client IP in the log, no published ranges for that provider, or DNS didn't answer. Spoofed means the evidence contradicts the claim: the IP is outside every range the provider publishes. See [How verification works](https://docs.usequotable.com/agent-analytics/how-verification-works.md).

> [accordion] Does a crawl mean my page will be cited?
>
> No. A crawler request shows that an AI system read your page. Citations are measured separately by your prompt tracking, and human click-throughs by [AI Referrals](https://docs.usequotable.com/agent-analytics/ai-referrals.md). The Pages tab links the three for each page, but they don't share a denominator.

> [accordion] Can I import historical logs?
>
> Only the last seven days. Older records are dropped as `timestamp_out_of_range`. Use [Log file import](https://docs.usequotable.com/agent-analytics/connectors/log-file-import.md) for a short backfill, then keep a live connector running.

> [accordion] Can I connect several sources to one brand?
>
> Yes. Connect one source per domain and per platform, for example a CDN for `example.com` and another for `docs.example.com`. Each source has its own token, endpoint and daily quota, and the dashboard can filter by source. A brand can have one source per connector type and domain.

> [accordion] Do subdomains count?
>
> Yes. A source created for `example.com` accepts `example.com` and every subdomain of it, such as `www.example.com` or `docs.example.com`. Other domains are dropped as `host_mismatch`.

> [accordion] What happens when a source reaches its daily quota?
>
> Records that fit are stored, and the rest are dropped as `quota_exceeded` until midnight UTC. A delivery with no room gets `429` with a `Retry-After` header. At 80% of the quota the source shows a warning, and an alert is raised. See [Quotas](https://docs.usequotable.com/agent-analytics/getting-started.md#quotas).

> [accordion] I lost the token. Can I see it again?
>
> No. For security, the token is shown only once. Rotate it from **Connected sources** (or from the setup wizard) to get a new one, then update your platform. The old token stops working immediately.

> [accordion] Is there a WordPress plugin or a Shopify app?
>
> No published plugin or app is available. If your WordPress or Shopify site sits behind a CDN such as Cloudflare, connect the CDN. Otherwise, use [Custom HTTP](https://docs.usequotable.com/agent-analytics/connectors/custom-http.md) from your own log pipeline.

> [accordion] Who can connect or disconnect sources?
>
> Owners, integration admins, and editors or billing admins with access to the brand. Viewers can see the dashboard but can't manage sources. See [Team and roles](https://docs.usequotable.com/workspace/team-and-roles.md).

> [accordion] Does disconnecting a source delete its data?
>
> No. Disconnecting refuses further deliveries. Events already accepted stay in your reports until they age out.
>
> A disconnected source can't be reopened, but you can connect the same connector for the same domain again: it becomes a new source with a new endpoint and token, and the old one stays listed as disconnected. If you only need new credentials, rotate the token instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.