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

# Measure usage

> See which AI apps cite and play your videos, what people ask on your site, and which AI crawlers fetch your pages.

Every use of your videos through AgentTV is logged against your account: citations, plays, Ask answers and key reads. Four reports read those logs.

## AI app usage

Which AI apps cited or played your videos in a date range, and how often.

```bash theme={null}
curl -s "https://api.agentcdn.com/v1/reports/agent-usage?from=2026-10-01&to=2026-10-28" \
  -H "Authorization: Bearer $AGENTCDN_API_KEY"
```

The default range is the last 30 days. The account MCP tool `get_agent_usage` returns the same.

## Usage receipts

An AI app that shows, quotes, cites or plays a moment can report it with the `record_usage` MCP tool, or with `POST /public/creators/{slug}/usage`. It gets back a signed receipt. Check a receipt against the public keys at `https://api.agentcdn.com/.well-known/jwks.json`. Receipts let you audit what an app says it did with each moment.

## Ask on your site

* **Questions.** Every question people ask your Ask box or your library, grouped, with no-answer questions marked. In the console under **Questions**, or `GET /v1/questions`.
* **Ask report.** Totals for a date range: asks, answered, no answer, plays, moments reached, and the top questions, moments, videos and topics. `GET /v1/reports/ask`.

The Ask box measures each play in its player: the play, whether the cited moment was reached, and how much of it was watched. It sets no cookies and loads no third-party trackers.

## AI crawler visits

Send your CDN logs to see which AI crawlers fetch your video pages. AgentTV keeps only AI crawler hits on your own sites, checks each crawler against its published IP ranges or reverse DNS, drops the IP, and adds the hit to daily counts. Unverified hits are counted apart.

**1. Create a log source**

In the console, open **Visibility**, then the **AI crawler visits** card, then **Set up the log feed**. Pick your CDN and your site hosts. You get an intake URL and a secret. The secret shows once.

**2. Point your CDN at it**

Supported: Vercel log drains, Cloudflare Logpush, Akamai DataStream 2 (JSON), Fastly HTTPS logging and Amazon CloudFront real-time logs through Firehose. The console gives the exact fields and settings for each.

**3. Read the counts**

The card shows one site at a time, never summed across sites. The Visibility report adds a "From crawl to citation" view: per crawler operator, its verified requests to your site and the video pages it fetched.

You can only add hosts you have proven you own: by the DNS or TLS check, or by a Search Console property that covers the host. A fetched page is never called indexed: no one can see inside an AI app's index.

## Events to your systems

To act on changes as they happen, use [webhooks](https://docs.agentcdn.com/guides/webhooks.md).


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